המדריך למתחילים של אפליקציית Google Apps Script

אתם יכולים להשתמש באפליקציה של Google Chat שאתם יכולים לשלוח לה הודעות באופן ישיר, ושהיא מגיבה להודעות שלכם.

מטרות

• מגדירים את הסביבה.
• מגדירים את הסקריפט.
• מפרסמים את האפליקציה.
• מריצים את הסקריפט.

דרישות מוקדמות

• חשבון Google Workspace שיש לו גישה ל-Chat.
• פרויקט ב-Google Cloud.

הגדרת הסביבה

פתיחת הפרויקט ב-Cloud במסוף Google Cloud

אם הפרויקט עדיין לא פתוח, פותחים את הפרויקט בענן שבו מתכוונים להשתמש עבור הדוגמה הזו:

1. נכנסים לדף Select a project במסוף Google Cloud.

   בחירת פרויקט ב-Cloud

2. בוחרים את הפרויקט ב-Google Cloud שבו רוצים להשתמש. לחלופין, לוחצים על Create project ופועלים לפי ההוראות במסך. אם אתם יוצרים פרויקט ב-Google Cloud, יכול להיות שתצטרכו להפעיל את החיוב בפרויקט.

הפעלת Chat API

כדי להשתמש ב-Google APIs, עליכם להפעיל אותם בפרויקט Google Cloud. אתם יכולים להפעיל ממשק API אחד או יותר בפרויקט אחד ב-Google Cloud.

• במסוף Google Cloud, מפעילים את Google Chat API.

  הפעלת ה-API

הגדרת מסך ההסכמה של OAuth

לכל האפליקציות שמשתמשות ב-OAuth 2.0 נדרשת הגדרה של מסך הסכמה. במסך ההסכמה של האפליקציה ל-OAuth מוגדר מה שיוצג למשתמשים ולבודקי האפליקציות. יתבצע רישום של האפליקציה כדי שתוכלו לפרסם אותה מאוחר יותר.

1. במסוף Google Cloud, נכנסים לתפריט > ממשקי API ושירותים > מסך הסכמה ל-OAuth.

   מעבר למסך ההסכמה של OAuth

2. בוחרים את סוג המשתמש עבור האפליקציה ולוחצים על יצירה.
3. ממלאים את טופס ההרשמה ולוחצים על שמירה והמשך.

4. בינתיים אפשר לדלג על הוספת היקפים וללחוץ על שמירה והמשך. בעתיד, כשיוצרים אפליקציה לשימוש מחוץ לארגון Google Workspace, צריך להוסיף ולאמת את היקפי ההרשאות שנדרשים לאפליקציה.

5. אם בחרתם בסוג המשתמש חיצוני, הוסיפו משתמשים לבדיקה:
   1. בקטע בדיקת משתמשים, לוחצים על הוספת משתמשים.
   2. מזינים את כתובת האימייל שלך וכל משתמש מורשה אחר לבדיקה, ולאחר מכן לוחצים על שמירה והמשך.
6. בודקים את סיכום הרישום של האפליקציה. כדי לערוך שינויים, לוחצים על עריכה. אם רישום האפליקציה נראה בסדר, לוחצים על חזרה למרכז השליטה.

הגדרת הסקריפט

כדי להגדיר את הסקריפט, צריך להשתמש בתבנית ואז להגדיר את הפרויקט בענן ב-Apps Script.

יצירת הסקריפט מהתבנית

1. נכנסים לדף Apps Script תחילת העבודה.
2. לוחצים על התבנית אפליקציית Chat. ייתכן שתצטרכו לגלול למטה כדי לראות את התבנית הזו.
3. לוחצים על פרויקט ללא שם, מקלידים Quickstart app ואז לוחצים על שינוי שם.

העתקת מספר הפרויקט בענן

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

הגדרה של הפרויקט בענן ב-Apps Script

1. בפרויקט Apps Script של האפליקציה Chat, לוחצים על Project settings (הגדרות הפרויקט) .
2. בקטע פרויקט Google Cloud Platform (GCP), לוחצים על שינוי פרויקט.
3. במספר הפרויקט ב-GCP, מדביקים את מספר הפרויקט ב-Google Cloud.
4. לוחצים על הגדרת פרויקט.

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

כשפותחים את התבנית של Apps Script, חשוב לוודא שנכנסתם לחשבון Google הנכון. לפעמים החשבון הנוכחי יכול לעבור לחשבון ברירת המחדל בלי שתבחינו בכך.

יצירה של פריסת בדיקה

אתה צריך מזהה פריסה לפרויקט Apps Script הזה כדי שתוכל להשתמש בו בשלב הבא.

כדי לקבל את המזהה של פריסת הראש, יש לבצע את הפעולות הבאות:

1. בפרויקט Apps Script של האפליקציה Chat, לוחצים על פריסה > בדיקת הפריסות.
2. מעתיקים את מזהה פריסת הראש כדי להשתמש בו בשלב מאוחר יותר ולוחצים על סיום.

פרסום אפליקציית Chat

אפשר לפרסם את אפליקציית Chat ממסוף Google Cloud.

1. במסוף Google Cloud, מחפשים את Google Chat API ולוחצים על Google Chat API.
2. לוחצים על ניהול.

3. לוחצים על הגדרות ומגדירים את אפליקציית Chat:

   1. בשדה שם האפליקציה, מזינים Quickstart app.
   2. בשדה כתובת ה-URL לדמות מזינים את הערך https://developers.google.com/chat/images/quickstart-app-avatar.png.
   3. בשדה תיאור, מזינים Quickstart app.
   4. בקטע 'פונקציונליות', לוחצים על קבלת צ'אטים אישיים והצטרפות למרחבים משותפים ולשיחות קבוצתיות.
   5. בקטע 'הגדרות חיבור', בוחרים באפשרות Apps Script project ובוחרים את מזהה הפריסה בשדה.
   6. בקטע 'הרשאות', לוחצים על אנשים וקבוצות ספציפיים בדומיין ומזינים את כתובת האימייל.

4. לוחצים על שמירה ומרעננים את הדף.

5. בדף ההגדרה, בקטע סטטוס אפליקציה, מגדירים את הסטטוס לפעיל - זמין למשתמשים.

6. לוחצים על שמירה.

אפליקציית Chat מוכנה לענות להודעות.

הרצת הסקריפט

1. פותחים את Chat.
2. כדי לשלוח צ'אט אישי חדש לאפליקציה, לוחצים על התחלת צ'אט > חיפוש אפליקציות.
3. בדף חיפוש אפליקציות, מחפשים את Quickstart App.
4. ליד אפליקציה למתחילים, לוחצים על צ'אט.
5. בצ'אט האישי החדש עם האפליקציה, מקלידים Hello ולוחצים על enter.

תודה שהוספת את האפליקציה.

השלבים הבאים

• יצירת כרטיסים אינטראקטיביים – הודעות עם כרטיס תומכות בפריסה מוגדרת, ברכיבים אינטראקטיביים בממשק משתמש כמו לחצנים, ובמדיה עשירה כמו תמונות. תוכלו להשתמש בהודעות בכרטיס כדי להציג מידע מפורט, לאסוף מידע ממשתמשים ולהדריך אותם בשלבים הבאים.
• תמיכה בפקודות דרך שורת הפקודות – פקודות Slash מאפשרות לרשום ולפרסם פקודות ספציפיות שמשתמשים יכולים לתת לאפליקציה שלכם באמצעות הקלדת פקודה שמתחילה בקו נטוי (/), כמו /help.
• השקת תיבות דו-שיח – תיבות דו-שיח הן חלונות מבוססי-כרטיסים שהאפליקציה שלך יכולה לפתוח כדי ליצור אינטראקציה עם משתמש. ניתן לקבץ יחד מספר כרטיסים ברצף, כדי לעזור למשתמשים להשלים תהליכים מרובי שלבים, כמו מילוי נתוני טפסים.