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