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