במדריך הזה נסביר איך לפרוס פתרון פשוט של 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), כולל ניהול ממשקי API, הפעלת חיוב, הוספה והסרה של שותפי עריכה וניהול ההרשאות.
פותחים את מסוף Google Cloud.
בחלק העליון של הדף, לוחצים על משמאל ל'מסוף Google Cloud'. תופיע תיבת דו-שיח עם רשימת הפרויקטים הנוכחיים.
לוחצים על פרויקט חדש. המסך 'פרויקט חדש' יופיע.
בשדה Project Name, מזינים את שם הפרויקט, למשל Search Guide (מדריך החיפוש).
(אופציונלי) לוחצים על עריכה כדי לערוך את מזהה הפרויקט. אי אפשר לשנות את מזהה הפרויקט אחרי יצירת הפרויקט, לכן חשוב לבחור מזהה שעונה על הצרכים שלכם לכל משך החיים של הפרויקט.
כדי לעיין במיקומים של הפרויקט, לוחצים על חיפוש.
לוחצים על מיקום הפרויקט ואז על Select.
לוחצים על יצירה. המסוף עובר לדף Dashboard (מרכז הבקרה). הפרויקט נוצר תוך מספר דקות.
למידע נוסף על יצירה וניהול של פרויקטים, קראו את המאמר יצירה וניהול של פרויקטים.
הפעלת ה-API
כדי לקבל פרטי כניסה, צריך להפעיל את Google Cloud Search API וליצור חשבון שירות.
- בחלונית הניווט השמאלית לוחצים על APIs & Services (ממשקי API ושירותים).
- כדי לוודא שאתם משתמשים בפרויקט החדש שנוצר, לוחצים על הסמל שמשמאל לבאנר במסוף Google Cloud ובוחרים את הפרויקט החדש שיצרתם.
- לוחצים על ENABLE APIS AND SERVICES. הדף 'ברוכים הבאים לספריית ה-API' יופיע.
- מקלידים "Cloud Search API" בשדה החיפוש ומקישים על מקש return. מוצגת רשימה של ממשקי API.
- לוחצים על Cloud Search API. הדף 'Cloud Search API' יופיע.
- לוחצים על הפעלה. הדף 'סקירה כללית' מופיע.
מידע נוסף על הפעלה והשבתה של ממשקי API מופיע במאמר ניהול ממשקי API במסוף Google Cloud.
שכפול המאגר של המדריכים
כדי לשכפל את המאגר לדוגמה, מריצים את הפקודה הבאה:
git clone https://github.com/googleworkspace/cloud-search-samples.git