دليل البدء باستخدام Google Cloud Search

يوضح هذا البرنامج التعليمي كيفية نشر حل بسيط من Cloud Search واستخدام GitHub كمستودع للبيانات المطلوب فهرستها. على وجه التحديد، يتكون هذا البرنامج التعليمي من نموذجين للتطبيق:

  • موصِّل محتوى تم إنشاؤه باستخدام Cloud Search Connector SDK ويُستخدَم لفهرسة البيانات المتوفّرة في مستودعات GitHub. تتضمن البيانات المفهرسة المشكلات وطلبات السحب ومحتوى العنوان للفرع الافتراضي (master).
  • تطبيق ويب يستخدم أداة "بحث Google" لتوفير واجهة بحث مخصّصة.

المتطلبات الأساسية

يتطلب هذا البرنامج التعليمي المتطلبات الأساسية التالية:

  • وصول المشرف إلى نطاق Google Workspace أو Cloud Identity مع تفعيل Cloud Search لفهرسة بيانات الجهات الخارجية إذا لم تتمكن من عرض الإعدادات في لوحة تحكم المشرف، يمكنك إما التواصل مع مشرف النطاق أو الاشتراك في Cloud Search.
  • حساب مستخدم على GitHub.
  • معرفة لغة Java وJavaScript
  • Java 8 أو إصدار أحدث.
  • Maven:
  • Node.js 8.11 أو إصدار أحدث.

إنشاء مشروع البرنامج التعليمي

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

  1. افتح Google Cloud Console.

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

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

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

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

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

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

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

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

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

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

  1. في شريط التنقل الأيمن، انقر على APIs & Services (واجهات برمجة التطبيقات والخدمات).
  2. للتأكّد من أنّك أنت في المشروع الذي تم إنشاؤه حديثًا، انقر على رمز على يسار بانر بانر Google Cloud Console واختَر المشروع الذي تم إنشاؤه حديثًا.
  3. انقر على تفعيل واجهات برمجة التطبيقات والخدمات. تظهر صفحة "مرحبًا بك في مكتبة واجهة برمجة التطبيقات".
  4. اكتب "Cloud Search API" في حقل البحث واضغط على return. يتم عرض قائمة بواجهات برمجة التطبيقات.
  5. انقر على Cloud Search API. ستظهر صفحة "Cloud Search API".
  6. انقر على تفعيل. ستظهر لك صفحة "نظرة عامة".

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

استنساخ مستودع البرامج التعليمية

لاستنساخ نموذج المستودع، شغِّل الأمر التالي:

git clone https://github.com/googleworkspace/cloud-search-samples.git

التالي