המשתמשים צריכים להתקין את התוסף ולאשר אותו כדי שיוכלו לפתוח אותו ולהשתמש בו. מאחר שהשלבים האלה הם החלק הראשון וחוויית המשתמש של התוסף, עליכם להבין אותם. לפני שמתחילים ליצור תוספים משלכם.
בקטע הזה במסמכי העזרה מוסבר איך משתמשים יכולים להתקין תוספים, להעניק להם הרשאה ולהתחיל להשתמש בהם.
איך מתקינים תוספים
לפני שמשתמשים בתוסף, צריך להתקין אותו. אחרי ההתקנה, התוסף יהיה זמין באפליקציית המארח של Google Workspace שהוא מרחיב.
אפשר להתקין תוספים שפורסמו דרך באפליקציה לאירוח ב-Google Workspace או Google Workspace Marketplace אדמינים של דומיינים יכולים גם להתקין תוספים בשם המשתמשים שלהם מ-Google Workspace Marketplace. אתם יכולים גם להתקין תוספים שלא פורסמו שאתם מפתחים כדי לבדוק אותם. כדי להשתמש בפעם הראשונה בתוסף שהותקן, צריך לספק לו הרשאה.
פרטים נוספים זמינים במאמר פרסום תוספים.
איך מאשרים תוספים
אחרי שמתקינים תוסף, הוא זמין באפליקציית המארח של Google Workspace שהוא מרחיב. בפעם הראשונה שמשתמש מנסה להשתמש בתוסף, מוצגת לו באפליקציית המארח כרטיס הרשאה או תיבת דו-שיח. בכרטיס הזה מוסבר מה התוסף צריך לעשות בשביל המשתמש, למשל גישה לתוכן של גיליון האלקטרוני הנוכחי ב-Google Sheets. לאחר מכן המשתמש יכול להעניק את הפרטים האלה ולאפשר לתוסף להמשיך. אם המשתמש ידחה את הרשאת התוסף, הוא לא יוכל להשתמש בו.
בתוספים ל-Editor נעשה שימוש במודל הרשאה שונה מזה של תוספים ל-Google Workspace. תוספי Editor פועלים על קבצים ב-Google Drive, את מודל ההרשאה של העורך מגדיר מצבי הרשאה שונים שנוצרים כאשר תוספים משמשים לקבצים בודדים. כשמפתחים תוספים ל-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 יכולים גם להוסיף פתרונות נוספים לשיחות ועידה שמאפשרים למשתמשים לבחור מערכת צד שלישי לשיחות ועידה כשהם עורכים אירועים ביומן Google. אם התוסף מספק אפשרויות של כנסים שמחייבות את המשתמש להתחבר אליהם, התוסף חייב לתת למשתמש את היכולת לעשות זאת.
אם משתמש כלשהו מנסה ליצור שיחת ועידה עם התוסף בלי צורך בכך
להיכנס לחשבון, השיטה onCreateFunction
של הפתרונות לשיחות ועידה.
צריך להחזיר
ConferenceData
אובייקט שמכיל
ConferenceError
עם
כתובת URL לאימות.
אחרי קבלת האובייקט, יומן Google יוצר לחצן LOG IN ב- ממשק המשתמש של עריכת האירועים שמקשר לכתובת ה-URL לאימות שהתוסף מספק. המשתמשים יכולים להשתמש בלחצן הזה כדי להתחבר למערכת של הצד השלישי לפני באמצעות התוסף.
יצירת שיחות ועידה עם צד שלישי
לפרטים נוספים על הרשאת טיפול באמצעות ConferenceError
.
אישור תוספי עריכה שלא פורסמו
מומלץ לבדוק תוספי עריכה בזמן הפיתוח שלהם. תהליך ההרשאה זהה לתהליך של תוספים שפורסמו ל-Editor, מלבד העובדה שהוא מתחיל בפעם הראשונה שמנסים לבדוק את התוסף. אם תבדקו שוב את אותו תוסף מאוחר יותר, לא תתבקשו לאשר אותו שוב.
ביטול האישור של תוספים
כשאתם מפתחים תוספים, כדאי לבטל את האישור שלהם כדי שתוכלו לבדוק שוב. את זרימת ההרשאה.
כך מבטלים אישור של תוסף:
- פותחים את מסוף אבטחת החשבון.
- מאתרים את התוסף שרוצים לבטל את הגישה שלו ולוחצים עליו.
- לוחצים על הסרת הגישה.
כשתפעילו שוב את התוסף אחרי שתבטלו את האישור שלו, תהליך ההרשאה יופיע תוצג שוב.
איך מסירים תוספים
כדי להסיר התקנה של תוסף שהתקנתם, ב-Google Workspace Marketplace ניתן לעיין במאמר איך מסירים אפליקציה או תוסף מ-Marketplace
כדי להסיר תוסף מובנה שלא פורסם Apps Script, ניתן לעיין במאמר איך מסירים תוכן שלא פורסם .