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