מדריך לתחילת העבודה עם Google Cloud Search

במדריך הזה נסביר איך לפרוס פתרון פשוט של Cloud Search, שבו GitHub משמש כמאגר הנתונים שרוצים להוסיף לאינדקס. המדריך הזה כולל שתי אפליקציות לדוגמה:

  • מחבר תוכן שנוצר באמצעות Cloud Search Connector SDK, ומשממש להוספת נתונים לאינדקס שנמצאים במאגרים של GitHub. הנתונים שנוספו לאינדקס כוללים בעיות, בקשות משיכה ותוכן ה-head של ההסתעפות שמוגדרת כברירת מחדל (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), כולל ניהול ממשקי API, הפעלת החיוב, הוספה והסרה של שותפי עריכה וכן ניהול ההרשאות.

  1. פותחים את מסוף Google Cloud.

  2. בחלק העליון של הדף, לוחצים על שמשמאל ל'מסוף Google Cloud'. תופיע תיבת דו-שיח עם רשימה של הפרויקטים הנוכחיים.

  3. לוחצים על פרויקט חדש. המסך 'פרויקט חדש' יופיע.

  4. בשדה Project Name מזינים שם פרויקט, למשל SearchTutorial.

  5. (אופציונלי) לוחצים על Edit כדי לערוך את מזהה הפרויקט. אי אפשר לשנות את מזהה הפרויקט אחרי היצירה שלו, לכן חשוב לבחור מזהה שיעמוד בצרכים שלכם לכל משך חיי הפרויקט.

  6. כדי לעיין במיקומים של הפרויקט, לוחצים על BROWSE.

  7. לוחצים על מיקום לפרויקט ולוחצים על Select.

  8. לוחצים על יצירה. המסוף עובר לדף Dashboard. הפרויקט נוצר תוך כמה דקות.

למידע נוסף על יצירה וניהול של פרויקטים, קראו את המאמר יצירה וניהול של פרויקטים.

הפעלת ה-API

כדי לקבל את פרטי הכניסה, צריך להפעיל את Google Cloud Search API וליצור חשבון שירות.

  1. בחלונית הניווט הימנית, לוחצים על APIs & Services (ממשקי API ושירותים).
  2. כדי לוודא שאתם נמצאים בפרויקט החדש שיצרתם, לוחצים על הסמל שמשמאל לבאנר של מסוף Google Cloud ובוחרים את הפרויקט החדש.
  3. לוחצים על ENABLE APIS AND SERVICES. הדף Welcome to API Library מופיע.
  4. מקלידים 'Cloud Search API' בשדה החיפוש ומקישים על return. המערכת מחזירה רשימה של ממשקי API.
  5. לוחצים על Cloud Search API. הדף Cloud Search API מופיע.
  6. לוחצים על ENABLE. יופיע דף הסקירה הכללית.

מידע נוסף על הפעלה והשבתה של ממשקי API זמין במאמר ניהול ממשקי API במסוף Google Cloud.

שכפול המאגר של המדריך

כדי לשכפל את המאגר לדוגמה, מריצים את הפקודה הבאה:

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

הבא