רמת הקוד: בינונית
משך הזמן: 25 דקות
סוג הפרויקט: אפליקציית Google Chat
מטרות
- להבין מה הפתרון עושה.
- הסבר על הפעולות של שירותי Apps Script בתוך הפתרון.
- מגדירים את הסביבה.
- מגדירים את הסקריפט.
- מריצים את הסקריפט.
מידע על הפתרון הזה
אתם יכולים לקבוע פגישה ביומן Google מתוך הודעה ישירה (DM) או מתוך מרחבים משותפים ב-Google Chat. אתם יכולים להגדיר פרטים ספציפיים לפגישה, כמו נושא, שעת התחלה או משך זמן, או להשתמש בהגדרות ברירת המחדל לתזמון פגישות מיידיות.
איך זה עובד
הסקריפט של אפליקציית Chat משתמש בפקודות קו נטוי ובתיבות דו-שיח כדי לקבל מהמשתמשים את פרטי הפגישה ולתזמן אירוע ביומן. הסקריפט כולל הגדרות ברירת מחדל לפגישות, שאפשר להתאים אישית בהתאם לצרכים שלכם.
שירותי Apps Script
הפתרון הזה משתמש בשירותים הבאים:
- שירות יומן – יצירת האירוע ביומן לפי פרטי הפגישה שסיפקתם.
- Base service – השירות משתמש בכיתה
Session
כדי לקבל את אזור הזמן של הסקריפט. אזור הזמן הזה ישמש את יומן Google כשיתבצע תזמון האירוע. - שירות כלי עזר – השירות הזה מגדיר את התאריך של האירוע ביומן ומקודד את מזהה האירוע כדי לקבל את כתובת ה-URL של האירוע.
דרישות מוקדמות
- חשבון Google Workspace בתוכנית Business או Enterprise עם גישה ל-Google Chat.
- יוצרים פרויקט ב-Google Cloud.
הגדרת הסביבה
פותחים את פרויקט Cloud במסוף Google Cloud
אם הוא עדיין לא פתוח, פותחים את פרויקט Cloud שבו רוצים להשתמש לדוגמה הזו:
- נכנסים לדף Select a project במסוף Google Cloud.
- בוחרים את הפרויקט ב-Google Cloud שבו רוצים להשתמש. לחלופין, לוחצים על Create project (יצירת פרויקט) ופועלים לפי ההוראות במסך. אם יוצרים פרויקט ב-Google Cloud, יכול להיות שתצטרכו להפעיל את החיוב בפרויקט.
הפעלת ה-API
לפני שמשתמשים ב-Google APIs, צריך להפעיל אותם בפרויקט ב-Google Cloud. אפשר להפעיל ממשק API אחד או יותר בפרויקט אחד ב-Google Cloud.מפעילים את Google Chat API בפרויקט ב-Cloud.
הגדרת מסך ההסכמה של OAuth
בכל האפליקציות של Chat צריך להגדיר מסך הסכמה. הגדרת מסך ההסכמה ל-OAuth של האפליקציה קובעת מה Google תציג למשתמשים ומרשמת את האפליקציה כדי שתוכלו לפרסם אותה מאוחר יותר.
- במסוף Google Cloud, נכנסים לתפריט > > Branding.
- אם כבר הגדרתם את , תוכלו להגדיר את ההגדרות הבאות של מסך ההסכמה ל-OAuth בקטע מיתוג, קהל וגישה לנתונים. אם מופיעה ההודעה not configured yet, לוחצים על Get Started:
- בקטע פרטי האפליקציה, בשדה שם האפליקציה, מזינים שם לאפליקציה.
- בקטע כתובת אימייל לתמיכה במשתמשים, בוחרים כתובת אימייל לתמיכה שבה המשתמשים יוכלו לפנות אליכם אם יש להם שאלות לגבי ההסכמה שלהם.
- לוחצים על הבא.
- בקטע קהל, בוחרים באפשרות פנימי.
- לוחצים על הבא.
- בקטע פרטים ליצירת קשר, מזינים כתובת אימייל שאליה יישלחו התראות על שינויים בפרויקט.
- לוחצים על הבא.
- בקטע סיום, קוראים את המדיניות בנושא נתוני משתמשים בשירותי Google API. אם מסכימים, בוחרים באפשרות אני מסכים/ה למדיניות בנושא נתוני משתמשים בשירותי Google API.
- לוחצים על המשך.
- לוחצים על יצירה.
- בשלב הזה, אפשר לדלג על הוספת היקפי הרשאות. בעתיד, כשיוצרים אפליקציה לשימוש מחוץ לארגון ב-Google Workspace, צריך לשנות את סוג המשתמש לחיצוני. לאחר מכן מוסיפים את היקפי ההרשאה הנדרשים לאפליקציה. למידע נוסף, קראו את המדריך המלא בנושא הגדרת הסכמה ל-OAuth.
הגדרת הסקריפט
יצירת פרויקט Apps Script
- לוחצים על הלחצן הבא כדי לפתוח את הפרויקט של Apps Script תזמון פגישות מ-Google Chat.
פתיחת הפרויקט - לוחצים על סקירה כללית .
- בדף הסקירה הכללית, לוחצים על 'יצירת עותק'
.
מעתיקים את מספר הפרויקט ב-Cloud
- במסוף Google Cloud, נכנסים לתפריט > IAM & Admin > Settings.
- בשדה Project number, מעתיקים את הערך.
הגדרת הפרויקט ב-Cloud של פרויקט Apps Script
- בפרויקט Apps Script שהעתקתם, לוחצים על Project Settings (הגדרות הפרויקט)
.
- בקטע פרויקט Google Cloud Platform (GCP), לוחצים על שינוי פרויקט.
- בשדה GCP project number, מדביקים את מספר הפרויקט ב-Google Cloud.
- לוחצים על Set project.
יצירת פריסה לבדיקה
- בפרויקט Apps Script שהעתקתם, לוחצים על פריסה > בדיקת פריסות.
- מעתיקים את מזהה הפריסה הראשית לשימוש בשלב מאוחר יותר ולוחצים על Done.
הגדרת Chat API
- נכנסים לדף Chat API במסוף Google Cloud.
כניסה לדף Chat API - לוחצים על Configuration (הגדרה).
- מגדירים את Chat API עם הפרטים הבאים:
- שם:
Meeting Scheduler
- כתובת ה-URL של הדמות: מוסיפים כתובת URL שמפנה לתמונה בגודל מינימלי של 256x256 פיקסלים.
- תיאור:
Quickly create meetings.
- פונקציונליות: מסמנים את שתי התיבות כדי לאפשר למשתמשים לשלוח הודעות לאפליקציה ישירות ולהוסיף אותה למרחבים משותפים.
- Connection settings (הגדרות החיבור): לוחצים על Apps Script ומזינים את מזהה הפריסה של הראש.
- פקודות דרך שורת הפקודה: כדי להוסיף פקודות דרך שורת הפקודה עבור
/help
ו-/schedule_Meeting
:- לוחצים על Add slash command ומגדירים אותה עם המידע הבא:
- שם:
/help
- מזהה הפקודה:
1
- תיאור:
Learn what this app does.
- שם:
- לוחצים שוב על Add slash command ומגדירים את הפקודה באמצעות המידע הבא:
- שם:
/schedule_Meeting
- מזהה הפקודה:
2
- תיאור:
Schedule a meeting.
- מסמנים את התיבה Opens a dialog.
- שם:
- לוחצים על Add slash command ומגדירים אותה עם המידע הבא:
- הרשאות: בוחרים באפשרות אנשים וקבוצות ספציפיים בדומיין ומזינים את כתובת האימייל.
- שם:
- לוחצים על שמירה ומרעננים את הדף.
- בדף ההגדרות, בקטע סטטוס האפליקציה, מגדירים את הסטטוס כפעילה – זמינה למשתמשים.
- לוחצים על שמירה.
מריצים את הסקריפט
- פותחים את Google Chat.
- לוחצים על 'התחלת צ'אט' .
- מחפשים את שם האפליקציה,
Meeting Scheduler
. - שולחים הודעה ראשונית, כמו
hello
, כדי לבקש הרשאה. כשהאפליקציה תשייב, לוחצים על הגדרה ומעניקים לאפליקציה הרשאה. אם במסך ההסכמה ל-OAuth מוצגת האזהרה האפליקציה הזו לא מאומתת, ממשיכים על ידי בחירה באפשרות מתקדם > כניסה אל {שם הפרויקט} (לא בטוח).
שולחים את
/schedule_Meeting
לאפליקציה.בתיבת הדו-שיח, מוסיפים לפחות כתובת אימייל אחת של מי שרוצים להזמין. אפשר לעדכן את שאר השדות או להשתמש בערכים שמוגדרים כברירת מחדל.
לוחצים על שליחה.
כדי להציג את הפגישה, לוחצים על פתיחת האירוע ביומן.
בדיקת הקוד
כדי לבדוק את הקוד של Apps Script לפתרון הזה, לוחצים על הצגת קוד המקור בהמשך: