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