يوضح هذا البرنامج التعليمي كيفية نشر حل Cloud Search بسيط واستخدام GitHub كمستودع للبيانات المطلوب فهرستها. على وجه التحديد، يتألف هذا الدليل التمهيدي من مثالَين على التطبيقات:
- موصِّل محتوى تم إنشاؤه باستخدام
حزمة تطوير البرامج (SDK) لموصِّل Cloud Search، ويُستخدَم للفهرسة
البيانات المتوفّرة في مستودعات GitHub تشمل البيانات المفهرَسة المشاكل وطلبات سحب الرمز المبرمَج،
ومحتوى الرأس في الفرع التلقائي (
master). - تطبيق ويب يستخدم أداة بحث لتوفير واجهة بحث مخصّصة
المتطلبات الأساسية
تتطلب هذه الدورة التعليمية المتطلبات الأساسية التالية:
- إذن وصول المشرف إلى نطاق Google Workspace أو Cloud Identity مع تفعيل Cloud Search لفهرسة البيانات التابعة لجهات خارجية إذا لم تتمكّن من عرض الإعدادات في لوحة تحكّم المشرف، يُرجى التواصل مع مشرف نطاقك أو الاشتراك في Cloud Search.
- حساب مستخدم على GitHub
- الإلمام بلغة Java وJavaScript.
- الإصدار 8 من Java أو إصدار أحدث
- Maven.
- Node.js 8.11 أو إصدار أحدث
إنشاء مشروع البرنامج التعليمي
للبدء، عليك إنشاء مشروع Google Cloud Platform. يشكّل هذا المشروع الأساس لإنشاء جميع خدمات Google Cloud Platform (GCP) وتفعيلها واستخدامها، بما في ذلك إدارة واجهات برمجة التطبيقات وتفعيل الفوترة وإضافة المتعاونين ونقلهم وإدارة الأذونات.
افتح Google Cloud Console.
في أعلى الصفحة، انقر على رمز على يسار "Google Cloud Console". سيظهر مربّع حوار يسرد المشاريع الحالية.
انقر على مشروع جديد. تظهر شاشة "مشروع جديد".
في الحقل اسم المشروع، أدخِل اسم المشروع، مثل "SearchTutorial".
(اختياري) انقر على تعديل لتعديل رقم تعريف المشروع. لا يمكن تغيير رقم تعريف المشروع بعد إنشاء المشروع، لذا اختَر معرّفًا يلبي احتياجاتك طوال فترة المشروع.
لتصفُّح المواقع الجغرافية للمشروع، انقر على تصفُّح.
انقر على موقع جغرافي لمشروعك وانقر على اختيار.
انقر على إنشاء. تنتقل وحدة التحكّم إلى صفحة "لوحة البيانات". يتم إنشاء المشروع في غضون بضع دقائق.
لمزيد من المعلومات عن إنشاء المشاريع وإدارتها، يُرجى الاطّلاع على مقالة إنشاء المشاريع وإدارتها.
تفعيل واجهة برمجة التطبيقات
عليك تفعيل Google Cloud Search API وإنشاء حساب خدمة للحصول على بيانات الاعتماد.
- في شريط التنقّل الأيمن، انقر على واجهات برمجة التطبيقات والخدمات.
- للتأكّد من أنّك في المشروع الذي تم إنشاؤه حديثًا، انقر على رمز على يسار بانر وحدة تحكّم Google Cloud واختَر مشروعك الذي تم إنشاؤه حديثًا.
- انقر على تفعيل واجهات برمجة التطبيقات والخدمات. تظهر صفحة "مرحبًا بك في مكتبة واجهات برمجة التطبيقات".
- اكتب "Cloud Search API" في حقل البحث واضغط على زر return. يتم عرض قائمة بواجهات برمجة التطبيقات.
- انقر على Cloud Search API. تظهر صفحة "واجهة برمجة تطبيقات Cloud Search".
- انقر على تفعيل. تظهر صفحة "نظرة عامة".
لمزيد من المعلومات حول تفعيل واجهات برمجة التطبيقات وإيقافها، يُرجى الرجوع إلى مقالة إدارة واجهات برمجة التطبيقات في Google Cloud Console.
استنساخ مستودع البرنامج التعليمي
لنسخ نموذج المستودع، شغِّل الأمر التالي:
git clone https://github.com/googleworkspace/cloud-search-samples.git