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

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

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

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

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

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

כדי לפתח את Google Workspace Marketplace SDK ואת Google Workspace Add-ons API תוספים של Meet. כדי להפעיל אותן:

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 של Google.
2. בחלק העליון, אם פרויקט אחר כבר פתוח, בוחרים את שם הפרויקט של האפליקציה כדי לעבור לפרויקט אחר.
3. לוחצים על APIs & שירותים.
4. בוחרים באפשרות Google Workspace Marketplace SDK כדי להציג את דף הפרטים.

יצירת הפריסה

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

פריסת HTTP

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

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

   מזהה הפריסה הוא מחרוזת שרירותית שעוזר למפתח התוסף לזהות את הפריסה שמכילה את המניפסט של התוסף. 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 החלונית הצדדית. הערך origin בכתובת ה-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). יש לבחור באחת מהאפשרויות הבאות לפרוס באמצעות משאב פריסה בענן ואז לבחור את האפשרות המתאימה פריסת HTTP.

Google Apps Script

1. לוחצים על הכרטיסייה הגדרת אפליקציה.

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

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 Cloud עוברים ל-Google Workspace Marketplace SDK של הפרויקט.
2. לוחצים על הכרטיסייה פריסות HTTP.
3. לוחצים על התקנה בעמודה פעולות.

Google Apps Script

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

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

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