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

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

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

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

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

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

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

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

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

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

لبدء دعم الجهات الخارجية، اتّبِع الخطوات التالية:

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

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 بياناتك.