המשתמשים צריכים להתקין תוסף ולאשר אותו לפני שהם יוכלו לפתוח אותו ולהשתמש בו. מכיוון שהשלבים האלה הם החלק הראשון בחוויית המשתמש של התוסף, חשוב להבין אותם לפני שמתחילים ליצור תוספים.
המאמר הזה מתאר איך משתמשים יכולים להתקין תוספים, לאשר אותם ולהתחיל להשתמש בהם.
איך מתקינים תוספים
לפני שמשתמשים בתוסף, צריך להתקין אותו. אחרי ההתקנה, התוסף הופך לזמין באפליקציה המארחת של Google Workspace שהיא תקפה.
אפשר להתקין תוספים שפורסמו מהאפליקציה המארחת של Google Workspace או מ-Google Workspace Marketplace. מנהלי דומיינים יכולים גם להתקין תוספים בשם המשתמשים שלהם מ-Google Workspace Marketplace. אתם יכולים גם להתקין תוספים שלא פורסמו שאתם מפתחים, כדי שתוכלו לבדוק אותם. כדי להשתמש בתוסף מותקן בפעם הראשונה, צריך לאשר אותו.
מידע נוסף זמין במאמר פרסום תוספים.
מתן הרשאה לתוספים
אחרי שמתקינים תוסף, הוא זמין באפליקציה המארחת של Google Workspace. בפעם הראשונה שהמשתמש מנסה להשתמש בתוסף, האפליקציה המארחת מציגה לו כרטיס הרשאה או תיבת דו-שיח. בכרטיס הזה מוסבר מה התוסף צריך הרשאה לעשות עבור המשתמש, למשל גישה לתוכן של הגיליון הנוכחי ב-Google Sheets. המשתמש יכול לתת את ההרשאות האלה ולאפשר לתוסף להמשיך. אם המשתמש דוחה את ההרשאה לתוסף, הוא לא יכול להשתמש בתוסף.
לתוספי עריכה נעשה שימוש במודל הרשאה שונה מהתוספים של Google Workspace. מכיוון שתוספי עריכה פועלים בקבצים ב-Google Drive, מודל ההרשאות של Editor מגדיר מצבי הרשאה שונים שנוצרים כשמשתמשים בתוספים בקבצים ספציפיים. כשמפתחים תוספי עריכה, חשוב להבין את המצבים השונים ואיך התוסף עובר ביניהם.
אישור תוספים שפורסמו
אחרי שמתקינים תוסף שפורסם, תהליך ההרשאה מתחיל מיד:
- תתבקשו לבחור חשבון כדי להתקין את התוסף.
- אחרי כן מופיעה רשימת ההרשאות שהתוסף צריך לפעול, כדי שתדעו מה הוא מנסה לעשות. בודקים היטב את הרשימה, ואם עדיין רוצים להעניק הרשאה, לוחצים על Allow. כך התוסף יוכל להשתמש בו.
- עכשיו אפשר להריץ אותו מהאפליקציה המארחת שהיא מורחבת. אם האפליקציה כבר פתוחה בכרטיסייה בדפדפן, יכול להיות שתצטרכו לרענן את הכרטיסייה כדי שהתוסף יהיה זמין.
אם התוסף שהתקנתם יעודכן מאוחר יותר ויצריך הרשאות נוספות שעדיין לא נתתם, תתבקשו לספק את ההרשאות האלה בפעם הבאה שתשתמשו בו.
אישור תוספים ל-Google Workspace שהפרסום שלהם בוטל
לתוספים שכבר לא פורסמו אין אותו תהליך הרשאה כמו לתוספים שפורסמו, כי הם עדיין לא רשומים ב-Google Workspace Marketplace. אחרי שמתקינים תוסף שלא פורסם, לא מתבקשים לעשות זאת מיד. במקום זאת, תהליך ההרשאה מתחיל כשמנסים להשתמש בתוסף בפעם הראשונה.
כשתוסף מופעל, הוא קובע אם יש צורך בהרשאת משתמש. אם צריך הרשאה, התוסף יציג כרטיס הרשאה. תמיד צריך לקבל הרשאה בפעם הראשונה שתוסף מופעל, ויכול להיות שתידרש הרשאה גם אם גרסה חדשה של התוסף משתמשת בשירות שלא אושר בעבר. הלחצן Authorize Access מציג חלון דו-שיח שבו המשתמשים יכולים לאשר או לדחות את ההרשאה של התוסף.
מתן הרשאה לשירותים שאינם של Google עבור תוסף של Google Workspace
יכול להיות שתוסף ל-Google Workspace יכול להתחבר לשירות צד שלישי שבעצמו צריך הרשאה. לתוספים ל-Google Workspace שמתחברים לשירותים כאלה נדרשים שתי פעולות נפרדות מהמשתמש:
- הרשאה לתוסף עצמו כשהתוסף מותקן או מופעל בפעם הראשונה.
- הרשאה לשירות שאינו של Google כשניגשים אליו בפעם הראשונה.
אם תוסף ל-Google Workspace שאתם מפתחים צריך לגשת לשירות שאינו של Google באמצעות OAuth, צריך להגדיר את החיבור לשירות הזה בזמן פיתוח התוסף.
מידע נוסף זמין במאמר חיבור תוסף Google Workspace לשירות צד שלישי.
מערכות לשיחות ועידה של צדדים שלישיים
תוספים ל-Google Workspace שמרחיבים את יומן Google יכולים להוסיף עוד פתרונות לשיחות ועידה שמאפשרים למשתמשים לבחור מערכת של צד שלישי לשיחות ועידה בזמן עריכת אירועים ביומן Google. אם התוסף מספק אפשרויות לשיחות ועידה שמחייבות את המשתמש להתחבר אליהן, התוסף צריך לאפשר למשתמש לעשות זאת.
אם משתמש מנסה ליצור שיחת ועידה עם התוסף בלי להיכנס לחשבון, ה-method onCreateFunction של פתרון שיחת הוועידה אמור להחזיר אובייקט ConferenceData שמכיל ConferenceError עם כתובת URL לאימות.
אחרי קבלת האובייקט, יומן Google יוצר לחצן LOG IN בממשק המשתמש של עריכת האירועים שמקשר לכתובת ה-URL לאימות שהתוסף מספק. הלחצן הזה מאפשר למשתמשים להתחבר למערכת של הצד השלישי לפני שהם ממשיכים להשתמש בתוסף.
לפרטים נוספים על הטיפול בהרשאות באמצעות ConferenceError, ראו יצירת שיחות ועידה עם צד שלישי.
אישור תוספי עריכה שלא פורסמו
מומלץ לבדוק תוספי עריכה תוך כדי פיתוח. תהליך ההרשאה זהה לזה של תוספים שפורסמו בעורך, אבל התהליך מתחיל כשמנסים לבדוק בפעם הראשונה את התוסף. אם בהמשך תבדקו מחדש את אותו התוסף, לא תוצג לכם שוב בקשה להרשאה.
ביטול האישור לתוספים
כשאתם מפתחים תוספים, כדאי לבטל את ההרשאה שלהם כדי לבדוק מחדש את תהליך ההרשאה.
כך מבטלים אישור של תוסף:
- פותחים את מסוף אבטחת החשבון.
- מאתרים את התוסף שרוצים לבטל את הגישה שלו ולוחצים עליו.
- לוחצים על הסרת גישה.
כשתפעילו שוב את התוסף אחרי שתבטלו את האישור שלו, תהליך ההרשאה יוצג שוב.