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