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

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

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

  • אם האפליקציה מחייבת עבודה נוספת – תקבלו מסמך בדיקה עם מידע ספציפי על מה שצריך לשפר. מתקנים את הבעיות ושולחים מחדש את האפליקציה לבדיקה.
  • אם צוות הבדיקה יאשר את האפליקציה – היא תפורסם באופן אוטומטי ותקבלו התראה באימייל.

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

משך הבדיקה

תהליך הבדיקה של האפליקציה בדרך כלל נמשך כמה ימים. משך הזמן תלוי בגורמים הבאים:

  • כמה אפליקציות נשלחו לאחרונה
  • כמה עבודה נוספת האפליקציה שלך צריכה

סיבות נפוצות לכך שאפליקציה לא עוברת את הבדיקה

אימות OAuth:

  • מסך ההסכמה של OAuth הוגדר בצורה שגויה. לדוגמה, סוג המשתמש מוגדר כפנימי או שסטטוס הפרסום מוגדר כ-בדיקה.
  • האפליקציה לא השלימה את אימות ה-OAuth.

בעיות בדף האפליקציה:

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

מוכנות האפליקציה:

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

בדיקת הקריטריונים

לפני ששולחים את האפליקציה לבדיקה, צריך לוודא שהיא עומדת בכל הדרישות ובתאימות למדיניות התוכנית של Google Workspace Marketplace.

דרישות לכל האפליקציות

אפשר להשתמש בתיבות הסימון כדי לעקוב אחרי הבדיקה הראשונית.

קטגוריה קריטריונים
שם האפליקציה
  • אין דפי אפליקציות אחרים באותו שם.
  • השם לא כולל מספר גרסה.
  • השם תואם לשם שבמסך ההסכמה ל-OAuth.
  • השם לא מעורפל או כללי מדי.
  • השם באורך של 50 תווים או פחות.
  • (מומלץ) השם כולל אותיות רישיות בתחילת כל מילה.
  • (מומלץ) בשם אין סימני פיסוק, במיוחד סוגריים.
מידע על המפתח
  • שם המפתח ואתר המפתח מייצגים באופן מדויק את המידע הרלוונטי על המפתח ומפנים למידע רלוונטי.
  • עקב חוקים להגנת הצרכן, צרכנים שנמצאים באזור הכלכלי האירופי (EEA) חייבים לדעת אם מוכר ב-Google Workspace Marketplace הוא עסק או לא עסק:
    • עסק – עסק הוא אדם שפועל למטרות שקשורות לתחום, לעסק, למלאכת יד או למקצוע, או בשם עסק או בשמו.
    • לא עסק – אדם שאינו עסק (צרכן) הוא אדם שפועל למטרות לא מקצועיות.

    אם לא צוין סטטוס העסק, יופיע דף האפליקציה בחנות בדף האפליקציה.
תיאור האפליקציה
  • כל הקישורים המוצגים פועלים ומפנים למידע הנכון. לדוגמה, קישור למדיניות פרטיות מפנה לדף שמתאר את מדיניות הפרטיות.
  • אם האפליקציה מקיימת אינטראקציה עם שירות של צד שלישי, יש לתאר מה שירות הצד השלישי עושה, איך האפליקציה מקיימת אינטראקציה איתו ואם יש קישור לאתר הרלוונטי.
  • התיאורים הקצרים והמפורטים מובנים.
  • התיאורים הקצרים והמפורטים לא זהים.
  • (מומלץ) פרטי התמחור מלאים ומדויקים.
  • (מומלץ) הקבוצה המלאה של המאפיינים לכל שפה (שם, תיאור קצר ותיאור מפורט) מוגדרים בצורה נכונה, בלי חוסר התאמה בשפה.
פונקציונליות
  • אין באגים נראים לעין וכל הפעולות, כולל מקרי קצה, פועלות באופן מלא. זמני הטעינה מנוהלים באמצעות מחווני טעינה.
  • האפליקציה מציגה אינטראקציות ברורות עם Google APIs.
  • האפליקציה מספקת פונקציונליות חדשה או מורחבת שאינה מקבילה לאלה שכבר כלולה במוצרי Google.
  • האפליקציה לא מיועדת למטרות פרסום או ספאם.
  • האפליקציה פועלת באופן מלא ולא מיועדת למטרות בדיקה – היא לא נמצאת בשלבי פיתוח.
  • אם האפליקציה מקיימת אינטראקציה עם תכונות שזמינות למשתמשים או למשתמשים משלמים, חשבון בדיקה במערכת של המפתח יועבר לצוות הבדיקה של Google.
חוויית משתמש
  • באפליקציה, כולל השם שלה, אין שימוש בנכסים שקשורים למותג Google, בסימנים מסחריים או בתוכן ממותג של Google. אפשר לעיין במאמר הנחיות המיתוג של Google Workspace Marketplace.
  • צריך הרשאה וכניסה רק פעם אחת. האפליקציה משתמשת בכניסה יחידה (SSO) בלחיצה אחת או בכניסה יחידה (SSO) ללא לחיצה.
  • אחרי שהאדמין נתן הרשאות להיקפי ההרשאות של OAuth 2.0 לדומיין, משתמשים מסוימים לא יתבקשו שוב לתת הרשאות להיקף ההרשאות.
  • המשתמשים לא צריכים להזין פרטי כניסה אחרי שהם נכנסים לחשבון Google. לכל היותר, עליהם ללחוץ על לחצן 'כניסה באמצעות חשבון Google' כדי לקבל גישה.
  • יש מונחים עקביים, ברורים וברורים לתוויות לחצנים, אפשרויות בתפריט, כותרות ורכיבים אחרים באפליקציה. לדוגמה, במקום 'כן' או 'לא', התוויות מתייחסות לשמות של פעולות כמו 'מחיקה' ו'ביטול'.
  • אם נדרשת כניסה לחשבון, הפונקציונליות של היציאה מהחשבון פועלת כמו שצריך. האסימונים מבוטלים והכניסה לחשבון יכולה להתחיל מההתחלה.
  • משוב תמיד מוצג, למשל אישור או הודעות שגיאה, עבור פעולות.
  • אין קישורים מנותקים לתמונות או תמונות מטושטשות.
גרפיקה
  • גודל הסמלים מוגדר כמו שצריך, מרובעים ושהרקע שלהם שקוף. מידע נוסף מופיע בקטע נכסים גרפיים.
  • הסמל מייצג כראוי את שם האפליקציה או את הפונקציונליות שלה.
  • הסמל מופיע בצבע (ללא קנה מידה בצבע אפור).
  • הסמל לא משתמש בסימנים המסחריים של Google.
  • צילומי המסך והתמונות לא מטושטשים, לא קריאים או בלתי הולמים. הם מייצגים את האפליקציה בצורה מדויקת.
  • (מומלץ) צילומי המסך מראים בבירור איך להשתמש באפליקציה ומה היא עושה.
OAuth
  • האפליקציה עברה אימות OAuth, משתמשת בהיקפי OAuth המצומצמים ביותר שאפשר, וכל היקפי ההרשאות משתלבים בצורה תקינה עם ממשקי ה-API של שירותי Google.

דרישות נוספות לגבי שילובים ספציפיים של אפליקציות

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

אפשר להשתמש בתיבות הסימון כדי לעקוב אחרי הבדיקה הראשונית.

שילוב אפליקציה קטגוריה קריטריונים
אפליקציית Google Chat שם
  • הלחצנים לתקשורת עם האפליקציה זמינים בתיאור.
  • שם האפליקציה מתחיל באותיות A עד Z (אותיות רישיות) או 0 עד 9. הוא לא יכול להתחיל בסמל.
אפליקציית Google Chat חוויית משתמש
  • האפליקציה שולחת הודעת פתיחה ללא בקשה בכל פעם שמשתמש מתחיל צ'אט אישי או שהאפליקציה מתווספת למרחב. הודעת הפתיחה שונה מהפקודה Help (עזרה). אפשר לקרוא מידע נוסף במאמר שליחת הודעה בכרטיס הבית של האפליקציה.
  • האפליקציה תומכת בפקודה 'עזרה' ועוזרת למשתמשים להתחיל להשתמש בה. מידע נוסף מופיע במאמר מענה לפקודות של לוכסן.
  • האפליקציה תמיד מגיבה כשמדברים איתם במרחב משותף או ב-Chat.
  • ההודעות מבוססות על איות, שימוש באותיות רישיות, פיסוק ודקדוק נכונים. ההודעות לא מכילות תוכן זדוני, פוגעני או פוגעני.
  • בהודעות הטקסט או בכרטיסים, הטקסט או הכרטיסים מופיעים בפורמט ברור, תמציתי ועקבי, בהתאם לדרישות של Google.
  • אם התשובה נמשכת יותר מ-2 שניות, האפליקציה שולחת הודעה עם הסבר על העיכוב.
  • אפליקציות ששולחות התראות מאפשרות למשתמשים להשבית אותן.
  • המשתמשים יכולים להוסיף את האפליקציה למרחב משותף על ידי אזכור באמצעות @.
  • המשתמשים יכולים להסיר את האפליקציה ממרחב משותף בעזרת התפריט הצגת המשתמשים.
  • האפליקציה מציינת למשתמש את כל מה שצריך כדי לקיים איתה אינטראקציה.
  • הפורמטים של הכרטיסים שהאפליקציה משתמשת בהם עומדים בדרישות של Google. למידע נוסף, ראו יצירת כרטיסים אינטראקטיביים.
  • האפליקציה זמינה דרך האפשרות חיפוש אפליקציות בתפריט Chat.
  • כתובות URL חיצוניות שהאפליקציה מקיימת איתן אינטראקציה לא שייכות לסביבת Staging או פיתוח.
  • חובה לכלול אזכור ( @mention) בכל הודעה לאפליקציה במרחבים משותפים. זו הדרך היחידה שבה האפליקציה יכולה לדעת שהיא חייבת להגיב.
  • אם אפליקציית Chat מציגה תצוגה מקדימה של קישורים מדומיין של צד שלישי:
    • בתצוגה המקדימה של קישורים יש מידע רלוונטי ומשלים להודעה של המשתמש. לדוגמה, תצוגה מקדימה של קישור לעסקת מכירות מוסיפה מידע כמו החשבון, הסכום והשלב.
    • המפתח משויך לדומיין שמוצג בתצוגה מקדימה.

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

  • (מומלץ) כדי לאפשר לאדמינים ב-Workspace להתקין את האפליקציה שלך בשם המשתמשים בארגון, האפליקציה צריכה לקבל ולשלוח הודעות בצ'אטים אישיים.
אפליקציית Google Chat גרפיקה
  • באפליקציה יש דמות ברורה שהמערכת יכולה לזהות.
אפליקציית Google Drive פונקציונליות
  • האפליקציה לא משתמשת בתוספים לדפדפן Chrome כדי לספק פונקציונליות על ידי ביצוע מניפולציות ישירות על קוד ה-HTML ב-Drive.
  • אם באפליקציה שלך נעשה שימוש בהיקפים רגישים או מוגבלים, היא צריכה לעבור אימות OAuth. מידע נוסף זמין בקטע איך מגישים בקשה לאימות.
  • אם האפליקציה שלך משתמשת בהיקפים מוגבלים, גם היא צריכה לעבור בדיקת אבטחה. ראו למה צריך לבצע את הערכת האבטחה.
אפליקציית Google Drive חוויית משתמש
  • אם האפליקציה מאחסנת קבצים ב-Drive, היא מאפשרת למשתמשים לבחור תיקייה או ליצור תיקייה ספציפית לאפליקציה ולהשתמש בה שוב. אפשר לשמור את נתוני ההגדרות בתיקייה 'נתוני אפליקציות'. האפליקציה לא יוצרת קבצים בתיקיית'האחסון שלי' של המשתמש.
  • האפליקציה שומרת רק קבצים ב-Drive שקשורים לפונקציונליות המתועדת של האפליקציה.
תוסף עריכה פונקציונליות
  • הפעולות הצפויות והפעולות הנדרשות נכללות בתוסף, והוא כולל את כל הכלים הדרושים להשלמת תהליך העבודה. למשל:
    • אם התוסף מאפשר להחיל את העיצוב על כל המסמך, אפשר להחיל את העיצוב רק על הטקסט שנבחר.
    • אם התוסף מעלה נתונים של גיליון אלקטרוני אל פיד של שירותי אינטרנט, יש לו קישור אל הפיד הזה כדי לאפשר לך לנווט בקלות.
    • אם התוסף דורש שלמשתמש יהיה חשבון, הוא מספק קישורים או מידע שיאפשרו לך ליצור חשבון בקלות, אם עדיין אין למשתמש חשבון.
  • לתוסף יש אפשרויות בתפריט בכרטיסייה תוספים.
  • גם אם התוסף הוא רק פונקציות מותאמות אישית, הוא עדיין כולל תיעוד מתאים.
  • התוסף משתמש בצורה נכונה ב-onInstall() וב-onOpen() כדי לאכלס את התפריט שלו. האפשרויות בתפריט מאוכלסות בפעם הראשונה שמתקינים את התוסף וכשפותחים קובץ אחר. למידע נוסף, אפשר לקרוא את המאמר הרשאה לעריכת תוספים.
  • מצבי ההרשאה מוגדרים בצורה נכונה. למידע על מצבי הרשאה
  • צריך להטמיע את התוסף בסביבת זמן הריצה V8 של Apps Script. אפשר לקרוא מידע נוסף במאמר סקירה כללית על זמן ריצה של V8.
תוסף עריכה חוויית משתמש
  • התוסף מספק את כל המידע הנדרש כדי להבין בצורה בסיסית את המוצר ואת אופן השימוש בו.
  • בקוד של התוסף אין יותר מדי שימוש בספריות כי ספריות עלולות לגרום לתוסף לפגוע בביצועים.
  • אם אפשר, המערכת מונעת שגיאות אם הן לא מנוהלות כראוי:
    • הודעות השגיאה מוצגות בחלון של תיבת דו-שיח, לא בהתראת JavaScript או בסרגל האדום שמוגדר כברירת מחדל. הם מסבירים את הבעיה ומתארים מה המשתמש צריך לעשות כדי לפתור אותה בשפה פשוטה.
    • במקרים שבהם זה אפשרי, אם המשתמש עושה משהו לא נכון, יוצג לחצן שיפתור את הבעיה.
    • למידע נוסף, ראו את מדריך הסגנון לתוספים.
  • קישורים לדפים חיצוניים נפתחים בחלונות חדשים והם נכונים.
  • התוסף אינטואיטיבי ומעוצב היטב. כלומר:
    • תמיד ברור מה לעשות ואיך.
    • התוסף נגיש ופשוט להבנה. יש להימנע ממונחים טכניים וממונחים טכניים.
    • תהליכי העבודה ברורים ואפשר להיעזר בהם עד כמה שאפשר.
    • המשתמשים והתוכן שלהם בטוחים ככל האפשר.
  • התוסף פועל בהתאם למדריך הסגנון של ממשק המשתמש (UI) לתוספים לעריכת תוספים, ומשתמש ב חבילת ה-CSS לתוספים לעריכה.
  • התוסף משתמש רק בפעולה ראשית אחת בצבע כחול בכל תצוגה.
  • בתוסף מוצגת תיבת דו-שיח אחת בכל פעם. היא לא חופפת או שנפתחות בה כמה תיבות דו-שיח בו-זמנית.
  • ממשק המשתמש של התוסף משתלב היטב במרחבים שהוקצו:
    • טקסט ותוויות לא נחתכים ב-"..."
    • המשתמש לא צריך לבצע גלילה אנכית רבה.
    • רוחב התוכן לא חורג מ-300p ולכן אין בו סרגל גלילה אופקי.
  • התוסף מחייב אישור או מציג אזהרות לגבי כל הפעולות הרגישות. לדוגמה, אם התוסף עומד להחליף את כל התוכן בגיליון אלקטרוני, המשתמש יקבל אזהרה ויאשר את הפעולה לפני שהיא מתרחשת.

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

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

תוספים ליומן

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

תוספים ליומן

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

תוספים ל-Gmail

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

  • כתובת ה-URL חוקית.
  • בכתובת ה-URL נעשה שימוש ב-HTTPS ולא ב-HTTP.
  • הדומיין המלא צוין.
  • הנתיב לא ריק. לדוגמה, https://altostrat/ זה בסדר, אבל https://altostrat לא.
  • לא ניתן להשתמש בתווים כלליים לחיפוש בUrlFetchApp.
תוסף ל-Google Workspace חוויית משתמש
  • לתוסף יש דף בית. אם התוסף ל-Google Workspace הוא תוסף ל-Gmail שהומר, יוחל דף בית שמוגדר כברירת מחדל.
  • כרטיס התוסף פועל כמו שצריך. לדוגמה, אין כרטיסים כפולים. הלחצנים 'הקודם', 'רענון' ו'עדכון' פועלים בהתאם.
  • אחרי שהמשתמש יאשר את התוסף, יוצג לו כרטיס דף בית מותאם אישית שבו יוצג לו לחצן לכניסה לחשבון (במקרה הצורך), לוגו ותיאור קצר של התוסף.
    • אם לחצן הכניסה מופעל, מוצג דף כניסה מותאם אישית מספק הצד השלישי, שמציין בבירור שיש שירות צד שלישי שפועל מחוץ ל-Google Workspace.
  • ממשק המשתמש של התוסף משתלב היטב במרחבים שהוקצו:
    • הטקסט והתוויות לא נחתכים בסימון "..."
    • המשתמש לא צריך לבצע גלילה אנכית רבה.
    • רוחב התוכן לא חורג מ-300p ולכן אין בו סרגל גלילה אופקי.
  • בקוד של התוסף אין יותר מדי שימוש בספריות כי ספריות עלולות לגרום לו לאבד את הביצועים של התוסף.

תוספים ליומן

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

תוספים ל-Docs

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

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

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

תוספים ל-Drive

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

תוספים ל-Gmail

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

תוספים ליומן
תוסף ל-Google Workspace OAuth

תוספים ל-Drive

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