מדריך לתחילת העבודה עם 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. (אופציונלי) לוחצים על עריכה כדי לערוך את מזהה הפרויקט. אי אפשר לשנות את מזהה הפרויקט אחרי היצירה שלו, לכן חשוב לבחור מזהה שיעמוד בצרכים שלכם לכל משך חיי הפרויקט.

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

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

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

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

הפעלת ה-API

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

  1. בחלונית הניווט הימנית, לוחצים על APIs & Services (ממשקי API ושירותים).
  2. כדי לוודא שאתם נמצאים בפרויקט החדש שיצרתם, לוחצים על הסמל שמשמאל לבאנר של מסוף Google Cloud ובוחרים את הפרויקט החדש.
  3. לוחצים על ENABLE APIS AND SERVICES. הדף 'ברוכים הבאים לספריית ה-API' יופיע.
  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

הבא