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

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

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

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

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

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

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

אפשר להפעיל את השירות המתקדם של היומן בעורך של Apps Script. חשוב להפעיל את ה-API בתיבת הדו-שיח Advanced Google Services של העורך וב-Google API Console.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הוספת הגדרות

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

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

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