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

כדי לשפר את חוויית השימוש הכוללת של המשתמשים, כדאי לפעול לפי ההנחיות הבאות לעיצוב תוספים ל-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.

שימוש בגרסה האחרונה של Google Meet Add-ons SDK

ערכת ה-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.

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

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