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

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

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

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

  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

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

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

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

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

  1. من وحدة التحكم في Google Cloud، اختَر المشروع الذي أنشأته في أعلى الصفحة.
  2. انقر على قائمة التنقّل على يمين بانر Google Cloud Console.
  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، استخدم أمر 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 البيانات المتوفّرة في المستودع.