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

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

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

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

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

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

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

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

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

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

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

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

תוספים ליומן

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

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

תוספים ליומן

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

תוספים ל-Gmail

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

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

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

תוספים ליומן

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

תוספים ל-Docs

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

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

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

תוספים ל-Drive

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

תוספים ל-Gmail

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

תוספים ליומן

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

תוספים ל-Drive

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

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