במדריכים למתחילים מוסבר איך מגדירים ומפעילים אפליקציה שמפעילה קריאה ל-Google Workspace API.
במדריכים למתחילים של Google Workspace נעשה שימוש בספריות הלקוח של ה-API כדי לטפל בחלק מהפרטים של תהליך האימות וההרשאה. מומלץ להשתמש בספריות הלקוח באפליקציות שלכם. במדריך למתחילים הזה נעשה שימוש בגישה פשוטה לאימות שמתאימה לסביבת בדיקה. בסביבת ייצור, מומלץ ללמוד על אימות והרשאה לפני שבוחרים את פרטי הכניסה שמתאימים לאפליקציה.
ליצור סקריפט של Google Apps ששולח בקשות ל-Google Chat API.
מטרות
- מגדירים את הסביבה.
- יוצרים ומגדירים את הסקריפט.
- מריצים את הסקריפט.
דרישות מוקדמות
- חשבון Google Workspace מסוג Business או Enterprise עם גישה ל-Google Chat.
הגדרת הפרויקט ב-Cloud
אם אתם משתמשים בפרויקט חדש ב-Google Cloud כדי להשלים את המדריך למתחילים הזה, תצטרכו להגדיר אותו ולהוסיף את עצמכם כמשתמש לבדיקה. אם כבר השלמתם את השלבים האלה בפרויקט ב-Cloud, דלגו לקטע הבא.
פתיחת הפרויקט ב-Cloud במסוף Google Cloud
אם הוא עדיין לא פתוח, פותחים את פרויקט Cloud שבו רוצים להשתמש לדוגמה הזו:
- נכנסים לדף Select a project במסוף Google Cloud.
- בוחרים את הפרויקט ב-Google Cloud שבו רוצים להשתמש. לחלופין, לוחצים על Create project (יצירת פרויקט) ופועלים לפי ההוראות במסך. אם יוצרים פרויקט ב-Google Cloud, יכול להיות שתצטרכו להפעיל את החיוב בפרויקט.
הפעלת Chat API
לפני שמשתמשים ב-Google APIs, צריך להפעיל אותם בפרויקט ב-Google Cloud. אפשר להפעיל ממשק API אחד או יותר בפרויקט אחד ב-Google Cloud.במסוף Google Cloud, מפעילים את Google Chat API.
הגדרת מסך ההסכמה של OAuth
- במסוף Google Cloud, נכנסים לתפריט > APIs & Services > OAuth consent screen.
- בקטע סוג המשתמש, בוחרים באפשרות פנימי ולוחצים על יצירה.
- ממלאים את טופס הרישום של האפליקציה ולוחצים על שמירה והמשך.
בשלב הזה, אפשר לדלג על הוספת היקפי הרשאה וללחוץ על Save and Continue (שמירה והמשך). בעתיד, כשיוצרים אפליקציה לשימוש מחוץ לארגון ב-Google Workspace, צריך לשנות את סוג המשתמש ל-חיצוני, ואז להוסיף את היקפי ההרשאה הנדרשים לאפליקציה.
- בודקים את סיכום רישום האפליקציה. כדי לבצע שינויים, לוחצים על עריכה. אם הרשמת האפליקציה נראית תקינה, לוחצים על Back to Dashboard.
איך מגדירים את אפליקציית Google Chat
כדי לקרוא ל-Google Chat API, צריך להגדיר אפליקציית Google Chat. לכל בקשות הכתיבה, Google Chat משייכת את אפליקציית Google Chat בממשק המשתמש באמצעות המידע הבא.
נכנסים לדף Configuration במסוף Google Cloud:
בקטע Application info, מזינים את הפרטים הבאים:
- בשדה App name, מזינים
Chat API quickstart app
. - בשדה כתובת ה-URL של הדמות, מזינים את הערך
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - בשדה Description מזינים
Quickstart for calling the Chat API
.
- בשדה App name, מזינים
בקטע תכונות אינטראקטיביות, לוחצים על המתג הפעלת התכונות האינטראקטיביות כדי להשבית את התכונות האינטראקטיביות באפליקציית Chat.
לוחצים על שמירה.
יצירת הסקריפט
- כדי ליצור סקריפט חדש, עוברים לכתובת script.google.com/create.
- מחליפים את התוכן של עורך הסקריפטים בקוד הבא:
- לוחצים על 'שמירה' .
- לוחצים על Untitled project, מקלידים Quickstart ולוחצים על Rename.
הגדרת הסקריפט
העתקת מספר הפרויקט ב-Cloud
- במסוף Google Cloud, נכנסים לתפריט > IAM & Admin > Settings.
- מעתיקים את הערך בשדה Project number.
קישור הפרויקט ב-Google Cloud
- פותחים את הפרויקט ב-Apps Script.
- לוחצים על Project Settings (הגדרות הפרויקט) .
- בקטע פרויקט ב-Google Cloud Platform (GCP), לוחצים על שינוי פרויקט.
- בשדה GCP project number, מדביקים את מספר הפרויקט ב-Google Cloud.
- לוחצים על Set project.
הפעלת Google Chat API
- פותחים את הפרויקט ב-Apps Script.
- לוחצים על Project Settings (הגדרות הפרויקט) .
- בקטע הגדרות כלליות, מפעילים את האפשרות הצגת קובץ המניפסט 'appsscript.json' בעורך.
- לוחצים על Editor (עריכה)
appscript.json
ומחליפים את התוכן בקוד הבא:
, בוחרים את הקובץ
הרצת הדוגמה
בעורך Apps Script, לוחצים על Run.
בפעם הראשונה שתפעילו את הדוגמה, תתבקשו לאשר את הגישה:
- לוחצים על בדיקת ההרשאות.
- בוחרים חשבון.
- לוחצים על אישור.
יומן הביצוע של הסקריפט מופיע בתחתית החלון.