איך קובעים פגישות ב-Google Chat

רמת הקידוד: בינונית
משך הזמן: 25 דקות
סוג הפרויקט: תוסף ל-Google Workspace להרחבת Chat.

מטרות

  • להבין מה הפתרון עושה.
  • הסבר על הפעולות של שירותי Apps Script בפתרון.
  • מגדירים את הסביבה.
  • מגדירים את הסקריפט.
  • מריצים את הסקריפט.

מידע על הפתרון הזה

אתם יכולים לקבוע פגישה ביומן Google מתוך צ'אט ישיר או מתוך מרחב ב-Google Chat. אתם יכולים להגדיר פרטים ספציפיים לפגישה, כמו נושא, שעת התחלה או משך, או להשתמש בהגדרות ברירת המחדל לתזמון פגישה מיידית.

ממשק תיבת הדו-שיח של אפליקציית Chat לתזמון פגישות

איך זה עובד

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

שירותי Apps Script

הפתרון הזה משתמש בשירותים הבאים:

  • שירות היומן – יוצר את האירוע ביומן מפרטי הפגישה שסופקו.
  • שירות בסיסי – נעשה שימוש במחלקה Session כדי לקבל את אזור הזמן של הסקריפט. היומן משתמש באזור הזמן הזה כשמגדירים את האירוע.
  • שירות כלי עזר – מעצב את התאריך של האירוע ביומן ומקודד את מזהה האירוע כדי לקבל את כתובת ה-URL של האירוע.

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

הגדרת הסביבה

פותחים את פרויקט בענן במסוף Google Cloud

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

  1. במסוף Google Cloud, עוברים לדף Select a project.

    בוחרים פרויקט בענן

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

הפעלת ה-API

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

כל אפליקציות Chat דורשות הגדרה של מסך הסכמה. הגדרת מסך ההסכמה ל-OAuth של האפליקציה קובעת מה Google מציגה למשתמשים, ורושמת את האפליקציה כדי שתוכלו לפרסם אותה בהמשך.

  1. במסוף Google Cloud, עוברים אל תפריט > Google Auth platform > Branding.

    מעבר לדף Branding

  2. אם כבר הגדרתם את Google Auth platform, אתם יכולים לקבוע את ההגדרות הבאות של מסך ההסכמה ל-OAuth בקטעים Branding,‏ Audience וData Access. אם מופיעה ההודעה Google Auth platform not configured yet, לוחצים על Get Started:
    1. בקטע App Information בשדה App name, מזינים שם לאפליקציה.
    2. בקטע User support email, בוחרים כתובת אימייל לתמיכה שאליה משתמשים יפנו אם יש להם שאלות לגבי ההסכמה שלהם.
    3. לוחצים על Next.
    4. בקטע Audience, לוחצים על Internal.
    5. לוחצים על Next.
    6. בקטע Contact Information, מזינים כתובת אימייל שאליה אפשר לשלוח התראות על שינויים בפרויקט.
    7. לוחצים על Next.
    8. בקטע Finish, קוראים את המדיניות של Google בנושא נתוני משתמשים בשירותי API. אם אתם מסכימים, סמנו את התיבה I agree to the Google API Services: User Data Policy.
    9. לוחצים על Continue.
    10. לוחצים על Create.
  3. כרגע אתם יכולים לדלג על הוספת היקפי הרשאות. בעתיד, כשתיצרו אפליקציה לשימוש מחוץ לארגון שלכם ב-Google Workspace, תצטרכו לשנות את סוג המשתמש ל-External. לאחר מכן מוסיפים את היקפי ההרשאות שהאפליקציה דורשת. למידע נוסף, אפשר לעיין במדריך המלא בנושא הגדרת הסכמה ל-OAuth.

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

יצירת פרויקט Apps Script

  1. לוחצים על הלחצן הבא כדי לפתוח את פרויקט Apps Script‏ Schedule meetings from Google Chat (קביעת פגישות מ-Google Chat).
    פתיחת הפרויקט
  2. לוחצים על סקירה כללית .
  3. בדף הסקירה הכללית, לוחצים על סמל יצירת העותק הסמל ליצירת עותק.

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

  1. בפרויקט Apps Script שהעתקתם, לוחצים על Deploy (פריסה) > Test deployments (פריסות לבדיקה).
  2. מעתיקים את מזהה הפריסה של הגרסה האחרונה לשימוש בשלב מאוחר יותר ולוחצים על סיום.

הגדרת Chat API

  1. במסוף Google Cloud, עוברים לדף Chat API.
    ל-Chat API
  2. לוחצים על הגדרה.
  3. מגדירים את Chat API עם המידע הבא:
    • Name (שם): Meeting Scheduler
    • כתובת ה-URL של האווטאר: https://goo.gle/3SfMkjb.
    • תיאור: Quickly create meetings.
    • פונקציונליות: מסמנים את שתי התיבות כדי לאפשר למשתמשים לשלוח הודעות ישירות לאפליקציה ולהוסיף אותה למרחבים.
    • הגדרות חיבור: לוחצים על Apps Script ומזינים את מזהה הפריסה הראשית.
    • פקודות: מוסיפים פקודות דרך שורת הפקודות עבור /help ו-/schedule_Meeting באמצעות השלבים הבאים:
      1. לוחצים על הוספת פקודה ומגדירים אותה עם המידע הבא:
        • מזהה הפקודה: 1.
        • תיאור: Learn what this app does.
        • סוג הפקודה: Slash command.
        • שם הפקודה דרך שורת הפקודות: /help.
      2. לוחצים שוב על הוספת פקודה ומגדירים אותה עם המידע הבא:
        • מזהה הפקודה: 2.
        • תיאור: Schedule a meeting.
        • סוג הפקודה: Slash command.
        • שם הפקודה דרך שורת הפקודות: /schedule_Meeting.
        • מסמנים את התיבה הקישור פותח תיבת דו-שיח.
    • הרשאות: בוחרים באפשרות אנשים וקבוצות ספציפיים בדומיין ומזינים את כתובת האימייל.
  4. לוחצים על שמירה.

הפעלת הסקריפט

  1. פותחים את Google Chat.

    מעבר אל Google Chat

  2. לוחצים על הסמל 'התחלת צ'אט' .

  3. מחפשים את שם האפליקציה, Meeting Scheduler.

  4. שולחים הודעה ראשונית, כמו hello, כדי לבקש הרשאה.

  5. כשהאפליקציה משיבה, לוחצים על הגדרה ומאשרים את האפליקציה. אם במסך ההסכמה ל-OAuth מוצגת האזהרה האפליקציה הזו לא אומתה, ממשיכים בתהליך על ידי בחירה באפשרות מתקדם > מעבר אל {שם הפרויקט} (לא בטוח).

  6. שולחים את /schedule_Meeting לאפליקציה.

  7. בתיבת הדו-שיח, מוסיפים לפחות כתובת אימייל אחת של מוזמן. אפשר לעדכן את השדות האחרים או להשתמש בערכים שמוגדרים כברירת מחדל.

  8. לוחצים על שליחה.

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

בדיקת הקוד

כדי לעיין בקוד Apps Script של הפתרון הזה שמתארח ב-GitHub, לחצו כאן:

הצגת הקוד ב-GitHub

השלבים הבאים