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

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

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

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

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

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

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

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

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

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

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

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

שדה המניפסט המקורי נדרשת פעולה
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 או ל-Calendar בגרסה של התוסף ל-Google Workspace, אתם צריכים לשלוח את היקפי הגישה החדשים האלה לאימות. תהליך האימות לרוב נמשך כמה ימים, לכן מומלץ להתחיל אותו מוקדם ככל האפשר. לפני שממשיכים לשלב 6, צריך לוודא שהתוסף מאומת.

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

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

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

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

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

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

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

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

שאלות נפוצות

ריכזנו כאן תשובות לשאלות נפוצות בנושא שדרוגים של חבילות ערוצים:

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

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

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

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

האם אפשר ליצור תוסף נפרד ל-Google Workspace ולשמור את התוסף הקיים?

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

האם המשתמשים שלי יצטרכו לאשר מחדש את התוסף אחרי השדרוג?

כל עוד התוסף שלכם ל-Google Workspace משתמש באותו פרויקט ב-Cloud Platform ‏ (GCP), עם מזהה לקוח OAuth משויך, המשתמשים לא יצטרכו לאשר מחדש את ההרשאות שהם אישרו בעבר לתוסף המקורי. עם זאת, אם תוסיפו היקפי גישה חדשים במהלך תהליך השדרוג, המשתמשים יצטרכו לאשר את היקפי הגישה החדשים בפעם הראשונה שבה הם ישתמשו בגרסת Google Workspace של התוסף.

האם אפשר לשדרג את תוסף Chrome לתוסף Google Workspace ולהעביר משתמשים?

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

אפשר לצרף כמה תוספים לתוסף Google Workspace?

איך רואים את כל שילובי האפליקציות