您需要使用 Teaching & Learning 或 Plus 版本的 Google Workspace for Education 測試使用者。如果您沒有這兩種授權的 Google Workspace for Education 網域管理員存取權,請完成取得開發人員測試網域的步驟,然後提交網域升級要求表單。系統會為網域佈建 10 個 Google Workspace for Education Plus 授權。
[null,null,["上次更新時間:2025-08-29 (世界標準時間)。"],[],[],null,["# Developer journey\n\nThe following is a quick overview of steps when developing a\nClassroom add-on.\n| **Important:** Subscribe to the Google for Education [Developer Announcement group](//groups.google.com/g/classroom-dev-announce) to receive updates about add-ons and Google Classroom API.\n\nOnboarding\n----------\n\n1. You will need test users with the Teaching \\& Learning or Plus [editions of\n Google Workspace for Education](//edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/). If you don't have administrator access to a Google Workspace for Education domain with either of these licenses, complete the steps to [get a\n developer test domain](/workspace/classroom/support/access#get_a_developer_test_domain) and then submit our [domain upgrade request form](//docs.google.com/forms/d/e/1FAIpQLSeBARH7nviEOyqFp3OWKVR6m4621UW9ELzUFI_XDu5ENqUUGw/viewform?usp=sf_link). The domain will be provisioned with 10 Google Workspace for Education Plus licenses.\n2. Configure your test domain to [allow users to install all\n Marketplace applications](https://support.google.com/a/answer/172931) so that you can install and test your app before it's published. If you want to test the app installation process with more restrictive domain settings, you can change this setting after publishing your app.\n3. [Create teacher and student accounts](/workspace/classroom/add-ons/developer-guides/project-configuration#test_accounts) for testing. Once the license is approved for your demo domain, [assign seats to each of your test accounts](//support.google.com/a/answer/1727173).\n4. [Create a Google Cloud project](/workspace/classroom/add-ons/developer-guides/project-configuration#project-creation). You'll use it configure\n your add-on, make API requests, and authenticate and authorize users. You\n can use also an existing Cloud project.\n\n | **Warning:** Pay particular attention to the **App Visibility** . This setting controls whether your add-on will be accessible by end users and *cannot be\n | changed later*.\n5. [Configure OAuth](/workspace/classroom/add-ons/developer-guides/project-configuration#oauth) for your project.\n\n6. [Create a Google Workspace Marketplace listing](/workspace/classroom/add-ons/developer-guides/project-configuration#workspace_marketplace_name-listing) for the\n demo project.\n\n - If you set the App Visibility to **public** , add the email addresses of *all* test users to the list of **Draft testers** . Choose **SAVE DRAFT** when finished.\n\n | **Key Point:** A project in **draft** state lets you preview and test changes before publishing them. See [Update your app listing with drafts](/workspace/marketplace/manage-app-listing#update_your_app_listing_with_drafts) for more information about this feature.\n7. Sign in to your demo domain as a test user. Install your add-on from the\n **App URL** in your Google Workspace Marketplace listing configuration.\n\nDevelopment\n-----------\n\n7. Develop the add-on and test it with your test users.\n\nPublishing\n----------\n\n8. In the [Google Cloud project you want to publish](/workspace/classroom/add-ons/developer-guides/project-configuration#create_a_public_gcp_project), ensure the following:\n 1. OAuth consent screen:\n 1. User Type: **External**\n 2. Publish Status: **In Production**\n 3. Scopes: [Configure **all** scopes](/workspace/classroom/add-ons/developer-guides/project-configuration#required_classroom_add-ons_scopes) requested by the web app.\n 2. Google Workspace Marketplace SDK App Configuration Screen:\n 1. App Visibility: **Public**\n 2. Listing Type: **Unlisted**\n 3. Scopes: [Configure **all** scopes](/workspace/classroom/add-ons/developer-guides/project-configuration#required_classroom_add-ons_scopes) requested by the web app.\n9. [Create a Google Workspace Marketplace listing](/workspace/classroom/add-ons/developer-guides/project-configuration#google_workspace_marketplace_listing) for the public project. Add your test user accounts as Marketplace SDK Draft testers. Save your changes **as a Draft**.\n10. Update the public project with your add-on code.\n11. As one of the Draft testers, install the add-on by visiting its [Marketplace listing URL](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish).\n12. Submit an [OAuth verification request](/workspace/classroom/add-ons/developer-guides/review-process-overview#complete_oauth_verification) for your public project. You will need to record a short video demonstrating the use of the add-ons scopes using one of the Draft tester accounts.\n13. [Publish the public add-on](/workspace/classroom/add-ons/developer-guides/review-process-overview#complete-review) for Marketplace review.\n14. Upon approval, change the Marketplace SDK Listing status to **listed**.\n\nRequired integrations\n---------------------\n\nThe following are required to build a Classroom add-on.\n\n1. Google Single Sign-On\n\n - [Google Identity Platform](/identity/choose-auth). Google offers a variety of authentication options.\n - [Integration case studies](/identity/sign-in/case-studies).\n\n See the [frictionless sign-in page](/workspace/classroom/add-ons/developer-guides/frictionless-signin) for information about how to implement\n sign-in following best practices.\n2. Submission to Google Workspace Marketplace as a\n Classroom add-on\n\n3. iframe implementations\n\n - [Attachment Discovery](/workspace/classroom/add-ons/get-started/iframes/attachment-discovery-iframe)\n - [Teacher View](/workspace/classroom/add-ons/get-started/iframes/teacher-iframe)\n - [Student View](/workspace/classroom/add-ons/get-started/iframes/student-iframe)\n - [Student Work Review](/workspace/classroom/add-ons/get-started/iframes/grader-iframe). The Student Work Review iframe is only required if the attachment provides an activity-type attachment.\n\nGoogle Workspace Marketplace\n----------------------------\n\nThe [Google Workspace Marketplace](/marketplace) showcases enterprise applications\nthat can be added to an entire domain or to individual Google Workspace\naccounts. The Marketplace\nis integrated with the [Google Admin console](//admin.google.com/) so that domain\nadministrators can quickly find, install, and authorize apps for targeted users.\n\nSome key concepts to be familiar with are:\n\n- [OAuth](/workspace/classroom/add-ons/developer-guides/project-configuration#oauth) behavior and requirements.\n- The [Google Workspace Marketplace developer documentation](/workspace).\n- The [education section](//workspace.google.com/marketplace/category/education) of Google Workspace Marketplace."]]