ضبط إمكانية الوصول إلى Google Cloud Search API

يجب ضبط إمكانية الوصول إلى واجهة برمجة تطبيقات Google Cloud Search قبل أن تتمكّن من إجراء ذلك. تستخدم واجهة برمجة التطبيقات هذه إما مباشرةً أو من خلال حزمة SDK. هذا المستند تتناول الخطوات المطلوبة لاستخدام واجهة برمجة تطبيقات REST API في Google Cloud Search.

1. إنشاء مشروع واجهة برمجة التطبيقات

لتفعيل واجهة برمجة التطبيقات، يجب أولاً إنشاء مشروع على Google Cloud. هذا النمط يشكّل الأساس لإنشاء جميع خدمات Google Cloud وتفعيلها واستخدامها بما في ذلك إدارة واجهات برمجة التطبيقات، وتمكين الفوترة، وإضافة وإزالة المتعاونين وإدارة الأذونات.

  1. افتح وحدة تحكُّم Google Cloud.

  2. في أعلى الصفحة، انقر على على يسار "Google Cloud Console". مربّع حوار يسرد المشاريع الحالية تظهر.

  3. انقر على مشروع جديد. "المشروع الجديد" تظهر الشاشة.

  4. أدخِل اسم مشروع في حقل اسم المشروع.

  5. (اختياري) انقر على تعديل لتعديل رقم تعريف المشروع. لا يمكن استخدام رقم تعريف المشروع بعد إنشاء المشروع، لذا اختر رقم التعريف الذي يلبي احتياجاتك طوال فترة المشروع.

  6. لتصفّح المواقع الجغرافية للمشروع، انقر على تصفُّح.

  7. انقر على موقع لمشروعك وانقر على اختيار.

  8. انقر على إنشاء. تنتقل وحدة التحكم إلى صفحة لوحة البيانات. المشروع يتم إنشاؤه في غضون بضع دقائق.

لمزيد من المعلومات حول إنشاء وإدارة المشروعات، راجع إنشاء المشاريع وإدارتها:

2. تفعيل واجهة برمجة التطبيقات

يجب تفعيل Google Cloud Search API وإنشاء حساب خدمة من أجل الحصول على بيانات الاعتماد.

  1. للتأكد من أنك في المشروع الذي تم إنشاؤه حديثًا، انقر على الرمز "" إلى يسار بانر Google Cloud Console واختيار المشروع الذي تم إنشاؤه حديثًا
  2. انقر على تفعيل واجهات برمجة التطبيقات والخدمات (ENABLE APIS AND SERVICES). صفحة "مرحبًا بك في مكتبة واجهة برمجة التطبيقات" صفحة تظهر.
  3. انتقِل إلى Google Cloud Search API.
  4. انقر على تفعيل. "نظرة عامة" صفحة تسجيل الدخول.

لمزيد من المعلومات حول تفعيل واجهات برمجة التطبيقات وإيقافها، راجع إدارة واجهات برمجة التطبيقات في وحدة تحكّم Google Cloud

3- إنشاء بيانات اعتماد لحساب الخدمة

  1. في وحدة تحكُّم Google Cloud، انقر على بيانات الاعتماد في شريط التنقّل الأيمن. ستظهر صفحة "بيانات الاعتماد".
  2. من القائمة المنسدلة إنشاء بيانات اعتماد، اختَر حساب الخدمة: تشير رسالة الأشكال البيانية "إنشاء حساب خدمة" صفحة تسجيل الدخول.
  3. أدخِل اسمًا في حقل اسم حساب الخدمة.
  4. (اختياري) عدِّل رقم تعريف حساب الخدمة.
  5. انقر على إنشاء. "أذونات حساب الخدمة" تظهر الشاشة.
  6. انقر على متابعة. رسالة "منح المستخدمين إذن الوصول إلى حساب الخدمة هذا" الشاشة تظهر.
  7. انقر على إنشاء مفتاح وانقر على تم. "تم حفظ المفتاح الخاص في كمبيوتر" مرة أخرى ونسخة من تنزيلات المفتاح الخاص إلى الكمبيوتر.
  8. انقر على إغلاق.

لمزيد من المعلومات حول حسابات الخدمة، راجع حسابات الخدمة وتطبيقات الويب والتطبيقات المثبّتة

4. تحديد عنوان البريد الإلكتروني

  1. من وحدة تحكُّم Google Cloud: اختَر المشروع الذي أنشأته في أعلى الصفحة.
  2. انقر على قائمة التنقّل على يمين بانر وحدة تحكّم Google Cloud.
  3. انقر على إدارة الهوية وإمكانية الوصول والمشرف > حسابات الخدمة:
  4. في القائمة، ضمن "رقم تعريف حساب الخدمة"، تدوين البريد الإلكتروني الذي تم إنشاؤه الذي يُحدِّد حساب الخدمة الذي ضبطته. عنوان البريد الإلكتروني هذا يتم استخدامها عند إضافة مصدر بيانات إلى Cloud Search.

5- تهيئة دعم الجهات الخارجية

قبل أن تتمكن من طلب أي واجهات برمجة تطبيقات أخرى في Cloud Search، عليك إعداد جهات خارجية. على Google Cloud Search

لإعداد دعم الجهات الخارجية في Cloud Search:

  1. يحتوي مشروع منصة Cloud Search على بيانات اعتماد حساب الخدمة. ومع ذلك، فمن أجل تهيئة دعم الجهات الخارجية، يجب إنشاء صفحات ويب بيانات اعتماد التطبيق. للحصول على إرشادات حول كيفية إنشاء تطبيق ويب بيانات الاعتماد، راجع إنشاء بيانات الاعتماد بعد الانتهاء من هذه الخطوة، ينبغي أن يكون لديك معرف عميل وملف سر العميل.

  2. استخدام نموذج OAuth 2 التجريبي من Google للحصول على رمز الدخول:

    1. انقر على الإعدادات وضع علامة في المربّع استخدِم بيانات اعتماد المصادقة الخاصة بك.
    2. أدخِل معرِّف العميل وسر العميل من الخطوة 1.
    3. انقر على إغلاق.
    4. في حقل "النطاقات"، اكتب https://www.googleapis.com/auth/cloud_search.settings. وانقر على تفويض. تعرض واجهة OAuth 2 رمز تفويض.
    5. انقر على رمز تفويض Exchange للرموز المميّزة. يتم إرجاع رمز مميّز.
  3. لإعداد دعم الجهات الخارجية في Cloud Search، يمكنك استخدام الحلقة التالية الأمر. تأكَّد من استبدال [YOUR_ACCESS_TOKEN] بالرمز المميّز الذي تم الحصول عليه في الخطوة الثانية:

    curl --request POST \
    'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
      --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
      --header 'Accept: application/json' \
      --header 'Content-Type: application/json' \
      --data '{}' \
      --compressed
    

    إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل operation بالنسبة مثال:

    {
    name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
    }
    

    في حال تعذَّر ذلك، يمكنك التواصل مع فريق دعم Cloud Search.

  4. استخدِم operations.get للتأكّد من تم إعداد دعم الجهة الخارجية:

    curl \
    'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
    [YOUR_API_KEY]' \
    --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
    --header 'Accept: application/json' \
    --compressed
    

    وعند اكتمال تهيئة الجهة الخارجية، تحتوي على تم ضبط الحقل done على true. على سبيل المثال:

    {
    name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
    done: true
    }
    

الخطوات التالية

في ما يلي بعض الخطوات التي يمكنك اتّخاذها:

  1. إذا كنت تخطط لاستخدام Google Cloud Search مع مستودع بيانات غير تابع لـ Google، مثل Microsoft® SharePoint® ، ويمكنك إنشاء مصدر بيانات. للحصول على تعليمات حول إضافة مصدر بيانات، راجع إضافة مصدر بيانات إلى البحث

  2. بعد إعداد مصدر بياناتك، يمكنك إنشاء المخطط وتسجيله لتحديد كيفية تمثيل Google Cloud Search للبيانات في المستودع.