רמת תכנות: ביניים
משך: 25 דקות
סוג הפרויקט: אפליקציית Google Chat
מטרות
- הבנה מה הפתרון עושה.
- להבין מה שירותי Apps Script עושים במסגרת הפתרון.
- הגדרת הסביבה.
- מגדירים את הסקריפט.
- מריצים את הסקריפט.
מידע על הפתרון הזה
אתם יכולים לקבוע פגישות ביומן Google מתוך צ'אט אישי או מרחב משותף ב-Google Chat. תוכלו לבחור פרטים ספציפיים לפגישה, כמו נושא, שעת התחלה או משך הפגישה, או להשתמש בהגדרות ברירת המחדל לקביעת פגישות מיידיות.
איך זה עובד
הסקריפט של אפליקציית Chat משתמש בפקודות דרך לוכסן ובתיבות דו-שיח כדי לקבל את פרטי הפגישה מהמשתמשים ולקבוע אירוע ביומן. הסקריפט כולל הגדרות ברירת מחדל לפגישה, שאותן ניתן להתאים אישית לצרכים שלכם.
שירותי Apps Script
הפתרון הזה משתמש בשירותים הבאים:
- שירות היומן – יוצר את האירוע ביומן מתוך פרטי הפגישה שסופקו.
- שירות בסיסי – משתמש במחלקה
Session
על מנת לקבל את אזור הזמן של הסקריפט. אזור הזמן הזה מחושב ביומן Google כשמתזמנים את האירוע. - כלים לתחזוקת המחשב – פורמט התאריך של האירוע ביומן וקידוד של מזהה האירוע כך שתקבלו את כתובת ה-URL של האירוע.
דרישות מוקדמות
כדי להשתמש בדוגמה הזו, נדרשות הדרישות המוקדמות הבאות:
- חשבון Google (יכול להיות שיהיה צורך באישור אדמין).
- דפדפן אינטרנט עם גישה לאינטרנט.
- פרויקט ב-Google Cloud.
הגדרת הסביבה
פתיחת הפרויקט ב-Cloud במסוף Google Cloud
אם הוא לא פתוח, פותחים את הפרויקט ב-Cloud שבו אתם מתכוונים להשתמש בדוגמה הזו:
- נכנסים לדף Select a project במסוף Google Cloud.
- בוחרים את הפרויקט ב-Google Cloud שבו רוצים להשתמש. לחלופין, לוחצים על יצירת פרויקט ופועלים לפי ההוראות שבמסך. אם אתם יוצרים פרויקט ב-Google Cloud, ייתכן שאתם צריכים להפעיל את החיוב בפרויקט.
הפעלת ה-API
כדי להשתמש ב-Google APIs, צריך להפעיל אותם בפרויקט ב-Google Cloud. אפשר להפעיל ממשק API אחד או יותר בפרויקט אחד ב-Google Cloud.בפרויקט ב-Cloud, מפעילים את Google Chat API.
הגדרת מסך ההסכמה של OAuth
צריך להגדיר מסך הסכמה לכל האפליקציות של Chat. מסך ההסכמה ל-OAuth של האפליקציה מגדיר מה Google מציגה למשתמשים, ומתעדת את האפליקציה כדי שיהיה אפשר לפרסם אותה מאוחר יותר.
- במסוף Google Cloud, נכנסים לתפריט > APIs & Services > מסך ההסכמה של OAuth.
- בהגדרה סוג משתמש, בוחרים באפשרות פנימי ולוחצים על יצירה.
- ממלאים את טופס ההרשמה לאפליקציה ולוחצים על שמירה והמשך.
בינתיים, אפשר לדלג על הוספת היקפים וללחוץ על שמירה והמשך. בעתיד, כשיוצרים אפליקציה לשימוש מחוץ לארגון ב-Google Workspace, צריך לשנות את סוג המשתמש לחיצוני ואז להוסיף את היקפי ההרשאות שנדרשים לאפליקציה.
- לבדוק את הסיכום של רישום האפליקציה. כדי לבצע שינויים, לוחצים על עריכה. אם הרישום של האפליקציה נראה בסדר, לוחצים על Back to Dashboard (חזרה למרכז השליטה).
הגדרת הסקריפט
יצירת פרויקט Apps Script
- לוחצים על הלחצן הבא כדי לפתוח את פרויקט Apps Script, קביעת פגישות מ-Google Chat.
פתיחת הפרויקט - לוחצים על סקירה כללית .
- בדף הסקירה הכללית, לוחצים על 'יצירת עותק' .
העתקת מספר הפרויקט ב-Cloud
- במסוף Google Cloud, נכנסים לתפריט > IAM & Admin > הגדרות.
- מעתיקים את הערך בשדה Project number.
הגדרת הפרויקט בענן של פרויקט Apps Script
- בפרויקט Apps Script שהעתקתם, לוחצים על Project Settings (הגדרות הפרויקט) .
- בקטע פרויקט Google Cloud Platform (GCP), לוחצים על שינוי פרויקט.
- בקטע מספר פרויקט GCP, מדביקים את מספר הפרויקט ב-Google Cloud.
- לוחצים על Set project.
יצירה של פריסת בדיקה
- בפרויקט Apps Script שהעתקתם, לוחצים על פריסה > בדיקת פריסות.
- מעתיקים את מזהה פריסת ה-Head לשימוש בשלב מאוחר יותר ולוחצים על Done.
הגדרת Chat API
- נכנסים לדף Chat API במסוף Google Cloud.
כניסה ל-Chat API - לוחצים על הגדרה.
- מגדירים את Chat API באמצעות הפרטים הבאים:
- שם:
Meeting Scheduler
- כתובת URL של הדמות: צריך להוסיף כתובת URL שמפנה לתמונה בגודל מינימלי של 256x256 פיקסלים.
- תיאור:
Quickly create meetings.
- פונקציונליות: מסמנים את שתי התיבות כדי לאפשר למשתמשים לשלוח הודעות לאפליקציה ישירות ולהוסיף אותה למרחבים משותפים.
- הגדרות חיבור: לוחצים על Apps Script ומזינים את מזהה פריסת ה-head.
- פקודות Slash: מוסיפים פקודות עבור
/help
ו-/schedule_Meeting
על ידי ביצוע השלבים הבאים:- לוחצים על Add לוכסן כדי להגדיר את הפקודה עם הפרטים הבאים:
- שם:
/help
- מזהה הפקודה:
1
- תיאור:
Learn what this app does.
- שם:
- לוחצים שוב על Add לוכסן ומגדירים אותה עם הפרטים הבאים:
- שם:
/schedule_Meeting
- מזהה הפקודה:
2
- תיאור:
Schedule a meeting.
- מסמנים את התיבה פתיחה של תיבת דו-שיח.
- שם:
- לוחצים על Add לוכסן כדי להגדיר את הפקודה עם הפרטים הבאים:
- הרשאות: בוחרים באפשרות אנשים וקבוצות ספציפיים בדומיין ומזינים את כתובת האימייל.
- שם:
- לוחצים על שמירה ומרעננים את הדף.
- בדף התצורה, בקטע App status, מגדירים את הסטטוס Live - available to users.
- לוחצים על שמירה.
מריצים את הסקריפט
- פותחים את Google Chat.
- לוחצים על הסמל 'התחלת צ'אט' .
- מחפשים את שם האפליקציה,
Meeting Scheduler
. - יש לשלוח הודעה ראשונית, למשל
hello
, כדי לבקש הרשאה. כשהאפליקציה מגיבה, לוחצים על הגדרה ומאשרים את האפליקציה. אם במסך ההסכמה של OAuth מוצגת האזהרה האפליקציה הזו לא מאומתת, ממשיכים על ידי בחירה באפשרות מתקדם > מעבר אל {Project Name} (לא בטוח).
שליחת
/schedule_Meeting
לאפליקציה.בתיבת הדו-שיח, מוסיפים לפחות כתובת אימייל אחת של המוזמן. אפשר לעדכן את השדות האחרים או להשתמש ברשומות ברירת המחדל.
לוחצים על שליחה.
כדי לראות את הפגישה, לוחצים על פתיחת האירוע ביומן.
בדיקת הקוד
על מנת לבדוק את קוד Apps Script של הפתרון הזה, יש ללחוץ על הצגת קוד המקור למטה:
הצגת קוד המקור
Code.gs
Dialog.gs
Utilities.gs
תורמים
הדוגמה הזו מנוהלת על ידי Google בעזרת מומחי המפתחים של Google.