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

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

התהליך ליצירת תוסף ל-Google Workspace שמספק פתרונות של צד שלישי לשיחות ועידה ביומן Google זהה, בעיקרון, לתהליך ליצירת תוספים ל-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).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מידע נוסף זמין במאמר סנכרון השינויים ביומן.

הוספת הגדרות

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

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

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