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

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

• לאפליקציית Chat יש תכונות אינטראקטיביות, ואפשר להוסיף אותה לצ'אטים ישירים או למרחבים.

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

  מידע נוסף על תצוגה מקדימה של קישורים

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

• לאפליקציה יש אווטאר ברור וקל לזיהוי.

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

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

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

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

  אפשר להימנע מהדרישה הזו באמצעות שינויים בעיצוב. לדוגמה, תוסף ל-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.
• ממשק המשתמש של התוסף מתאים בצורה מסודרת למקומות שהוקצו:
  • הטקסט והתוויות לא נחתכים עם '…'
  • המשתמש לא צריך לגלול הרבה אנכית.
  • רוחב התוכן לא חורג מ-300 פיקסלים, כדי שלא יהיה פס גלילה אופקי.
• הקוד של התוסף לא משתמש בספריות בצורה מוגזמת, כי ספריות עלולות לפגוע בביצועים של התוסף.

תוספים ליומן

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

תוספים ל-Docs

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

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

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

תוספים ל-Drive

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

תוספים ל-Gmail

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

תוספים ל-Meet

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

תוספים ליומן

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

תוספים ל-Meet

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

תו��פים ל-Drive

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

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