تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا الدليل عملية مراجعة إضافات Classroom.
يُرجى قراءة الرسالة بعناية، لأنّها تتضمّن إجراءات حسّاسة من حيث الوقت يجب اتّخاذها.
يجب أن يتحقّق فريق "الثقة والأمان" من الإضافة باستخدام OAuth وأن يوافق عليها فريق Google Workspace Marketplace. للحصول على معلومات عامة حول عملية التحقّق من OAuth، يُرجى الاطّلاع على الأسئلة الشائعة حول عملية التحقّق من OAuth. للحصول على معلومات عامة حول عملية مراجعة التطبيقات على Google Workspace Marketplace، يُرجى الاطّلاع على لمحة عن مراجعة التطبيقات.
تتم مراجعة الإضافة وفقًا للإجراءات الواردة في خطة اختبار الإضافات. اتّبِع إجراءات الاختبار الخاصة بها مع الإضافة المتاحة للجميع قبل إرسالها للنشر. يمكن أن تؤدي حالات الفشل في هذه الاختبارات إلى زيادة كبيرة في الوقت المطلوب للموافقة على الوظيفة الإضافية.
تسجيل فيديو توضيحي
إنشاء تسجيل شاشة يوضّح كيفية استخدام تطبيقك لكل نطاق OAuth مطلوب. لأغراض تطوير إضافة، ننصحك بعرض عملية تثبيت الإضافة وإنشاء مرفق إضافة.
بعد تسجيل الشاشة، حمِّلوا التسجيل إلى YouTube كفيديو غير مُدرَج. لا يمكن الوصول إلى فيديو غير مُدرَج إلا باستخدام الرابط الخاص به. سيُطلب منك تقديم رابط الفيديو عند بدء عملية تأكيد الحساب باستخدام OAuth. بعد ذلك، يشاهد فريق OAuth الفيديو عند مراجعة طلبك للحصول على إضافة.
التحضير للنشر
التحقّق من إعدادات مشروعك على Google Cloud
راجِع كل إعداد من إعدادات الضبط التالية في مشروع Google Cloud.
تم تحديد نطاق واحد على الأقل من النطاقات .../auth/userinfo.email أو .../auth/userinfo.profileغير الحسّاسة.
يتم تحديد جميع النطاقات الأخرى التي يتطلبها تطبيقك الإضافي. بالنسبة إلى إضافات Classroom، يجب أن يشمل ذلك نطاقَي المعلومات الحساسة.../auth/classroom.addons.teacher و.../auth/classroom.addons.student.
بالنسبة إلى حقل الفيديو التجريبي، يجب تقديم رابط
لفيديو على YouTube يوضّح كيفية استخدام البيانات من
نطاقات الوصول المطلوبة. قدِّم رابطًا إلى تسجيل الشاشة الذي تم إجراؤه سابقًا.
امنح حسابات المستخدمين التالية التابعة لفريق مراجعة Marketplace إذن الوصول إلى تطبيقك. أضِف أيضًا حسابَي المعلّمين كمختبِرين
للتطبيق التجريبي الخاص بإضافة Google Workspace.
teacher@marketplacetest.info
teacher2@marketplacetest.info
student@marketplacetest.info
student2@marketplacetest.info
ستتلقّى رسالة إلكترونية من فريق Marketplace عندما يبدأ المراجعة. إذا كان على المراجعين اتّباع أي خطوات إعداد لاستخدام هذه الحسابات مع منتجك، يُرجى الردّ على الرسالة الإلكترونية مع تضمين تعليمات تفصيلية.
إكمال عملية التحقّق من OAuth
إرسال طلب لإثبات الملكية
يجب أن يتأكّد فريق الثقة والسلامة من أنّ الإضافة تستخدم بشكل مناسب نطاقات OAuth التي يطلبها تطبيقك. ابدأ عملية إثبات الملكية من مركز إثبات الملكية في مشروعك على Google Cloud. انقر على الاستعداد لإثبات الملكية.
يعرض مربّع حوار تأكيد القيم التي تم ضبطها من صفحات "العلامة التجارية للمصادقة" و"الجمهور" و"الوصول إلى البيانات". تأكَّد من صحة المعلومات، ثم انقر على تأكيد للمتابعة.
التواصل مع فريق التحقّق
يعالج فريق التحقّق من OAuth طلب التحقّق الذي أرسلته. يتواصل المراجعون معك باستخدام عناوين البريد الإلكتروني التي تم ضبطها في
شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth. وسيُطلعونك على أي مشاكل وعند اكتمال عملية التحقّق.
انقر على نشر في أسفل صفحة
بطاقة بيانات المتجر في Google Workspace Marketplace الخاصة بمشروعك على Google Cloud. يختبر فريق المراجعة في Marketplace الإضافة للتأكّد من استيفائها لمتطلبات إضافات Google Workspace وClassroom.
التواصل مع فريق المراجعة
يتواصل فريق المراجعة في Marketplace مباشرةً مع عنوان البريد الإلكتروني للمطوّر المحدّد في صفحة
إعدادات التطبيق
في حزمة تطوير البرامج (SDK) في
Google Workspace Marketplace. سيتم إعلامك بأي مشاكل متعلّقة بالإضافة، أو لإخبارك بأنّه تمت الموافقة على نشرها. ننصحك بتخصيص ميزانية لمدة تتراوح بين أسبوعَين و3 أسابيع لهذه العملية.
بعد الموافقة على النشر
بعد الموافقة على تطبيقك في Marketplace، يصبح إدراج تطبيقك الإضافي متاحًا في جميع نطاقات Google Workspace for Education في المناطق التي اخترتها. أزِل العلامة من المربّع بجانب الخيار غير مُدرَج في إعدادات التطبيق ضمن حزمة تطوير البرامج (SDK) في Marketplace، وذلك لجعل بطاقة بيانات الإضافة تظهر في نتائج البحث وعند التصفّح.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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."]]
