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

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

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

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

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

משך הבדיקה

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

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

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

אימות OAuth:

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

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

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

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

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

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

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

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

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

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

    אם לא צוין הסטטוס "Trader status un specified", יופיע בדף דף האפליקציה בחנות של האפליקציה.
תיאור האפליקציה
  • כל הקישורים שסופקו פועלים ומפנים למידע הנכון. לדוגמה, קישור למדיניות הפרטיות מפנה לדף שמתאר את מדיניות הפרטיות.
  • אם האפליקציה מקיימת אינטראקציה עם שירות של צד שלישי, בתיאור מתואר מה השירות של הצד השלישי, מה האינטראקציה של האפליקציה עם השירות ויש גם קישור לאתר הרלוונטי.
  • התיאורים הקצרים והמפורטים מובנים.
  • התיאורים הקצרים והמפורטים לא זהים.
  • (מומלץ) פרטי התמחור מלאים ומדויקים.
  • (מומלץ) הקבוצה המלאה של המאפיינים לכל שפה (שם, תיאור קצר ותיאור מפורט) מוגדרת בצורה נכונה, בלי חוסר התאמה בשפה.
פונקציונליות
  • אין באגים ברורים וכל הפעולות, כולל כיסויי קצה, פועלות באופן מלא. זמני הטעינה מנוהלים באמצעות אינדיקטורים של טעינה.
  • האפליקציה מדגימה אינטראקציות ברורות עם ממשקי ה-API של Google.
  • האפליקציה מספקת פונקציונליות חדשה או מורחבת, שלא דומה לזו שכבר כלולה במוצרי 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". מידע נוסף זמין במאמר שליחת הודעה בכרטיס דף הבית של האפליקציה.
  • האפליקציה תומכת בפקודה "עזרה" ועוזרת למשתמשים להתחיל להשתמש בה. מידע נוסף זמין במאמר תשובה לפקודות של לוכסן.
  • האפליקציה תמיד מגיבה כשמדברים אליה במרחב משותף או בצ'אט ישיר.
  • ההודעות מבוססות על איות, שימוש באותיות רישיות, פיסוק ודקדוק נכונים, ואין בהן תוכן זדוני, פוגעני או פוגעני.
  • הודעות הן בפורמט ברור, תמציתי ועקבי עבור טקסט או כרטיסים, בהתאם לדרישות של Google.
  • אם התשובה נמשכת יותר מ-2 שניות, האפליקציה תשלח הודעה עם הסבר על העיכוב.
  • אפליקציות ששולחות התראות מאפשרות למשתמשים להשבית אותן.
  • משתמשים יכולים להוסיף את האפליקציה למרחב משותף באמצעות אזכור באמצעות @.
  • משתמשים יכולים להסיר את האפליקציה ממרחב משותף באמצעות התפריט הצגת רשימת משתמשים.
  • האפליקציה מציינת למשתמש את כל מה שצריך לבצע איתה אינטראקציה.
  • פורמט הכרטיסים שהאפליקציה משתמשת בהם עומד בדרישות של Google. מידע נוסף מופיע במאמר יצירת כרטיסים אינטראקטיביים.
  • אפשר לבחור את האפשרות חיפוש אפליקציות בתפריט Chat.
  • כתובות URL חיצוניות שהאפליקציה מקיימת איתן אינטראקציה לא שייכות לסביבת Staging או פיתוח.
  • צריך להוסיף את האזכור באמצעות @בכל הודעה לאפליקציה במרחבים משותפים. זו הדרך היחידה שבה האפליקציה יודעת שהיא חייבת להגיב.
  • אם אפליקציית Chat מציגה בתצוגה מקדימה קישורים מדומיין של צד שלישי:
    • התצוגה המקדימה של הקישורים כוללת מידע רלוונטי ומשלים להודעה של המשתמש. לדוגמה, תצוגה מקדימה של קישור לעסקה מוסיפה מידע כמו חשבון, סכום ושלב.
    • המפתח משויך לדומיין שמוצג בתצוגה המקדימה.

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

  • (מומלץ) כדי לאפשר לאדמינים ב-Workspace להתקין את האפליקציה בשם המשתמשים בארגון שלהם, לאפליקציה שלך צריכה להיות אפשרות לקבל ולשלוח צ'אטים אישיים.
אפליקציית Google Chat גרפיקה
  • לאפליקציה יש דמות ברורה ושניתן לזהות אותה.
אפליקציית Google Drive פונקציונליות
  • האפליקציה לא משתמשת בתוספים לדפדפן Chrome כדי לספק פונקציונליות על ידי שינוי ה-HTML של Drive באופן ישיר.
  • אם באפליקציה שלך נעשה שימוש בהיקפים רגישים או מוגבלים, היא חייבת לעבור אימות OAuth. מידע נוסף זמין בקטע איך שולחים בקשה לאימות.
  • אם האפליקציה שלך משתמשת בהיקפים מוגבלים, היא צריכה לעבור גם בדיקת אבטחה. למה נדרשת בדיקת אבטחה.
אפליקציית Google Drive חוויית משתמש
  • אם האפליקציה שומרת קבצים ב-Drive, היא מאפשרת למשתמשים לבחור תיקייה, או ליצור תיקייה ספציפית לאפליקציה ולהשתמש בה שוב. אפשר לשמור את נתוני ההגדרות בתיקייה של נתוני האפליקציות. האפליקציה לא מעלה קבצים לתיקייה'האחסון שלי' של המשתמש.
  • האפליקציה מאחסנת רק קבצים ב-Drive הקשורים לפונקציונליות המתועדת של האפליקציה.
תוסף עריכה פונקציונליות
  • התוסף כולל את הפעולות הנדרשות והפעולות הצפויות, והוא כולל את כל הכלים הדרושים להשלמת תהליך העבודה. למשל:
    • אם התוסף מחיל את הסגנון על כל המסמך, הוא מאפשר להחיל את הסגנון רק על הטקסט שנבחר.
    • אם התוסף מעלה נתונים של גיליון אלקטרוני לפיד של שירותי אינטרנט, יש לו קישור לפיד הזה כדי שיהיה קל לנווט בו.
    • אם התוסף דורש שלמשתמש יהיה חשבון, הוא מספק קישורים או מידע ליצירה של חשבון בקלות, אם למשתמש אין עדיין חשבון.
  • התוסף מכיל אפשרויות בתפריט בכרטיסייה תוספים.
  • גם אם התוסף הוא רק פונקציות בהתאמה אישית, הוא עדיין כולל תיעוד מתאים.
  • התוסף משתמש באופן תקין ב-onInstall() וב-onOpen() כדי לאכלס את התפריט שלו. האפשרויות בתפריט מאוכלסות כשהתוסף מותקן בפעם הראשונה וכשקובץ אחר נפתח. למידע נוסף, ראו הרשאה לתוסף עריכה.
  • מצבי ההרשאה מוגדרים בצורה נכונה. למידע נוסף, ראו מצבי הרשאה.
תוסף עריכה חוויית משתמש
  • התוסף מספק את כל המידע הנחוץ כדי להבין בסיסית את המוצר ואת אופן השימוש בו.
  • בקוד התוסף יש שימוש מוגזם בספריות, כי ספריות עלולות לגרום לפגיעה בביצועים של התוסף.
  • אם אפשר, נמנעים משגיאות ומנוהלות בצורה תקינה, אם לא:
    • הודעות השגיאה מוצגות בחלון דו-שיח, לא בהתראה של 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. ראו מקור של מניפסט ביומן.
  • אם התוסף משתמש ב-calendar.logoUrl או ב-common.logoUrl, הלוגו זהה לסמל שצוין בדף האפליקציה.
  • אם התוסף משתמש ב-calendar.logoUrl או ב-common.logoUrl, כתובת ה-URL של הלוגו תתחיל כך: https://lh3.googleusercontent.com/
תוסף ל-Google Workspace OAuth

תוספים ל-Drive

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