תהליך בדיקת האפליקציות והדרישות ל-Google Workspace Marketplace

• הלחצנים ליצירת קשר עם האפליקציה זמינים בתיאור.
• שם האפליקציה מתחיל באות A עד Z (אותיות רישיות) או בספרות 0 עד 9. השם לא יכול להתחיל בסמל.

• האפליקציה שולחת הודעת פתיחה באופן אוטומטי בכל פעם שמשתמש מתחיל צ'אט אישי או שהאפליקציה מתווספת למרחב משותף. הודעת הפתיחה שונה מהפקודה 'עזרה'. מידע נוסף זמין במאמר יצירת דף בית לאפליקציית Google Chat.
• האפליקציה תומכת בפקודה 'עזרה' ומסייעת למשתמשים להתחיל להשתמש באפליקציה. מידע נוסף זמין במאמר מענה לפקודות קו נטוי כאפליקציה ב-Google Chat.
• האפליקציה תמיד מגיבה כשמדברים אליה במרחב משותף או בצ'אט אישי.
• ההודעות מכילות איות, אותיות רישיות, פיסוק ודקדוק נכונים. ההודעות לא מכילות תוכן זדוני, פוגעני או פוגע.
• ההודעות כוללות עיצוב ברור, תמציתי ועקבי של טקסט או כרטיסים, בהתאם לדרישות של Google.
• אם התגובה נשלחת באיחור של יותר משתי שניות, האפליקציה שולחת הודעה עם הסבר על העיכוב.
• אפליקציות ששולחות התראות מאפשרות למשתמשים להשבית את ההתראות.
• משתמשים יכולים להוסיף את האפליקציה למרחב משותף באמצעות הוספת @.
• משתמשים יכולים להסיר את האפליקציה מהמרחב המשותף באמצעות התפריט הצגת רשימת המשתתפים.
• האפליקציה מציינת למשתמש את כל מה שדרוש כדי לבצע איתה פעולות.
• הפורמט של הכרטיסים שבו האפליקציה משתמשת עומד בדרישות של Google. שליחת הודעה באמצעות Google Chat API
• האפליקציה זמינה באפשרות חיפוש אפליקציות בתפריט של Chat.
• כתובות URL חיצוניות שהאפליקציה יוצרת איתן אינטראקציה לא שייכות לסביבת staging או לסביבת פיתוח.
• חובה להוסיף את האזכור באמצעות @לכל הודעה שאתם שולחים לאפליקציה במרחבים משותפים. זו הדרך היחידה שבה האפליקציה יודעת שהיא צריכה להגיב.
• אם באפליקציית Chat מוצגות תצוגות מקדימות של קישורים מדומיין של צד שלישי:
  • תצוגות מקדימות של קישורים מספקות מידע נוסף ורלוונטי להודעה של המשתמש. לדוגמה, כשמציגים תצוגה מקדימה של קישור לעסקה, מתווספים פרטים כמו חשבון, סכום ושלב.
  • המפתח משויך לדומיין שמוצג בתצוגה המקדימה.

  מידע נוסף זמין במאמר תצוגה מקדימה של קישורים.

• (מומלץ) כדי לאפשר לאדמינים ב-Workspace להתקין את האפליקציה בשם המשתמשים בארגון שלהם, האפליקציה צריכה להיות מסוגלת לשלוח ולקבל הודעות בצ'אטים אישיים.

• לאפליקציה יש דמות ייחודית וברורה.

• האפליקציה לא משתמשת בתוספים לדפדפן Chrome כדי לספק פונקציונליות על ידי מניפולציה ישירה ב-HTML של Drive.
• אם האפליקציה שלכם משתמשת בהיקפים רגישים או מוגבלים, היא צריכה לעבור אימות OAuth. שליחת האפליקציה לאימות
• אם האפליקציה שלכם משתמשת בהיקפים מוגבלים, היא חייבת לעבור גם בדיקת אבטחה. הערכת אבטחה

• אם האפליקציה שומרת קבצים ב-Drive, היא מאפשרת למשתמשים לבחור תיקייה או ליצור תיקייה ייעודית לאפליקציה ולעשות בה שימוש חוזר. אפשר לאחסן את נתוני ההגדרה בתיקיית נתוני האפליקציה. האפליקציה לא מעבירה קבצים לתיקייה'האחסון שלי' של המשתמש.
• האפליקציה שומרת ב-Drive רק קבצים שקשורים לפונקציות המפורטות של האפליקציה.

• התוסף כולל את הפעולות הצפויות והנדרשות, ומספק את כל הכלים הנדרשים כדי להשלים את תהליך העבודה שלו. לדוגמה:
  • אם התוסף מחיל עיצוב על כל המסמך, תוצג אפשרות להחיל את העיצוב רק על הטקסט שנבחר.
  • אם התוסף מעלה נתונים מגיליון אלקטרוני אל פיד של שירות אינטרנט, הוא כולל קישור אל הפיד הזה לניווט קל.
  • אם התוסף מחייב את המשתמש ליצור חשבון, הוא צריך לספק קישורים או מידע שיעזרו לו ליצור חשבון בקלות, אם עדיין אין לו חשבון.
• לתוסף יש אפשרויות תפריט בכרטיסייה תוספים.
• גם אם התוסף כולל רק פונקציות בהתאמה אישית, הוא עדיין צריך לכלול תיעוד מתאים.
• התוסף משתמש ב-onInstall() וב-onOpen() בצורה נכונה כדי לאכלס את התפריט שלו. הפריטים בתפריט מאוכלסים כשמתקינים את התוסף בפעם הראשונה וכשמפתחים קובץ אחר. אישור תוסף עריכה
• מודי ההרשאה מוגדרים בצורה נכונה. מצב הרשאה
• התוסף צריך להיות מוטמע בסביבת זמן הריצה V8 של Apps Script. מידע נוסף זמין במאמר סקירה כללית על סביבת זמן הריצה V8.

• התוסף מספק את כל המידע הדרוש כדי להבין את המוצר באופן בסיסי ואת אופן השימוש בו.
• קוד התוסף לא משתמש בספריות באופן מוגזם, כי ספריות עלולות לפגוע בביצועים של התוסף.
• אם אפשר, נמנעים משגיאות ומנהלים אותן כראוי. אם לא:
  • הודעות השגיאה מוצגות בתיבת דו-שיח, ולא בהתראה של JavaScript או בסרגל האדום שמופיע כברירת מחדל. הם מתארים את הבעיה בשפה פשוטה ומסבירים למשתמש מה עליו לעשות כדי לפתור אותה.
  • כשהדבר אפשרי, אם המשתמש עושה משהו לא נכון, יוצג לו לחצן שפותר את הבעיה.
  • מידע נוסף זמין במדריך הסגנון של התוספים.
• קישורים לדפים חיצוניים נפתחים בחלונות חדשים והם תקינים.
• התוסף אינטואיטיבי ומעוצב היטב. כלומר:
  • תמיד ברור מה צריך לעשות ואיך עושים את זה.
  • התוסף נגיש וקל להבנה. הימנעות ממונחים טכניים וז'רגון ספציפי.
  • תהליכי העבודה ברורים וקלים ככל האפשר.
  • המשתמש והתוכן שלו יהיו בטוחים ככל האפשר.
• התוסף עומד בדרישות של מדריך הסגנון של ממשק המשתמש לתוספים לעורך ומשתמש ב חבילת ה-CSS לתוספים לעורך.
• התוסף משתמש רק בפעולה ראשית כחולה אחת לכל מסך.
• התוסף מציג תיבת דו-שיח אחת בכל פעם. הוא לא חופף לחלונות אחרים, ואין בו כמה חלונות דו-שיח פתוחים בו-זמנית.
• ממשק המשתמש של התוסף מתאים היטב למרחבים משותפים שהוקצתה להם שטח:
  • טקסט ותוויות לא נחתכים עם '…'
  • המשתמש לא צריך לגלול הרבה בכיוון האנכי.
  • רוחב התוכן לא חורג מ-300p כדי שלא תהיה בו פס גלילה אופקית.
• התוסף מחייב אישור או מציג אזהרות לכל הפעולות הרגישות. לדוגמה, אם התוסף עומד לשכתב את כל התוכן בגיליון אלקטרוני, המשתמש יקבל אזהרה ויידרש לאשר את הפעולה לפני שהיא תתבצע.

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

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

תוספים ליומן

• אם התוסף משתמש ב-calendar.name או ב-common.name, השם במניפסט זהה לשם שצוין בדף האפליקציה.
• אם התוסף משתמש ב-calendar.conferenceSolution, שם הפתרון לפגישות לא מכיל את 'יומן Google'.
• (מומלץ) אם התוסף משתמש ב-calendar.conferenceSolution, שם הפתרון לשיחות ועידה לא יכול להכיל יותר מ-30 תווים.

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

תוספים ליומן

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

תוספים ל-Gmail

אם התוסף משתמש ב-UrlFetchApp או ב-OpenLinkUrl:

• כתובת ה-URL תקינה.
• כתובת ה-URL משתמשת ב-HTTPS ולא ב-HTTP.
• הדומיין המלא צוין.
• הנתיב לא ריק. לדוגמה, הערך https://altostrat/ תקין, אבל הערך https://altostrat לא תקין.
• אי אפשר להשתמש בתווים כלליים לחיפוש (כמו כוכבית) ב-UrlFetchApp.

תוספים ל-Meet

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

• לתוסף יש דף בית. אם התוסף ל-Google Workspace הוא תוסף Gmail שהומר, המערכת מחילה דף בית שמוגדר כברירת מחדל.
• רכיב ממשק המשתמש (כמו כרטיס של תוסף או ממשק משתמש ב-iframe בתוספים של Meet) פועל כראוי. לדוגמה, אין פריטים כפולים, והלחצנים 'חזרה', 'רענון' ו'עדכון' פועלים בהתאם.
• אחרי שהמשתמש מאשר את התוסף, מוצגים לו פרטים (כמו כרטיס דף בית מותאם אישית או דף אינטרנט בתוספים של Meet) כדי לברך אותו, עם לחצן כניסה (אם יש צורך), לוגו ותיאור קצר של התוסף.
  • אם לחצן הכניסה יופעל, יוצג דף כניסה מותאם אישית מהספק של הצד השלישי, שמציין בבירור שיש שירות של צד שלישי שפועל מחוץ ל-Google Workspace.
• ממשק המשתמש של התוסף מתאים היטב למרחבים משותפים שהוקצתה להם שטח:
  • הטקסט והתוויות לא נחתכים עם '…'
  • המשתמש לא צריך לגלול הרבה בכיוון האנכי.
  • רוחב התוכן לא חורג מ-300p כדי שלא תהיה בו פס גלילה אופקית.
• קוד התוסף לא משתמש בספריות באופן מוגזם, כי ספריות עלולות לפגוע בביצועים של התוסף.

תוספים ליומן

• אם התוסף מספק פתרונות לשירותי אירועי ועידות, יש לוודא שהישיבות שנוצרות תקינות ומוצגות בצורה תקינה באתר של שירות אירועי הווידאו של הצד השלישי.

תוספים ל-Docs

אם התוסף מציג תצוגה מקדימה של קישורים מדומיין של צד שלישי (צ'יפים חכמים):

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

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

תוספים ל-Drive

• אם האפליקציה שומרת קבצים ב-Drive, היא מאפשרת למשתמשים לבחור תיקייה או ליצור תיקייה ייעודית לאפליקציה ולעשות בה שימוש חוזר. אפשר לאחסן את נתוני ההגדרה בתיקיית נתוני האפליקציה. האפליקציה לא מעבירה קבצים לתיקייה'האחסון שלי' של המשתמש.
• התוסף מאחסן ב-Drive רק קבצים שמקושרים לפונקציונליות המתועדת של התוסף.

תוספים ל-Gmail

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

תוספים ל-Meet

• אם התוסף מחייב רישיון או מינוי: צריך להציג למשתמש הודעה ידידותית למשתמש אם אין לו רישיון.
• אם המשתמש לא יכול להשתמש בתוסף בגלל בעיה ברישיון, הודעת השגיאה צריכה לציין בבירור את הסיבה לכך שלא ניתן להשתמש בתוסף ולהציע למשתמש דרך לפתור את הבעיה.
• בדף המוצר של התוסף ב-Google Workspace Marketplace צריכים להופיע פרטים על דרישות הרישיון והמינוי שעשויות להיות נדרשות לשימוש בתוסף. אם לתוסף יש רמה בתשלום, ברשימה ב-Marketplace צריך להופיע קישור לדף אינטרנט עם מידע נוסף על התמחור או על האופן שבו אפשר ליצור קשר עם נציג מכירות.
• כשהמשתמש עדיין לא מחובר לחשבון, התוסף צריך להציג את הבקשה 'כניסה בנגיעה אחת' שמופיעה בקטע הצגת Google One Tap, ואפשרות חלופית של 'כניסה באמצעות חשבון Google' שמופיעה בקטע אימות. בנוסף למנגנון 'כניסה באמצעות חשבון Google', יכול להיות שיוצעו אפשרויות אחרות להתחברות.
• התוסף חייב להיות בעל עיצוב רספונסיבי שמאפשר להתאים את התוכן לגדלים שונים.
• תהליכי השימוש בתוסף חייבים לפעול גם אם קובצי ה-Cookie של צד שלישי מושבתים.
• אסור שתהיה גלילה אופקית בתוסף בתוך מסגרת ה-iframe.
• אם תוסף רוצה להשתמש בזירת האירוע הראשית, הוא צריך להיות מיועד לחוויות של משחקים מרובי משתתפים ולאפשר לכמה משתתפים לבצע פעולות בתוכן בו-זמנית. במשחקים לשחקן יחיד, המפתחים צריכים להשתמש בחלונית הצדדית.
• (מומלץ) התוסף צריך להציג את המשתמש שנכנס לחשבון.
• (מומלץ) בחירה של לוקליזציה: השפה צריכה להתבסס על ההעדפה המקומית שהוגדרה בדפדפן, אם היא זמינה.
• (מומלץ) בחירת התוכן צריכה להתבצע דרך ממשק גלישה בתוכן שמציג תוכן שאליו ניגשת לאחרונה.
• (מומלץ) אם אין יותר צורך בחלונית הצדדית, התוסף צריך לסגור את החלונית הצדדית אחרי ההפעלה בשלב הראשי.

תוספים ליומן

• הלוגו של פתרון הווידאו הוא כתובת URL ציבורית. איך מספקים סמלי לוגו של פתרונות לשיחות ועידה
• אם התוסף משתמש ב-calendar.conferenceSolution, הלוגו של פתרון הכנסים צריך לעמוד בדרישות של calendar.logoUrl. למידע נוסף, ראו משאב מניפסט של יומן.
• אם התוסף משתמש ב-calendar.logoUrl או ב-common.logoUrl, הלוגו זהה לסמל שמופיע בכרטיס האפליקציה.
• אם התוסף משתמש ב-calendar.logoUrl או ב-common.logoUrl, כתובת ה-URL של הלוגו מתחילה כך: https://lh3.googleusercontent.com/

תוספים ל-Meet

• לוגו המותג של התוסף צריך להיות בגודל ובסגנון שיאפשרו לזהות אותו בחלונית הצדדית של Meet.
• צריך לציין כתובות URL מתאימות של סמלי לוגו לשימוש במצב כהה בmanifest של התוסף

תוספים ל-Drive

• (מומלץ) אם רוצים לקבל מטא-נתונים מוגבלים, צריך לכלול את ההיקף drive.addons.metadata.readonly בתוסף.

• כתובת ה-URL של הניווט האוניברסלי מפנה לאפליקציית אינטרנט. דף אינטרנט פשוט ללא פונקציונליות לא נחשב לאפליקציית אינטרנט.