שדרוג תוספים מדור קודם ל-Gmail וליומן Google

הערה: בשלב הזה אין אפשרות לשדרג תוספים של 'עריכה' ישירות לתוספים של Google Workspace. מידע נוסף זמין במאמר האם אפשר לשדרג את תוסף העריכה.

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

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

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

שלב 1: יצירת עותק של פרויקט Apps Script של התוסף

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

1. איך פותחים תוסף קיים ל-Gmail או תוסף לשיחות ועידה ביומן Google ב-Apps Script פרויקט.
2. בצד ימין, לוחצים על סקירה כללית. .
3. בצד שמאל, לוחצים על הסמל 'יצירת עותק' .
4. בצד ימין, לוחצים על הגדרות הפרויקט > שינוי הפרויקט.
5. לוחצים על GCP Project Number.
6. הזינו את ההגדרה הזו מספר הפרויקט שמשויך לפרויקט Apps Script הקיים שלך, שפורסם.
7. לוחצים על Set project (הגדרת פרויקט).

אזהרה: אין לשדרג פרויקט Apps Script של תוסף ציבורי באופן ישיר. צריך כדי ליצור עותק ולשמור את הגרסה המשודרגת בנפרד מהגרסה הציבורית בזמן תהליך הבנייה והבדיקה.

שלב 2: משלבים את התוסף של Google Workspace

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

1. תכנון התוכן שיוצג בתוסף כרטיסים בדף הבית והאם הם יופיעו ב-Gmail, ביומן, ב-Drive או בכל שילוב של השלושה המארחים. אם רוצים דף בית ביותר ממארח אחד, צריך להחליט אם הוא יכול להיות אותו דף בית, או אם אתם רוצים כרטיסים מותאמים אישית של דף הבית לכל מארח.
2. בפרויקט Apps Script של התוסף שהעתקתם, יוצרים את דף הבית כרטיסים עם homepageTrigger למשימות ספציפיות. חשוב לכלול פונקציות או לוגיקה תומכות שנדרשות כדי לשלוט בממשקים החדשים של דף הבית.

3. כדאי להוסיף כרטיסים לפי הקשר שהופעלו על ידי פעולה של משתמש, כמו פתיחת שרשור הודעות ב-Gmail או אירוע ביומן.

   זהירות: תוספים משודרגים מקבלים ערך מזהה שונה בהודעות Gmail ממה שהתוספים ל-Gmail מקבלים. השינוי הזה משפיע רק על תוספים משודרגים להשתמש ב-messageId כמפתח בכל אחסון קבוע. במקרה הצורך, עדיין אפשר מקבלים את ערכי המזהה הישנים באמצעות ה-API של Gmail. ממשק ה-API של Gmail אמצעי תשלום messages().get() מקבלת גם את ערכי המזהה החדשים וגם את ערכי המזהה הישנים, אבל מחזירה רק את ערכי המזהה הישנים.

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

שלב 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.

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

שדה המניפסט המקורי	נדרשת פעולה
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.

כדי לשלוח את התוסף לבדיקה:

1. צריך לוודא שהתוסף עומד בכל דרישות פרסום של תוספים.

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

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

שלב 6: הגדרת התוסף המשודרג כזמין

1. פותחים את Google Workspace Marketplace SDK.

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

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

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

   זהירות: שדרוג התוסף ל-Google Workspace בדרך הזו הוא חד-פעמי אי אפשר לבטל את הפעולה הזו.

5. אם הוספתם היקפי הרשאות חדשים לתוסף Google Workspace, חשוב להוסיף אותם אל בקטע היקפים של OAuth 2.0 בדף הגדרה. ההיקפים שצוינו בסעיף הזה צריכים להיות זהים להיקפים שמופיעים .

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

אם יש לך שאלות או שנתקלת בבעיה במהלך השדרוג של התוסף ל-Google Workspace צרו איתנו קשר.

שאלות נפוצות

שאלות נפוצות לגבי שדרוגים של תוספים:

האם אפשר לשדרג את תוסף Editor?

את רוב התוספים של Editor אפשר להעביר לתוספים של Google Workspace. עם זאת, הם לא יכולים ישודרגו לתוספים של Google Workspace בקלות כמו תוספים ל-Gmail יומן.

כדי להעביר את תוסף Editor לתוסף של Google Workspace, צריך: לשכתב את ממשק המשתמש של התוסף מ-HTML לפורמט מבוסס-כרטיס הממשק ולעדכן את ה-JavaScript בשירות הכרטיס.

יכול להיות ששירותים מסוימים בתוסף 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?

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