אם כבר יצרתם ופרסמתם תוסף להרחבת Gmail או יומן Google, תוכלו לשדרג אותו לתוסף ל-Google Workspace. בהוראות שבדף הזה מוסבר איך להוסיף פונקציונליות של Google Workspace לתוספים הקיימים של Gmail או יומן Google, ואז לפרסם את התוסף המשודרג כדי שאפשר יהיה למצוא אותו ולהתקין אותו.
תוכלו להעביר את הפונקציונליות החדשה לתוסף המקורי כדי לשמור על דף המוצר, ההתקנות והמשתמשים ב-Google Workspace Marketplace. השדרוג מאפשר לכם גם ליהנות מתכונות חדשות של התוספים של Google Workspace, כמו דפי בית.
שלב 1: יוצרים עותק של פרויקט Apps Script של התוסף
התוסף המשודרג משתמש באותו פרויקט ב-Google Cloud שבו משתמש התוסף שפורסם, אבל חשוב ליצור עותק של פרויקט Apps Script הבסיסי ולהשתמש בו כדי שהמשתמשים הקיימים לא יושפעו בזמן הבדיקה של הגרסה המשודרגת. שדרוג של עותק של פרויקט הסקריפט המקורי גם מאפשר לכם תמיד לגשת לקוד המקורי, ולפרוס אותו מחדש מאוחר יותר אם צריך.
- פותחים את פרויקט Apps Script הקיים של התוסף ל-Gmail או של התוסף ל-Calendar לשיחות וידאו.
- בצד ימין, לוחצים על סקירה כללית .
- בצד שמאל, לוחצים על 'יצירת עותק' .
- בצד ימין, לוחצים על הגדרות הפרויקט > שינוי פרויקט.
- לוחצים על מספר פרויקט GCP.
- מזינים את אותו מספר פרויקט שמשויך לפרויקט Apps Script הקיים של התוסף שפורסם.
- לוחצים על Set project.
שלב 2: שילוב התוסף ל-Google Workspace
אתם צריכים לתכנן ולהטמיע את כל התכונות של התוסף ל-Google Workspace שתרצו להוסיף לתוסף שלכם.
- כדאי לתכנן איזה תוכן יוצג בכרטיסי דף הבית של התוסף, ואם הם יופיעו ב-Gmail, ביומן Google, ב-Drive או בכל שילוב של שלושת המארחים. אם אתם רוצים להציג דף בית ביותר מארח אחד, אתם צריכים להחליט אם זה יכול להיות אותו דף בית או אם אתם רוצים להציג כרטיסי דף בית מותאמים אישית לכל מארח.
- בפרויקט Apps Script של התוסף שהעתקתם, יוצרים את הכרטיסים של דף הבית באמצעות הפונקציות
homepageTrigger. חשוב לכלול את כל הפונקציות או הלוגיקה הנדרשות כדי לשלוט בממשקי דף הבית החדשים. כדאי להוסיף כרטיסי הקשר שמופעלים על ידי פעולה של משתמש, כמו פתיחת שרשור של הודעה ב-Gmail או אירוע ביומן Google.
צריך לעדכן את כל הגישה לאובייקטים של אירועים בתוסף (בפונקציות קריאה חוזרת של ווידג'טים או בפונקציות של טריגרים לפי הקשר) כך שתשתמש במבנה המעודכן של אובייקט האירוע. המבנה החדש עדיין מכיל את אותם שדות של אובייקט האירוע שבהם משתמשים התוספים של שיחות הווידאו ב-Gmail וביומן Google, אבל השדות המקוריים האלה הוצאו משימוש ויוסרו בסופו של דבר.
שלב 3: מעדכנים את המניפסט של התוסף
האופן שבו פרטי ההגדרה מאוחסנים במבנה המניפסט של התוספים ל-Google Workspace השתנה באופן משמעותי מהמבנה שבו נעשה שימוש בתוספים ל-Gmail ובתוספים לישיבות ביומן. כשמשדרגים את התוסף, צריך לעדכן את שדות המניפסט של פרויקט Apps Script של התוסף בהתאם לטבלאות שבהמשך. עליכם לעדכן את כל נכסי המשנה הרלוונטיים לנכס addOns החדש.
חשוב גם לעדכן את השדה oauthScopes במניפסט לפי הצורך, כך שישקף את ההרשאות הנדרשות לתוסף המעודכן.
מידע נוסף על מניפסט של תוסף Google Workspace זמין במאמר מניפסטים.
תוספים ל-Gmail
| שדה המניפסט המקורי | נדרשת פעולה |
|---|---|
gmail.composeTrigger |
עוברים אל addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
מעבירים את הרשימה אל addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
עוברים אל addOns.common.logoUrl. |
gmail.name |
עוברים אל addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
מעבירים את הרשימה אל addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
עוברים אל addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
עוברים אל addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
מעבירים את הרשימה אל addOns.common.universalActions[]. |
gmail.universalActions[].text |
מעבירים כל שדה gmail.universalActions[].text לשדה addOns.common.universalActions[].label תואם. |
gmail.useLocalFromApp |
עוברים אל addOns.common.useLocaleFromApp. |
תוספים של שיחות ועידה ביומן Google
| שדה המניפסט המקורי | נדרשת פעולה |
|---|---|
calendar.createSettingsUrlFunction |
עוברים אל addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
עוברים אל addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
עוברים אל addOns.common.logoUrl. |
calendar.name |
עוברים אל addOns.common.name. |
שלב 4: בדיקת התוסף המשודרג
במאמר בדיקת תוספים של Google Workspace מוסבר איך לבדוק את התוסף המשודרג לפני הפרסום.
שלב 5: מבקשים ביקורות על התוסף המשודרג
כל התוספים ל-Google Workspace, בין אם מדובר בתוסף משודרג ובין אם מדובר בתוסף שנוצר מאפס, צריכים לקבל אישור לפני שאפשר יהיה להציג אותם ב-Google Workspace Marketplace.
כדי לשלוח את התוסף לבדיקה:
חשוב לוודא שהתוסף עומד בכל הדרישות לפרסום תוספים.
יוצרים פריסה עם גרסה של התוסף ל-Google Workspace (בפרויקט החדש של Apps Script) באמצעות גרסת הקוד שרוצים לפרסם. אל תנסה לפרסם באמצעות פריסה של ראשית (head).
אם הוספתם היקפי הרשאות חדשים במהלך השדרוג של התוסף, עליכם לבקש אימות OAuth. לדוגמה, אם התוסף ל-Gmail משתמש בהיקפי גישה חדשים של Drive או של יומן Google בגרסה של התוסף ל-Google Workspace, צריך לשלוח את ההיקפים החדשים האלה לאימות. תהליך האימות בדרך כלל נמשך כמה ימים, לכן מומלץ להתחיל את התהליך מוקדם ככל האפשר. לפני שממשיכים לשלב 6, צריך לוודא שהתוסף מאומת.
שלב 6: הופכים את התוסף המשודרג לזמין
פותחים את Google Workspace Marketplace SDK.
בצד ימין, לוחצים על הגדרה. בחלונית הזו מופיע טופס שבו מזינים מידע על התוסף.
מעדכנים את התיאור הקצר, התיאור המפורט ותמונות המסך של דף המוצר כך שישקפו את הפונקציונליות החדשה של התוסף ל-Google Workspace.
בקטע תוספים, לוחצים על הלחצן שדרוג לתוסף של Google Workspace. בתיבת הטקסט שמופיעה, מזינים את מזהה הפריסה החדש שיצרתם לתוסף של Google Workspace בשלב הקודם. אם מזהה הפריסה תקין, תוצג רשימה של המארחים הנתמכים.
אם הוספתם היקפי הרשאות חדשים לתוסף ל-Google Workspace, הקפידו להוסיף אותם לקטע היקפי הרשאות OAuth 2.0 בדף הגדרה. ההיקפים שמפורטים בקטע הזה צריכים להתאים במדויק להיקפים שמפורטים במניפסט של התוסף.
מוודאים שהפרטים שהזנתם בטופס נכונים. לאחר מכן לוחצים על שמירת השינויים.
אם יש לכם שאלות או נתקלתם בבעיה במהלך תהליך השדרוג של התוספים ל-Google Workspace, צרו איתנו קשר.
שאלות נפוצות
ריכזנו כאן כמה שאלות נפוצות לגבי שדרוגי חבילות שירות:
האם אפשר לשדרג את תוסף העריכה?
אפשר להעביר את רוב התוספים ל-Editor לתוספים של Google Workspace. עם זאת, אי אפשר לשדרג אותם לתוספים של Google Workspace בקלות כמו תוספים ל-Gmail וליומן Google.
אם רוצים להעביר את התוסף ל-Editor לתוסף ל-Google Workspace, צריך לכתוב מחדש את ממשק המשתמש של התוסף מ-HTML לממשק שמבוסס על כרטיסים, ולעדכן את הטיפול ב-JavaScript ל-Card Service.
יכול להיות שחלק מהשירותים בתוסף הקיים של ה-Editor לא יהיו זמינים בשירות הכרטיסים. לדוגמה, אם התוסף של ה-Editor כולל בורר קבצים, אין בורר מקביל שזמין בשירות הכרטיסים להרחבות של Google Workspace.
האם אפשר ליצור תוסף נפרד ל-Google Workspace ולשמור על התוסף הקיים?
מותר לכם ליצור תוספים נוספים ל-Google Workspace בשמות מותג שונים, אבל אנחנו לא מאפשרים ליצור תוספים נפרדים לשיחות ועידה ב-Gmail או ביומן Google בשם המותג של התוסף ל-Google Workspace. אם יש לכם שאלות או שאתם רוצים לבקש חריגה, צרו איתנו קשר.
האם המשתמשים יצטרכו להעניק הרשאה מחדש לתוסף אחרי השדרוג?
כל עוד התוסף ל-Google Workspace משתמש באותו פרויקט Cloud Platform (GCP) עם מזהה לקוח OAuth משויך, המשתמשים לא יצטרכו להעניק הרשאות מחדש שהם העניקו בעבר לתוסף המקורי. עם זאת, אם תוסיפו היקפי גישה חדשים במהלך תהליך השדרוג, המשתמשים יצטרכו לאשר את ההיקפים החדשים בפעם הראשונה שהם ישתמשו בגרסה של התוסף ל-Google Workspace.
האם אפשר לשדרג את התוסף ל-Chrome לתוסף של Google Workspace ולהעביר משתמשים?
לא. אי אפשר להעביר את המשתמשים, ההתקנות והביקורות על דף המוצר של תוסף ל-Chrome. עליכם ליצור תוסף חדש ל-Google Workspace ולהפנות את המשתמשים בתוסף ל-Chrome אל Google Workspace Marketplace.
האם אפשר לצרף כמה תוספים לתוסף של Google Workspace?
הצגת שילובי האפליקציות יחד ברשימה