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

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

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

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

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

משך הבדיקה

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

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

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

אימות OAuth:

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

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

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

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

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

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

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

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

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

תוספים ליומן

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

תוספים ל-Drive

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