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

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

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

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

  1. افتح Google Cloud Console.

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

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

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

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

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

  7. انقر على موقع جغرافي لمشروعك ثم انقر على اختيار.

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

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

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

عليك تفعيل واجهة برمجة التطبيقات Google 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. انقر على إغلاق (Close).

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

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

  1. من Google Cloud Console، اختَر المشروع الذي أنشأته في أعلى الصفحة.
  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. انقر على إغلاق (Close).
    4. في حقل النطاقات، اكتب https://www.googleapis.com/auth/cloud_search.settings وانقر على تفويض. تعرض ساحة بروتوكول OAuth 2 رمز تفويض.
    5. انقر على Exchange authorization code for tokens (تبديل رمز التفويض بالرموز المميّزة). يتم عرض رمز مميّز.

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