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

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

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء المشاريع وإدارتها.

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

فعِّل Cloud Search API وأنشئ حساب خدمة للحصول على بيانات الاعتماد.

  1. اختَر مشروعك الجديد من القائمة المنسدلة في بانر Google Cloud Console.
  2. انقر على تفعيل واجهات برمجة التطبيقات والخدمات.
  3. ابحث عن Google Cloud Search API واختَرها.
  4. انقر على تفعيل.

لمزيد من المعلومات، يُرجى الاطّلاع على إدارة واجهات برمجة التطبيقات في Google Cloud Console.

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

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

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

4- تحديد عنوان البريد الإلكتروني لحساب الخدمة

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

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

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

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

  1. أنشئ بيانات اعتماد لتطبيق ويب في مشروع منصة Cloud Search. يُرجى الاطّلاع على إنشاء بيانات اعتماد. تحتاج إلى معرّف العميل وسر العميل.
  2. احصل على رمز دخول باستخدام الـ OAuth 2.0 Playground:
    1. انقر على إعدادات OAuth 2.0 (رمز الإعدادات) وضَع علامة في المربّع استخدام بيانات اعتماد OAuth الخاصة بك.
    2. أدخِل معرّف العميل وسر العميل.
    3. في حقل النطاقات، أدخِل https://www.googleapis.com/auth/cloud_search.settings وانقر على تفويض واجهات برمجة التطبيقات.
    4. انقر على تبديل رمز التفويض بالرموز المميّزة.

  3. شغِّل أمر curl التالي، مع استبدال [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. إذا تعذّر ذلك، يُرجى التواصل مع فريق دعم Cloud Search.

  4. استخدِم operations.get للتحقّق من الإعداد:

    curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    يكتمل الإعداد عندما تكون قيمة done هي true.

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

  1. لاستخدام Cloud Search مع مستودع غير تابع لشركة Google، مثل Microsoft® SharePoint®، يجب إنشاء مصدر بيانات. يُرجى الاطّلاع على إضافة مصدر بيانات إلى البحث.
  2. بعد إعداد مصدر البيانات، أنشئ مخططًا وسجِّله. لتحديد كيفية تمثيل Cloud Search لبياناتك. كيفية تمثيل Cloud Search للبيانات