Hiện tại, các nhà phát triển đã có thể sử dụng rộng rãi tiện ích bổ sung của Google Lớp học! Vui lòng xem tài liệu về tiện ích bổ sung để biết thêm thông tin.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn này mô tả quy trình xem xét tiện ích bổ sung cho Lớp học.
Hãy đọc kỹ vì có những việc bạn phải làm trong thời gian quy định.
Nhóm phụ trách vấn đề Sự tin cậy và An toàn phải xác minh OAuth cho tiện ích bổ sung của bạn và nhóm Google Workspace Marketplace phải phê duyệt tiện ích bổ sung đó. Để biết thông tin chung về quy trình xác minh OAuth, hãy xem Câu hỏi thường gặp về quy trình xác minh OAuth. Để biết thông tin chung về quy trình đánh giá ứng dụng trên Google Workspace Marketplace, hãy xem bài viết Giới thiệu về quy trình đánh giá ứng dụng.
Hoàn tất quá trình phát triển tiện ích bổ sung
Xem các yêu cầu đối với tiện ích bổ sung
Xác nhận rằng hành vi của tiện ích bổ sung đáp ứng các yêu cầu.
Kiểm thử tiện ích bổ sung
Tiện ích bổ sung của bạn sẽ được xem xét theo quy trình trong kế hoạch kiểm thử tiện ích bổ sung của chúng tôi. Làm theo quy trình kiểm thử của tiện ích bổ sung công khai trước khi gửi để xuất bản. Việc không vượt qua các bài kiểm thử này có thể làm tăng đáng kể thời gian cần thiết để tiện ích bổ sung của bạn được phê duyệt.
Quay video minh hoạ
Tạo một bản ghi màn hình minh hoạ cách ứng dụng của bạn sử dụng từng phạm vi OAuth được yêu cầu. Để phát triển một tiện ích bổ sung, bạn nên cho thấy quy trình cài đặt tiện ích bổ sung và việc tạo một tệp đính kèm tiện ích bổ sung.
Sau khi ghi lại, hãy tải bản ghi màn hình lên YouTube dưới dạng video không công khai. Bạn chỉ có thể truy cập vào video không công khai bằng đường liên kết của video đó. Bạn sẽ được nhắc cung cấp đường liên kết đến video khi bắt đầu quy trình xác minh OAuth. Sau đó, nhóm OAuth sẽ xem video này khi xem xét đơn đăng ký tiện ích bổ sung của bạn.
Chuẩn bị xuất bản
Kiểm tra cấu hình dự án Cloud
Xem xét từng chế độ cài đặt cấu hình sau đây trong dự án Google Cloud của bạn.
Đảm bảo rằng trang chủ của ứng dụng không liên kết đến chính ứng dụng mà liên kết đến thông tin về(các) sản phẩm của bạn.
Trên trang Auth Data Access (Quyền truy cập vào dữ liệu uỷ quyền) của dự án trên Cloud:
Bạn chỉ định ít nhất một trong các phạm vi .../auth/userinfo.email hoặc .../auth/userinfo.profilekhông nhạy cảm.
Tất cả các phạm vi khác mà tiện ích bổ sung của bạn yêu cầu đều được chỉ định. Đối với tiện ích bổ sung dành cho Lớp học, bạn nên thêm các phạm vi nhạy cảm.../auth/classroom.addons.teacher và .../auth/classroom.addons.student.
Đối với trường Video minh hoạ, bạn phải cung cấp đường liên kết đến một video trên YouTube minh hoạ cách bạn sử dụng dữ liệu từ các phạm vi được yêu cầu. Cung cấp đường liên kết đến bản ghi màn hình đã ghi trước đó.
Tiện ích bổ sung của Lớp học được đánh dấu trong phần Tích hợp ứng dụng
URI đích cho tiện ích bổ sung của bạn được cung cấp trong URI thiết lập tệp đính kèm.
Tất cả Tiền tố URI tệp đính kèm được phép đều được cung cấp.
Danh sách Phạm vi OAuth hoàn toàn khớp với các phạm vi được chỉ định trong màn hình đồng ý OAuth và trong mã ứng dụng của bạn.
Email của nhà phát triển trong phần Đường liên kết đến nhà phát triển là một địa chỉ email thường xuyên được theo dõi. Nhóm Trang web thương mại sử dụng địa chỉ này để liên hệ với bạn.
Chế độ hiển thị ứng dụng được đặt thành Công khai và hộp Không công khai được đánh dấu.
Cho phép các tài khoản người dùng sau đây của nhóm đánh giá Marketplace truy cập vào ứng dụng của bạn. Ngoài ra, hãy thêm 2 người dùng là giáo viên làm
Người kiểm thử bản nháp cho ứng dụng tiện ích bổ sung của bạn.
teacher@marketplacetest.info
teacher2@marketplacetest.info
student@marketplacetest.info
student2@marketplacetest.info
Bạn sẽ nhận được email của nhóm Marketplace khi họ bắt đầu xem xét. Nếu người đánh giá phải thực hiện bất kỳ bước thiết lập nào để sử dụng các tài khoản này với sản phẩm của bạn, hãy trả lời email kèm theo hướng dẫn chi tiết.
Hoàn tất quy trình xác minh OAuth
Gửi để xác minh
Nhóm phụ trách vấn đề Tin cậy và An toàn phải kiểm tra để đảm bảo tiện ích bổ sung của bạn sử dụng các phạm vi OAuth mà ứng dụng của bạn yêu cầu một cách phù hợp. Bắt đầu quy trình xác minh từ Trung tâm xác minh danh tính của dự án Google Cloud. Nhấp vào Chuẩn bị cho quy trình xác minh.
Một hộp thoại xác nhận liệt kê các giá trị đã định cấu hình từ các trang Thương hiệu xác thực, Đối tượng và Quyền truy cập vào dữ liệu. Xác minh rằng thông tin là chính xác, sau đó nhấp vào Xác nhận để tiếp tục.
Liên hệ với nhóm xác minh
Nhóm xác minh OAuth sẽ xử lý yêu cầu xác minh của bạn. Người đánh giá sẽ liên hệ với bạn bằng địa chỉ email mà bạn đã định cấu hình trong màn hình Đồng ý OAuth. Họ sẽ thông báo cho bạn về mọi vấn đề và thời điểm hoàn tất quy trình xác minh.
Hoàn tất quy trình đánh giá trên Google Workspace Marketplace
Gửi để xem xét
Nhấp vào XUẤT BẢN ở cuối trang
Trang thông tin trên Cửa hàng Google Workspace Marketplace của dự án trên Google Cloud. Nhóm đánh giá của Marketplace sẽ kiểm tra tiện ích bổ sung theo các yêu cầu đối với tiện ích bổ sung của Google Workspace và Lớp học.
Liên hệ với nhóm đánh giá
Nhóm đánh giá của Marketplace sẽ liên hệ trực tiếp với Địa chỉ email của nhà phát triển được chỉ định trong trang
Cấu hình ứng dụng của Google Workspace Marketplace SDK. Bạn sẽ nhận được thông báo về mọi vấn đề liên quan đến tiện ích bổ sung của mình hoặc thông báo rằng tiện ích bổ sung đó đã được phê duyệt để xuất bản. Bạn nên lập ngân sách cho quy trình này trong 2 đến 3 tuần.
Sau khi ấn phẩm được phê duyệt
Sau khi được Marketplace phê duyệt, trang thông tin về tiện ích bổ sung của bạn sẽ xuất hiện trong tất cả các miền Google Workspace for Education ở những khu vực mà bạn đã chọn. Bỏ chọn chế độ Chưa công khai trong phần Cấu hình ứng dụng của Marketplace SDK để trang thông tin về tiện ích bổ sung của bạn xuất hiện trong kết quả tìm kiếm và khi duyệt xem.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
