במדריך הזה מוסבר תהליך הבדיקה של תוספים ל-Classroom. חשוב לקרוא את ההודעה בעיון, כי יש בה פעולות שצריך לבצע תוך פרק זמן מוגבל.
התוסף שלכם צריך לעבור אימות OAuth על ידי צוות האמון והבטיחות, ולקבל אישור מצוות Google Workspace Marketplace. מידע כללי על אימות OAuth זמין במאמר שאלות נפוצות בנושא אימות OAuth. מידע כללי על תהליך בדיקת האפליקציות ב-Google Workspace Marketplace זמין במאמר מידע על בדיקת אפליקציות.
סיום פיתוח התוסף
בדיקת הדרישות לתוסף
מוודאים שההתנהגות של התוסף עומדת בדרישות.
בדיקת התוסף
התוסף שלך נבדק בהתאם לתהליכים שמופיעים בתוכנית הבדיקה של התוספים שלנו. לפני ששולחים את התוסף הציבורי לפרסום, צריך לפעול לפי הנהלים לבדיקה שלו. אם הבדיקות האלה ייכשלו, יכול להיות שיידרש זמן רב יותר לאישור התוסף.
הקלטת סרטון הדגמה
ליצור הקלטת מסך שמדגימה איך האפליקציה משתמשת בכל היקף OAuth שנדרש. לצורך פיתוח תוסף, מומלץ להציג את תהליך ההתקנה של התוסף ואת יצירת הקובץ המצורף של התוסף.
אחרי ההקלטה, מעלים את הקלטת המסך ל-YouTube כסרטון לא רשום. אפשר להגיע לסרטון לא רשום רק דרך הקישור שלו. תתבקשו להזין את הקישור לסרטון כשמתחילים את תהליך האימות של OAuth. צוות OAuth צופה בסרטון במהלך הבדיקה של בקשת התוסף.
הכנה לפרסום
בדיקת ההגדרה של הפרויקט ב-Cloud
בודקים כל אחת מהגדרות התצורה הבאות בפרויקט 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
בדף Google Workspace Marketplace SDK App Configuration:
- האפשרות Classroom add-on (תוסף ל-Classroom) מסומנת בקטע App Integration (שילוב אפליקציות).
- ה-URI של דף הנחיתה של התוסף מופיע בURI של הגדרת הקובץ המצורף.
- כל הקידומות של כתובות ה-URI של הקבצים המצורפים המותרים מסופקות.
- הרשימה של היקפי OAuth זהה בדיוק להיקפים שצוינו במסך ההסכמה של OAuth ובקוד האפליקציה.
- כתובת האימייל של המפתח בקטע Developer Links היא כתובת אימייל שנבדקת באופן קבוע. צוות זירת המסחר משתמש בכתובת הזו כדי ליצור איתך קשר.
- החשיפה של האפליקציה מוגדרת לגלוי לכולם והתיבה לא רשום מסומנת.
צריך לוודא שדף Google Workspace Marketplace Store Listing של הפרויקט עומד בדרישות של Listing considerations.
מתן גישה למבקר
צריך לאפשר לחשבונות המשתמשים הבאים של צוות הבדיקה של Marketplace גישה לאפליקציה. כדאי גם להוסיף את שני המשתמשים עם תפקיד המורה כ בודקי טיוטה באפליקציית התוסף.
teacher@marketplacetest.info
teacher2@marketplacetest.info
student@marketplacetest.info
student2@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 באזורים שבחרתם. כדי שהתוסף יופיע בתוצאות החיפוש ובזמן הגלישה, מבטלים את הסימון של האפשרות לא רשום בהגדרת האפליקציה ב-Marketplace SDK.