ضبط إمكانية الوصول إلى 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".
2. انقر على تفعيل واجهات برمجة التطبيقات والخدمات.
3. ابحث عن Google Cloud Search API واختَرها.
4. انقر على تفعيل.

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

ملاحظة: تتطلّب طرق Cloud Search API المختلفة أنواعًا مختلفة من الحسابات (مشرف أو خدمة أو مستخدم). لمزيد من التفاصيل، يُرجى الاطّلاع على المستندات المرجعية.

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.

ملاحظة: إذا أكملت البرنامج التعليمي الخاص بخدمة 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 بياناتك.