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

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

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

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

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

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

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

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

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

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

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

הדרך הכי קלה להתחיל לכתוב קוד לקריאה לממשקי Google Workspace API היא לפעול לפי המדריך למתחילים בנושא 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.

יצירת פרויקט Google Cloud לצורך הכנה לבדיקה

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

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

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

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

כתיבת בדיקות

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

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

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

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

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

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

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

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

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

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

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

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

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

חשוב להשתמש בשקיפות.

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

חשוב לוודא שהלוגו (ונכסים גרפיים אחרים) נראים טוב במצב ניגודיות גבוהה. לשם כך, אפשר להשתמש בכלי לבדיקת ניגודיות כמו Contrast Checker של Web Accessibility In Mind (WebAIM).

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

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