במדריך הזה מוסבר תהליך הבדיקה של תוספים ל-Classroom. חשוב לקרוא את ההודעה בעיון, כי יש בה פעולות שצריך לבצע תוך פרק זמן מוגבל.
התוסף שלכם צריך לעבור אימות OAuth על ידי צוות האמון והבטיחות, ולקבל אישור מצוות Google Workspace Marketplace. מידע כללי על אימות OAuth זמין במאמר שאלות נפוצות בנושא אימות OAuth. מידע כללי על תהליך בדיקת האפליקציות ב-Google Workspace Marketplace זמין במאמר מידע על בדיקת אפליקציות.
סיום פיתוח התוסף
דרישות לגבי תוספים
מוודאים שההתנהגות של התוסף עומדת בדרישות.
בדיקת התוסף
התוסף שלך נבדק בהתאם לתהליכים שמופיעים בתוכנית הבדיקה של התוספים שלנו. כדאי לפעול לפי הנהלים לבדיקת התוסף הציבורי לפני ששולחים אותו לפרסום. אם הבדיקות האלה ייכשלו, יכול להיות שיידרש זמן רב יותר לאישור התוסף.
הקלטת סרטון הדגמה
ליצור הקלטת מסך שמדגימה איך האפליקציה משתמשת בכל היקף OAuth שנדרש. לצורך פיתוח תוסף, מומלץ להציג את תהליך ההתקנה של התוסף ואת יצירת הקובץ המצורף של התוסף.
אחרי ההקלטה, מעלים את הקלטת המסך ל-YouTube כסרטון לא רשום. אפשר להגיע לסרטון לא רשום רק באמצעות הקישור שלו. תתבקשו לספק את הקישור לסרטון כשמתחילים את תהליך האימות של OAuth. צוות OAuth צופה בסרטון במהלך בדיקת בקשת התוסף.
הכנה לפרסום
בדיקת ההגדרה של הפרויקט בענן
בודקים כל אחת מהגדרות התצורה הבאות בפרויקט Google Cloud.
- בדף קהל אימות של הפרויקט ב-Cloud:
- סטטוס הפרסום הוא בסביבת הייצור.
- סוג המשתמש הוא חיצוני.
- בדף Auth Branding בפרויקט ב-Cloud:
- כל שדות החובה מולאו.
- צריך לוודא שדף הבית של האפליקציה לא מקשר לאפליקציה עצמה, אלא למידע על המוצרים שלכם.
- בדף Auth Data Access (גישה לנתוני אימות) בפרויקט Cloud:
- צריך לציין לפחות אחד מהיקפי ההרשאות
.../auth/userinfo.emailאו.../auth/userinfo.profileלא רגישים. - כל ההיקפים האחרים שנדרשים על ידי התוסף שלכם מצוינים. במקרה של תוספים ל-Classroom, צריך לכלול את היקפי ההרשאות המסווגים כרגישים
.../auth/classroom.addons.teacherו-.../auth/classroom.addons.student. - בשדה סרטון הדגמה, צריך לספק קישור לסרטון ב-YouTube שמדגים איך אתם משתמשים בנתונים מההיקפים המבוקשים. צריך לספק את הקישור לצילום המסך שצילמת קודם.
- צריך לציין לפחות אחד מהיקפי ההרשאות
- API libraries הבאות מופעלות:
בדיקת ההגדרות של Marketplace SDK
בדף App Configuration (הגדרת אפליקציה) ב-Google Workspace Marketplace SDK:
- האפשרות תוסף ל-Classroom מסומנת בקטע שילוב אפליקציות
- מזהה ה-URI של דף הנחיתה של התוסף מופיע במזהה ה-URI של הגדרת הקובץ המצורף.
- כל הקידומות של כתובות ה-URI של הקבצים המצורפים המותרים מסופקות.
- הרשימה של היקפי OAuth זהה בדיוק להיקפים שצוינו במסך ההסכמה ל-OAuth ובקוד האפליקציה.
- כתובת האימייל של המפתח בקטע 'קישורים למפתחים' היא כתובת אימייל שנבדקת באופן קבוע. צוות Marketplace משתמש בכתובת הזו כדי ליצור איתכם קשר.
- סטטוס החשיפה של האפליקציה מוגדר כגלוי לכולם ותיבת הסימון לא רשום מסומנת.
בודקים שדף פרטי האפליקציה ב-Google Workspace Marketplace של הפרויקט עומד בדרישות של השיקולים לגבי פרטי האפליקציה.
מתן גישה למבקר
צריך לאפשר לחשבונות המשתמשים הבאים של צוות הבדיקה של Marketplace גישה לאפליקציה. מוסיפים גם את שני המשתמשים עם תפקיד המורה כ בודקים של טיוטה באפליקציית התוסף.
teacher@marketplacetest.infoteacher2@marketplacetest.infostudent@marketplacetest.infostudent2@marketplacetest.info
יישלח אליכם אימייל מצוות Marketplace כשהבדיקה תתחיל. אם בודקי המוצר צריכים לבצע שלבי הגדרה כדי להשתמש בחשבונות האלה עם המוצר שלכם, עליכם להשיב לאימייל עם הוראות מפורטות.
השלמת אימות OAuth
שליחה לאימות
הצוות לנושאי מהימנות ובטיחות צריך לבדוק שהתוסף משתמש בהיקפי ההרשאות של OAuth שהאפליקציה מבקשת בצורה מתאימה. מתחילים את האימות ממרכז אימות ההרשאות בפרויקט ב-Google Cloud. לוחצים על הכנה לאימות.
בתיבת דו-שיח לאישור מוצגים הערכים שהוגדרו בדפים 'מיתוג אימות', 'קהל' ו'גישה לנתונים'. מוודאים שהפרטים נכונים ולוחצים על אישור כדי להמשיך.
יצירת קשר עם צוות האימות
צוות אימות OAuth מטפל בבקשת האימות שלכם. הבודקים מתקשרים איתכם באמצעות כתובות האימייל שהגדרתם במסך ההסכמה ל-OAuth. הם יודיעו לכם אם יש בעיות ויעדכנו אתכם כשהאימות יסתיים.
בדרך כלל התהליך הזה נמשך 3-5 ימי עסקים אם משתמשים רק ב היקפי הרשאות רגישים של OAuth. יכול להיות שיידרשו פעולות נוספות וזמן נוסף אם אתם משתמשים ב היקפי הרשאות מוגבלים של OAuth.
השלמת ביקורת ב-Google Workspace Marketplace
שליחה לבדיקה
לוחצים על פרסום בחלק התחתון של הדף Google Workspace Marketplace Store Listing של פרויקט Google Cloud. צוות הבדיקה של Marketplace בודק את התוסף כדי לוודא שהוא עומד בדרישות של Google Workspace ושל התוספים של Classroom.
תקשורת עם צוות הבדיקה
צוות הבדיקה של Marketplace מתקשר ישירות עם כתובת האימייל של המפתח שצוינה בדף App Configuration (הגדרת אפליקציה) ב-Google Workspace Marketplace SDK. תקבלו הודעה אם יש בעיות בתוסף שלכם, או אם הוא אושר לפרסום. מומלץ להקצות לתהליך הזה תקציב של שבועיים-שלושה.
אחרי אישור הפרסום
אחרי האישור ב-Marketplace, דף התוסף שלכם יהיה זמין בכל הדומיינים של Google Workspace for Education באזורים שבחרתם. כדי שהתוסף יופיע בתוצאות החיפוש ובזמן הגלישה, צריך לבטל את הסימון של האפשרות Unlisted (לא רשום) בApp Configuration (הגדרת אפליקציה) ב-Marketplace SDK.