יצירת תוספים לשיחות ועידה

התהליך ליצירת תוסף ל-Google Workspace שמספק פתרונות לשיחות ועידה של צד שלישי ביומן זהה לתהליך ליצירת תוספים, עם כמה שלבים נוספים (שמופיעים בהדגשה בהמשך):

  1. בוחרים את בעלי הפרויקט של התוסף ואת שותפי העריכה.
  2. יוצרים פרויקט של Google Apps Script.
  3. מעצבים את המראה וההתנהגות של התוסף.
  4. מפעילים את השירות המתקדם של יומן Google.
  5. מגדירים את מניפסט הפרויקט של התוסף.
    1. הגדרת פתרונות לשיחות ועידה במניפסט.
  6. כותבים קוד כדי להגדיר את המראה וההתנהגות של התוסף באמצעות Card service המובנה ב-Apps Script.
    1. כתיבת קוד לניהול פתרונות לשיחות ועידה, באמצעות שירות ConferenceData המובנה של Apps Script.
    2. (אופציונלי) יוצרים ומגדירים דף הגדרות לתוסף.
  7. מאמתים את היקפי ההרשאות של OAuth בתוסף.
  8. בודקים את התוסף באפליקציות המארחות שהוא מרחיב.
  9. מפרסמים את התוסף.

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

הפעלת השירות המתקדם של יומן Google

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

אפשר להפעיל את השירות המתקדם של יומן Google דרך הכלי לעריכת סקריפטים. חשוב להפעיל את ה-API גם בתיבת הדו-שיח Advanced Google Services של העורך וגם במסוף Google Cloud.

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

הגדרת פתרונות לשיחות ועידה במניפסט

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

מידע נוסף על הגדרת המניפסט של התוסף זמין במאמר בנושא מניפסטים.

הוספת קוד ליצירה ולסנכרון של שיחות ועידה

אחרי שיוצרים פרויקט של סקריפט, אפשר להוסיף קוד כדי להגדיר את ההתנהגות של התוסף שקשורה לשיחות ועידה. אתם יכולים להשתמש בשירות המתקדם של Calendar, בשירות ConferenceData ובשירותים אחרים של Apps Script כדי לשלוט בהתנהגות הזו.

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

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

יצירת שיחות ועידה

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

פרטים נוספים זמינים במאמר בנושא יצירת ועידות מצד שלישי.

סנכרון שינויים ביומן

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

פרטים נוספים זמינים במאמר בנושא סנכרון שינויים ביומן.

הוספת הגדרות

יכול להיות שתרצו להוסיף הגדרות אופציונליות שיאפשרו למשתמשים להגדיר את התוסף. לדוגמה, יכול להיות שתרצו לאפשר למשתמשים להגדיר פרמטרים של שיחות ועידה או הערות שמצורפות לשיחה.

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

יצירת דף הגדרות לתוסף היא אופציונלית. פרטים נוספים מופיעים במאמר בנושא הוספת הגדרות.