שיטות מומלצות

כדי לשפר את חוויית השימוש הכוללת של המשתמשים, כדאי לפעול לפי ההנחיות הבאות לעיצוב תוספים ל-Google Meet.

שיטות מומלצות להרשאה

מומלץ להשתמש בשיטות המומלצות הבאות בכל תוסף ל-Google Meet שדורש אימות או הרשאה.

כניסה באמצעות חשבון Google

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

פתיחת דף הכניסה של הצד השלישי בחלון חדש

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

שליחת בקשות נכונות להיקפי הרשאות ל-Google APIs

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

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

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

שיטות מומלצות לתחזוקה

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

שימוש בגרסה האחרונה של ה-SDK של התוספים ל-Google Meet

ערכת ה-SDK של התוספים ל-Meet מתעדכנת באופן קבוע. ערכת ה-SDK פועלת בהתאם לשיטת ניהול גרסאות סמנטית. כדי למצוא את הגרסה העדכנית ביותר:

  • כשמשתמשים ב-gstatic: גרסת ה-SDK העדכנית ביותר נכללת בכתובת ה-URL של gstatic שמופיעה בהוראות לשימוש ב-SDK.
  • כשמשתמשים ב-npm: מריצים את npm update @googleworkspace/meet-add-ons מהספרייה שמכילה את package.json של האתר שמארח את התוסף ל-Meet.

יצירת פרויקט ת staging ב-Google Cloud

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

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

כדי ליצור את הסביבות החלופיות האלה לתוסף, קודם צריך לארח סביבות חלופיות של אפליקציית האינטרנט שמכילה את התוסף, בדומיין שבבעלותכם. לאחר מכן תוכלו ליצור סביבות חלופיות לתוסף של Meet על ידי הוספת פריסות נוספות לפרויקט שלכם ב-Google Cloud. לפריסות החדשות האלה צריכים להיות מניפסטים שמפנים לסביבות החלופיות של אפליקציית האינטרנט. לאחר מכן, מומלץ להתקין כל סביבה של תוסף באופן הבא:

  • גרסת ייצור: מפרסמים את גרסת הייצור באופן פרטי כדי שכל מי שבארגון יוכל לעזור בבדיקות.
  • גרסת פיתוח: לוחצים על התקנה בעמודה פעולות כדי להתקין את גרסת הפיתוח של התוסף ל-Meet רק בחשבון שלכם.

כתיבת בדיקות

לפני הפריסה של התוסף ל-Meet בסביבת פיתוח, מומלץ לכתוב בדיקות יחידה. בדיקות היחידה צריכות לכלול:

  • יוצרים גרסת מוקה (mock) של ה-SDK של התוספים ל-Meet, ולאחר מכן מוודאים שהתוסף ל-Meet קורא לפונקציות ה-SDK כצפוי.
  • בדיקת יחידה של כל הפונקציונליות של התוסף שלא קשורה ל-SDK באמצעות מסגרת הבדיקה המועדפת שלכם לאתרים.

שיטות מומלצות לשיפור חוויית המשתמש

השיטות המומלצות הבאות יעזרו לכם ליצור תוסף ל-Meet אינטואיטיבי ומעודן יותר.

ניהול כל המצבים ההתחלתיים בחלונית הצדדית

מומלץ מאוד להגדיר את התוסף על סמך הפעולות שמשתמשים מבצעים בחלונית הצדדית. כדי לעשות זאת, צריך להגדיר את מצב ההתחלה של הפעילות ב-JavaScript. כל הנתונים שמוזנים ב-ActivityStartingState צריכים להיות מוגדרים על ידי מי שיצר את התוסף (בדרך כלל מארח הפגישה) בחלונית הצדדית. אפשר לחשוב על התצוגה הראשונה של החלונית הצדדית כטופס שמאפשר לקבוע את ההגדרות של התוסף.

סגירת החלונית הצדדית כשלא משתמשים בה

אחרי שמפעילים את הפעילות באמצעות הקריאה ל-method‏ startActivity(), צריך להשאיר את החלונית הצדדית פתוחה רק אם היא חלק חיוני מחוויית המשתמש של התוסף ל-Google Meet. אפשר לסגור את החלונית הצדדית אחרי שהשלב הראשי פתוח, על ידי קריאה ל-method‏ unloadSidePanel().

קידום התוסף שלכם ל-Meet באמצעות שיתוף מסך

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

הנחיות לעיצוב סמלי לוגו

כדי שהלוגו יהיה הכי יפה עכשיו ובעתיד, כדאי לפעול לפי ההנחיות הבאות:

מומלץ להשתמש בפורמט קובץ PNG בגודל 256px x 256px.

כדאי להשתמש בשקיפות.

מומלץ לוודא שהלוגו במצב כהה נראה טוב במצב כהה באמצעות כלים למפתחים של התוספים ל-Meet.

פועלים בהתאם לדרישות הגרפיקה לשילובים ספציפיים של אפליקציות.

אין לכלול תמונה עם רווחים פנימיים. במקום זאת, כדאי להרחיב את התמונה עד לגבולות הקובץ.