קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במדריך הזה מוסבר תהליך הבדיקה של תוספים ל-Classroom.
חשוב לקרוא את ההודעה בעיון, כי יש בה פעולות שצריך לבצע תוך פרק זמן מוגבל.
התוסף שלכם צריך לעבור אימות OAuth על ידי צוות Trust & Safety ולקבל אישור מצוות Google Workspace Marketplace. מידע כללי על אימות OAuth זמין במאמר שאלות נפוצות בנושא אימות OAuth. מידע כללי על תהליך בדיקת האפליקציות ב-Google Workspace Marketplace זמין במאמר מידע על בדיקת אפליקציות.
התוסף שלך נבדק בהתאם לתהליכים שמתוארים בתוכנית הבדיקה של התוספים שלנו. לפני ששולחים את התוסף לפרסום, צריך לפעול לפי הנהלים לבדיקה של התוסף. אם הבדיקות האלה ייכשלו, יכול להיות שיידרש זמן רב יותר לאישור התוסף.
הקלטת סרטון הדגמה
ליצור הקלטת מסך שמדגימה איך האפליקציה משתמשת בכל היקף OAuth שנדרש. לצורך פיתוח תוסף, מומלץ להציג את תהליך ההתקנה של התוסף ואת יצירת הקובץ המצורף של התוסף.
אחרי ההקלטה, מעלים את הקלטת המסך ל-YouTube כסרטון לא רשום. אפשר להגיע לסרטון לא רשום רק דרך הקישור שלו. תתבקשו להזין את הקישור לסרטון כשמתחילים את תהליך האימות של OAuth. צוות OAuth צופה בסרטון במהלך הבדיקה של בקשת התוסף.
הכנה לפרסום
בדיקת ההגדרה של הפרויקט ב-Cloud
בודקים כל אחת מהגדרות התצורה הבאות בפרויקט Google Cloud.
צריך לציין לפחות אחד מהיקפי ההרשאות .../auth/userinfo.email או .../auth/userinfo.profileשאינם רגישים.
כל שאר ההיקפים שנדרשים על ידי התוסף שלכם מצוינים. במקרה של תוספים ל-Classroom, צריך לכלול את היקפי ההרשאות המסווגים כרגישים.../auth/classroom.addons.teacher ו-.../auth/classroom.addons.student.
בשדה סרטון הדגמה, צריך לספק קישור לסרטון ב-YouTube שמדגים איך משתמשים בנתונים מההיקפים המבוקשים. צריך לספק את הקישור לצילום המסך שצולם קודם.
צריך לאפשר לחשבונות המשתמשים הבאים של צוות הבדיקה של Marketplace גישה לאפליקציה שלכם. כדאי גם להוסיף את שני המשתמשים עם תפקיד המורה כ
בודקי טיוטה באפליקציית התוסף.
teacher@marketplacetest.info
teacher2@marketplacetest.info
student@marketplacetest.info
student2@marketplacetest.info
צוות Marketplace ישלח לכם אימייל כשהבדיקה תתחיל. אם בודקי התאימות צריכים לבצע שלבי הגדרה כלשהם כדי להשתמש בחשבונות האלה עם המוצר שלך, עליך להשיב לאימייל עם הוראות מפורטות.
השלמת אימות OAuth
שליחה לאימות
הצוות לנושאי מהימנות ובטיחות צריך לבדוק שהתוסף משתמש בהיקפי ההרשאות של OAuth שהאפליקציה מבקשת בצורה מתאימה. מתחילים את האימות ממרכז אימות ההרשאות בפרויקט ב-Google Cloud. לוחצים על הכנה לאימות.
בתיבת דו-שיח לאישור מפורטים הערכים שהוגדרו בדפים 'מיתוג של אימות', 'קהל' ו'גישה לנתונים'. מוודאים שהפרטים נכונים ולוחצים על אישור כדי להמשיך.
יצירת קשר עם צוות האימות
צוות אימות OAuth מעבד את בקשת האימות. הבודקים יתקשרו איתכם באמצעות כתובות האימייל שהגדרתם במסך ההסכמה ל-OAuth. הם יודיעו לכם אם יש בעיות וגם כשהאימות יושלם.
לוחצים על פרסום בחלק התחתון של הדף
Google Workspace Marketplace Store Listing בפרויקט Google Cloud. צוות הבדיקה של Marketplace בודק את התוסף כדי לוודא שהוא עומד בדרישות של תוספים ל-Google Workspace ול-Classroom.
תקשורת עם צוות הבדיקה
צוות הבדיקה של Marketplace מתקשר ישירות עם כתובת האימייל של המפתח שצוינה בדף
App Configuration (הגדרת האפליקציה) ב-SDK של Google Workspace Marketplace. תקבלו הודעה אם יש בעיות בתוסף שלכם, או אם הוא אושר לפרסום. מומלץ להקצות לתהליך הזה תקציב של שבועיים-שלושה.
אחרי אישור הפרסום
אחרי האישור של Marketplace, דף התוסף שלכם יהיה זמין בכל הדומיינים של Google Workspace for Education באזורים שבחרתם. כדי שהתוסף יופיע בתוצאות החיפוש ובזמן הגלישה, מבטלים את הסימון של האפשרות לא רשום בהגדרת האפליקציה ב-Marketplace SDK.
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Review process\n\nThis guide describes the review process for Classroom add-ons.\nRead through carefully, as there are time-sensitive actions that you must\nperform.\n| **Key Point:** Thoroughly review the items in this guide *before publishing your\n| add-on*.\n\nYour add-on must be OAuth verified by the Trust \\&\nSafety team and approved by the Google Workspace Marketplace team. For general\ninformation about OAuth verification, see the [OAuth verification FAQ](//support.google.com/cloud/answer/9110914#zippy=%2Csteps-for-apps-requesting-sensitive-scopes%2Csteps-to-prepare-for-verification). For\ngeneral information about the Google Workspace Marketplace app review process\nsee [About app review](/workspace/marketplace/about-app-review).\n\nFinalize add-on development\n---------------------------\n\n\u003cbr /\u003e\n\n#### Review add-on requirements\n\nConfirm that your add-on behavior meets the\n[requirements](/workspace/classroom/add-ons/requirements).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Test your add-on\n\nYour add-on is reviewed according to the\nprocedures in our\n[add-ons test plan](/static/workspace/classroom/assets/classroom_add_ons_test_plan.pdf). Follow its testing\nprocedures with your public add-on before\nsubmitting for publication. Failures in these tests can significantly\nincrease the time required for your add-on to be\napproved.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| **Key Point:** The add-ons test plan contains the same tests used by the Google Workspace Marketplace review team. You should proactively test that your add-on produces expected behaviors in all applicable tests.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Record a demo video\n\nCreate a screen recording demonstrating how your application uses each\nrequested OAuth scope. For the purposes of developing an\nadd-on, we recommend showing the\nadd-on installation flow and creation of an\nadd-on attachment.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nOnce recorded, upload the screen recording to YouTube as an\n*unlisted* video to YouTube. An unlisted video can only be reached\nusing its link. You'll be prompted for the video link when starting the\nOAuth verification process. The OAuth team then views the video when\nreviewing your add-on application.\n\n\u003cbr /\u003e\n\nPrepare for publication\n-----------------------\n\n\u003cbr /\u003e\n\n#### Check your Cloud project configuration\n\nReview each of the following configuration settings in your\n**Google Cloud project**.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| **Caution:** When checking these configuration settings, make sure the correct Cloud project is selected at the top of the Google Cloud console.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n- In your Cloud project's [Auth Audience](//console.cloud.google.com/auth/audience) page:\n - Publishing status is **In production**.\n - User type is **External**.\n- In your Cloud project's [Auth Branding](//console.cloud.google.com/auth/branding) page:\n - All required fields are complete.\n - Ensure that your application home page doesn't link to the app itself, but rather to information about your product(s).\n- In your Cloud project's [Auth Data Access](//console.cloud.google.com/auth/scopes) page:\n - At least one of the `.../auth/userinfo.email` or `.../auth/userinfo.profile` **non-sensitive** scopes are specified.\n - *All other scopes* required by your add-on are specified. For Classroom add-ons, this should include the **sensitive** `.../auth/classroom.addons.teacher` and `.../auth/classroom.addons.student` scopes.\n - For the **Demo video** field, you must provide a link to a YouTube video that demonstrates how you use the data from the requested scopes. Provide the link to the screencast recorded earlier.\n- The following [API libraries](//console.cloud.google.com/apis/library) are **Enabled** :\n - [Google Classroom API](//console.cloud.google.com/apis/library/classroom.googleapis.com)\n - [Google Workspace Marketplace SDK](//console.cloud.google.com/apis/library/appsmarket-component.googleapis.com)\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Check your Marketplace SDK\nsettings\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| **Caution:** When checking these configuration settings, make sure the correct Cloud project is selected at the top of the Google Cloud console page.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nIn your\n[Google Workspace Marketplace SDK App Configuration](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk) page:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n- **Classroom add-on** is checked under App Integration\n- The landing URI for your add-on is provided in the **Attachment Setup URI**.\n- All **Allowed Attachment URI Prefixes** are provided.\n- The list of **OAuth Scopes** exactly matches the scopes specified in the OAuth consent screen and in your application code.\n- The **Developer Email** under Developer Links is a *regularly monitored* email address. The Marketplace team uses this address to communicate with you.\n- App Visibility is set to **Public** and the **Unlisted** box is checked.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nCheck that your project's\n[Google Workspace Marketplace Store Listing](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish) page complies with the\n[Listing considerations](/workspace/classroom/add-ons/developer-guides/project-configuration#workspace_marketplace_name-listing).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Allow reviewer access\n\nAllow the following Marketplace review team user\naccounts access to your application. Also add the two teacher users as\n[Draft Testers](/workspace/marketplace/manage-app-listing#draft-app-listing) for your add-on application.\n\n- `teacher@marketplacetest.info`\n- `teacher2@marketplacetest.info`\n- `student@marketplacetest.info`\n- `student2@marketplacetest.info`\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nYou'll receive an email from the Marketplace\nteam when they begin their review. If the reviewers must perform any setup\nsteps to use these accounts with your product, reply to the email with\ndetailed instructions.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| **Important:** Reviewers may connect to your application from Argentina, Canada, and the United States. Ensure these regions are not blocked in your implementation and allowed under **Distribution** in the Marketplace SDK [Store Listing](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish) page. You can change the Distribution configuration after your add-on is approved.\n\n\u003cbr /\u003e\n\nComplete OAuth verification\n---------------------------\n\n\u003cbr /\u003e\n\n#### Submit for verification\n\nThe Trust \\& Safety team must check that your add-on\nappropriately uses the OAuth scopes that your application requests. Initiate\nverification from your Google Cloud project's\n[Auth Verification\nCenter](//console.cloud.google.com/auth/verification). Click **Prepare for verification**.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nA confirmation dialog lists the configured values from the Auth Branding,\nAudience, and Data Access pages. Verify that the information is correct,\nthen click **Confirm** to proceed.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Communicate with the verification team\n\nThe OAuth verification team processes your verification request. The\nreviewers communicate with you using the email addresses configured in your\nOAuth Consent screen. They will inform you of any concerns and when\nverification is complete.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThis process typically requires 3-5 working days if you are only using\n[Sensitive OAuth scopes](/identity/protocols/oauth2/production-readiness/sensitive-scope-verification). Additional time and actions may be required if\nyou are using any\n[Restricted OAuth scopes](/identity/protocols/oauth2/production-readiness/restricted-scope-verification).\n\n\u003cbr /\u003e\n\nComplete Google Workspace Marketplace review\n--------------------------------------------\n\n\u003cbr /\u003e\n\n#### Submit for review\n\n| **Tip:** You can apply for Marketplace review and OAuth verification simultaneously. However, your application must complete OAuth verification before it can receive final Marketplace approval.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nClick **PUBLISH** at the bottom of your Google Cloud project's\n[Google Workspace Marketplace Store Listing](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish) page. The\nMarketplace review team tests the\nadd-on against Google Workspace and\nClassroom add-on requirements.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Communicate with the review team\n\nThe Marketplace review team communicates directly\nwith the Developer Email address specified in the\nGoogle Workspace Marketplace SDK\n[App Configuration](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk) page. You are notified about any concerns with your\nadd-on, or to inform you that it has been approved\nfor publication. We recommend budgeting 2-3 weeks for this process.\n\n\u003cbr /\u003e\n\nAfter publication approval\n--------------------------\n\nAfter Marketplace approval, your\nadd-on listing is available in all Google Workspace for Education\ndomains in the regions you selected. Unselect the **Unlisted** option in the\nMarketplace SDK [App Configuration](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk) to make your\nadd-on listing appear in search results and when\nbrowsing."]]
