تهيئة الوصول إلى واجهة برمجة تطبيقات Google Cloud Search

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

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

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

1. افتح Google Cloud Console.

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة: تتطلب واجهات برمجة تطبيقات Cloud Search المختلفة حسابات مختلفة لتنفيذها (المشرف والخدمة والمستخدم). لمزيد من المعلومات، يمكنك الرجوع إلى المستندات المرجعية لمعرفة الطريقة التي تريد الاتصال بها.

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

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

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

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

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

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

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

ملاحظة: في حال تنفيذ البرنامج التعليمي على Cloud Search بنجاح، يكون قد سبق لك إعداد دعم الجهات الخارجية لخدمة 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، استخدِم الأمر curl التالي. تأكّد من استبدال [YOUR_ACCESS_TOKEN] بالرمز المميّز الذي تم الحصول عليه في الخطوة 2.

   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 للبيانات في المستودع.