פריסה של תוסף ל-Meet

התוספים של Google Meet נוצרים ומתוכננים כחלק מפרויקט ב-Google Cloud.

הערה: כדי ליצור תוסף, קודם צריך ליצור אפליקציית אינטרנט שמשתמשת ב-SDK של התוספים של Meet.

יצירת פרויקט של Google Cloud

במאמר יצירת פרויקט ב-Google Cloud מוסבר איך יוצרים פרויקט ב-Google Cloud.

הפעלת Google Workspace Marketplace SDK ו-Google Workspace add-ons API

כדי לפתח תוספים ל-Meet, נדרשים ערכת ה-SDK של Google Workspace Marketplace וממשק ה-API של תוספים ל-Google Workspace. כדי להפעיל אותן:

1. פותחים את מסוף Google Cloud.
2. בחלק העליון, אם פרויקט אחר כבר פתוח, בוחרים את שם הפרויקט של האפליקציה כדי לעבור לפרויקט אחר.
3. בסרגל החיפוש שלמעלה, מקלידים Google Workspace Marketplace SDK ומקישים על Enter.

4. פותחים את הדף Google Workspace Marketplace SDK ולוחצים על Enable (הפעלה).

   אזהרה: חשוב לוודא שמפעילים את Google Workspace Marketplace SDK ולא את ה-API. Google Workspace Marketplace API הוא כלי אחר המשמש לשילוב עם שירותי הרישוי והחיוב של Google.

5. חוזרים על השלבים האלה כדי למצוא ולהפעיל את Google Workspace add-ons API.

יצירת פריסה

כדי להשתמש בתוסף ב-Meet, צריך פריסה וקובץ מניפסט של התוסף.

עוברים אל Google Workspace Marketplace SDK של הפרויקט במסוף Google Cloud

1. פותחים את מסוף Google Cloud.
2. בחלק העליון, אם פרויקט אחר כבר פתוח, בוחרים את שם הפרויקט של האפליקציה כדי לעבור לפרויקט אחר.
3. לוחצים על APIs & Services.
4. בוחרים באפשרות Google Workspace Marketplace SDK כדי להציג את דף הפרטים.

יצירת הפריסה

אפשר ליצור את הפריסה ישירות במסוף Google Cloud על ידי יצירת פריסה של HTTP (מומלץ) או באמצעות Google Apps Script.

פריסת HTTP

1. לוחצים על הכרטיסייה פריסות HTTP.

2. לוחצים על Create new deployment ומזינים את מזהה הפריסה של התוסף.

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

3. לוחצים על הבא.

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

   קובץ המניפסט של התוסף הוא קובץ ההגדרה המרכזי של תוסף ל-Google Meet. בדוגמת הקוד הבאה מוצגים השדות הזמינים של Meet לאינטרנט בקובץ המניפסט של התוסף.

   {
     "addOns": {
       "common": {
         "name": "NAME",
         "logoUrl": "LOGO_URL"
       },
       "meet": {
         "web": {
           "sidePanelUri": "SIDE_PANEL_URI",
           "addOnOrigins": ["ADD_ON_ORIGINS"],
           "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
           "logoUrl": "MEET_WEB_LOGO_URL",
           "supportsScreenSharing": SUPPORTS_SCREENSHARING
         }
       }
     }
   }
   

   מחליפים את מה שכתוב בשדות הבאים:

   • NAME: מחרוזת. השם של התוסף ל-Google Meet.
   • LOGO_URL: מחרוזת. כתובת ה-URL של הלוגו של התוסף ל-Google Workspace. הוא משמש את התוסף במוצרי Google Workspace.
   • SIDE_PANEL_URI: מחרוזת. כתובת ה-URL לנקודת הכניסה של אפליקציית התוסף. היא מוצגת ב-iframe בחלונית הצדדית. המקור של כתובת ה-URL הזו חייב להיות חלק מהמקורות שצוינו בשדה ADD_ON_ORIGINS.
   • ADD_ON_ORIGINS: רשימה של מחרוזות. רשימה של מקורות שבהם התוסף מתארח. לשתי כתובות URL יש אותו מקור כשהן חולקות את אותה סכמה, מארח ויציאה. מותר גם להשתמש במקורות משנה, ובתת-דומיינים עם תו כללי לחיפוש. למידע נוסף, קראו את המאמר אבטחת תוספים.
   • DARK_MODE_LOGO_URL: מחרוזת. כתובת URL ספציפית ללוגו של התוסף שמותאמת למצב כהה. אם תספקו לוגו למצב כהה, התוסף שלכם ייראה בצורה הטובה ביותר בכל עיצוב ב-Meet. הנחיות לעיצוב סמלי לוגו מפורטות בקטע שיטות מומלצות.
   • ‫MEET_WEB_LOGO_URL: אופציונלי. מחרוזת. כתובת URL ספציפית ל-Meet של הלוגו של התוסף. הלוגו הזה מופיע בכל רחבי Meet. אם הוא לא מופיע, המערכת משתמשת ב-logoUrl מהקטע המשותף. הנחיות לעיצוב סמלי לוגו מפורטות בקטע שיטות מומלצות.
   • ‫SUPPORTS_SCREENSHARING: אופציונלי. בוליאני. אם הערך מוגדר כ-false, המשתמשים יצטרכו להשתמש בתוסף כדי לראות מה קורה בסשן שיתופי של התוסף. אם ההגדרה מוגדרת כ-True, מי שיצר את הסשן של שיתוף הפעולה בתוסף יוכל לשתף את המסך ולאפשר לכל המשתתפים לראות את התצוגה שלו בתוסף.

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

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

5. בכרטיסייה App configuration (הגדרת האפליקציה), בקטע App integration (שילוב אפליקציות), בוחרים באפשרות Google Workspace Add-on (תוסף Google Workspace). בוחרים באפשרות Deploy using cloud deployment resource ובוחרים את פריסת ה-HTTP המתאימה.

Google Apps Script

1. לוחצים על הכרטיסייה App configuration.

2. בקטע שילוב אפליקציות, בוחרים באפשרות תוסף ל-Google Workspace. בוחרים באפשרות Deploy using Google Apps Script deployment ID ומזינים את מזהה הפריסה של הסקריפט.

3. לוחצים על שמירה.

   פרטים על יצירת פרויקט ב-Apps Script זמינים במסמכי העזרה של Apps Script. התוסף ל-Meet מסתמך אך ורק על קובץ המניפסט appsscript.json, שנקרא גם מניפסט הפרויקט ב-Apps Script. חשוב לוודא שקובץ המניפסט בפרויקט שלכם ב-Apps Script מכיל את הקטע addOns ואת הקטע meet. הקטעים addOns ו-meet פועלים לפי אותו מבנה שמתואר בכרטיסייה 'פריסה של HTTP'.

   בניגוד לתוספים אחרים של Google Workspace, אי אפשר ליצור תוספים ל-Meet רק ב-Apps Script. במקום זאת, צריך ליצור אפליקציית אינטרנט מלאה על ידי יצירת חלונית צדדית וסטטוס ראשי. לאחר מכן, צריך לציין את כתובת ה-URL של חלונית הצד של אפליקציית האינטרנט בקטע SIDE_PANEL_URI בקובץ המניפסט appsscript.json.

התקנה ובדיקה של התוסף ב-Meet

כדי לבדוק את התוסף ב-Meet, צריך קודם להתקין אותו עבור המשתמש שמחובר לחשבון:

פריסת HTTP

1. עוברים לממשק Google Workspace Marketplace SDK של הפרויקט במסוף Google Cloud.
2. לוחצים על הכרטיסייה פריסות HTTP.
3. לוחצים על התקנה בעמודה פעולות.

Google Apps Script

1. פועלים לפי ההוראות במסמכי העזרה של התוספים ל-Google Workspace כדי להתקין תוסף שלא פורסם.

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

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