מדריך לתחילת העבודה עם 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 Console". תופיע תיבת דו-שיח שבה מפורטים הפרויקטים הנוכחיים.

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

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

  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. לוחצים על הפעלה. מופיע הדף 'סקירה כללית'.

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

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

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

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

הבא