תהליך הבדיקה

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

נקודה חשובה: חשוב לעיין היטב בפריטים שבמדריך הזה לפני שמפרסמים את התוסף.

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

סיום פיתוח התוסף

בדיקת הדרישות לתוסף

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

בדיקת התוסף

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

נקודה חשובה: תוכנית הבדיקה של התוספים מכילה את אותן בדיקות שבהן משתמש צוות הבדיקה של Google Workspace Marketplace. מומלץ לבדוק באופן יזום שהתוסף יוצר התנהגויות צפויות בכל הבדיקות הרלוונטיות.

הקלטת סרטון הדגמה

ליצור הקלטת מסך שמדגימה איך האפליקציה משתמשת בכל היקף OAuth שנדרש. לצורך פיתוח תוסף, מומלץ להציג את תהליך ההתקנה של התוסף ואת יצירת הקובץ המצורף של התוסף.

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

הכנה לפרסום

בדיקת ההגדרה של הפרויקט בענן

בודקים כל אחת מהגדרות התצורה הבאות בפרויקט Google Cloud.

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

• בדף Auth Audience (קהל אימות) של פרויקט Cloud:
  • סטטוס הפרסום הוא בסביבת הייצור.
  • סוג המשתמש הוא חיצוני.
• בדף Auth Branding בפרויקט ב-Cloud:
  • כל שדות החובה מולאו.
  • צריך לוודא שדף הבית של האפליקציה לא מקשר לאפליקציה עצמה, אלא למידע על המוצרים שלכם.
• בדף Auth Data Access בפרויקט ב-Cloud:
  • צריך לציין לפחות אחד מהיקפי ההרשאות .../auth/userinfo.email או .../auth/userinfo.profile לא רגיש.
  • כל ההיקפים האחרים שנדרשים על ידי התוסף שלכם מצוינים. במקרה של תוספים ל-Classroom, צריך לכלול את היקפי ההרשאות sensitive‏ .../auth/classroom.addons.teacher ו-.../auth/classroom.addons.student.
  • בשדה סרטון הדגמה, צריך לספק קישור לסרטון ב-YouTube שמדגים איך אתם משתמשים בנתונים מההיקפים המבוקשים. צריך לספק את הקישור לצילום המסך שצולם קודם.
• ‫API libraries הבאות מופעלות:
  • Google Classroom API
  • Google Workspace Marketplace SDK

בדיקת ההגדרות של Marketplace SDK

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

בדף App Configuration (הגדרת אפליקציה) ב-Google Workspace Marketplace SDK:

• האפשרות Classroom add-on (תוסף ל-Classroom) מסומנת בקטע App Integration (שילוב אפליקציות).
• ה-URI של דף הנחיתה של התוסף מופיע בURI של הגדרת הקובץ המצורף.
• כל הקידומות של מזהי ה-URI של הקבצים המצורפים המותרים מסופקות.
• הרשימה של היקפי OAuth זהה להיקפים שצוינו במסך ההסכמה ל-OAuth ובקוד האפליקציה.
• כתובת האימייל של המפתח בקטע 'קישורים למפתחים' היא כתובת אימייל שנבדקת באופן קבוע. צוות זירת המסחר משתמש בכתובת הזו כדי ליצור איתך קשר.
• החשיפה של האפליקציה מוגדרת כגלוי לכולם והתיבה לא רשום מסומנת.

בודקים שדף פרטי האפליקציה ב-Google Workspace Marketplace של הפרויקט עומד בדרישות של שיקולים לגבי פרטי האפליקציה.

מתן גישה למבקר

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

• [e-mail]
• [e-mail]
• [e-mail]
• [e-mail]

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

חשוב: בודקים עשויים להתחבר לאפליקציה שלכם מארגנטינה, קנדה וארה"ב. מוודאים שהאזורים האלה לא חסומים בהטמעה שלכם ושהם מותרים בקטע הפצה בדף האפליקציה בחנות ב-Marketplace SDK. אפשר לשנות את הגדרות ההפצה אחרי שהתוסף מאושר.

השלמת אימות OAuth

שליחה לאימות

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

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

יצירת קשר עם צוות האימות

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

בדרך כלל התהליך הזה נמשך 3-5 ימי עסקים אם משתמשים רק ב היקפי הרשאות רגישים של OAuth. יכול להיות שיידרשו פעולות נוספות וזמן נוסף אם אתם משתמשים ב היקפי הרשאות מוגבלים של OAuth.

השלמת ביקורת ב-Google Workspace Marketplace

שליחה לבדיקה

הערה: אפשר להגיש בקשה לבדיקה ב-Marketplace ולאימות OAuth בו-זמנית. עם זאת, האפליקציה שלכם צריכה לעבור אימות OAuth לפני שתוכל לקבל אישור סופי ב-Marketplace.

לוחצים על פרסום בחלק התחתון של הדף פרטי האפליקציה ב-Google Workspace Marketplace בפרויקט Google Cloud. צוות הבדיקה של Marketplace בודק את התוסף בהתאם לדרישות של Google Workspace ושל התוספים של Classroom.

תקשורת עם צוות הבדיקה

צוות הבדיקה של Marketplace מתקשר ישירות עם כתובת האימייל של המפתח שצוינה בדף App Configuration (הגדרת אפליקציה) ב-Google Workspace Marketplace SDK. תקבלו הודעה אם יש בעיות בתוסף שלכם, או אם הוא אושר לפרסום. מומלץ להקצות לתהליך הזה תקציב של שבועיים-שלושה.

אחרי אישור הפרסום

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