يوضح هذا البرنامج التعليمي كيفية نشر حل بسيط في Cloud Search ويستخدم GitHub كمستودع للبيانات المطلوب فهرستها. على وجه التحديد، يتكون هذا البرنامج التعليمي من نموذجين للتطبيق:
- هو موصِّل محتوى تم إنشاؤه باستخدام حزمة SDK لموصِّل Cloud Search ويُستخدَم لفهرسة البيانات المتوفّرة في مستودعات GitHub. تتضمن البيانات المفهرسة المشاكل وطلبات السحب
والمحتوى الرئيسي للفرع التلقائي (
master). - هو تطبيق ويب يستخدم أداة البحث لتقديم واجهة بحث مخصّصة.
المتطلبات الأساسية
يتطلّب هذا الدليل التوجيهي المتطلّبات الأساسية التالية:
- إذن وصول المشرف إلى نطاق 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) وتفعيلها واستخدامها، بما في ذلك إدارة واجهات برمجة التطبيقات وتفعيل الفوترة وإضافة المتعاونين وإزالتهم وإدارة الأذونات.
افتح Google Cloud Console.
في أعلى الصفحة، انقر على إلى يسار "Google Cloud Console". يظهر مربع حوار يسرد المشروعات الحالية.
انقر على مشروع جديد. ستظهر شاشة مشروع جديد.
في حقل اسم المشروع، أدخِل اسم المشروع، مثل "Searchtutorial".
(اختياري) انقر على تعديل لتعديل رقم تعريف المشروع. لا يمكن تغيير رقم تعريف المشروع بعد إنشاء المشروع، لذا اختَر معرّفًا يلبي احتياجاتك طوال مدة المشروع.
لتصفّح المواقع الجغرافية للمشروع، انقر على تصفُّح.
انقر على موقع لمشروعك وانقر على اختيار.
انقر على إنشاء. تنتقل وحدة التحكّم إلى صفحة "لوحة البيانات". يتم إنشاء المشروع في غضون بضع دقائق.
لمزيد من المعلومات حول إنشاء المشاريع وإدارتها، يُرجى الرجوع إلى إنشاء المشاريع وإدارتها.
تفعيل واجهة برمجة التطبيقات
عليك تفعيل واجهة برمجة تطبيقات Google Cloud Search وإنشاء حساب خدمة للحصول على بيانات الاعتماد.
- في شريط التنقّل الأيمن، انقر على واجهات برمجة التطبيقات والخدمات.
- لضمان أنّك في المشروع الذي تم إنشاؤه حديثًا، انقر على الرمز على يسار بانر Google Cloud Console واختَر المشروع الذي تم إنشاؤه حديثًا.
- انقر على تفعيل واجهات برمجة التطبيقات والخدمات. تظهر صفحة "مرحبًا بك في مكتبة واجهة برمجة التطبيقات".
- اكتب "Cloud Search API" في حقل البحث، ثم اضغط على return. يتم عرض قائمة بواجهات برمجة التطبيقات.
- انقر على Cloud Search API. ستظهر صفحة "Cloud Search API".
- انقر على تفعيل. تظهر صفحة نظرة عامة.
لمزيد من المعلومات حول تفعيل واجهات برمجة التطبيقات وإيقافها، يُرجى الاطّلاع على مقالة إدارة واجهات برمجة التطبيقات في Google Cloud Console
استنساخ مستودع البرامج التعليمية
لاستنساخ مستودع النماذج، شغِّل الأمر التالي:
git clone https://github.com/googleworkspace/cloud-search-samples.git