모든 Google Workspace 통합은 Google Cloud를 사용하여 API 액세스를 구성하고, 인증 및 승인을 처리하고, 애플리케이션을 관리합니다. 통합을 테스트하려면 Google 클래스룸에 대한 액세스 권한도 필요할 수 있습니다.
이 가이드에서는 이러한 리소스를 요청하고 구성하는 방법을 설명합니다.
Google Cloud 프로젝트 설정
Google Workspace 개발자를 위한 시작 단계를 완료합니다. 이 단계는 모든 Google Workspace 통합에 필수입니다.
테스트 계정 및 도메인
데모 도메인은 클래스룸 API 통합을 위한 테스트 계정입니다. 데모 도메인은 실제 사용자에게 영향을 주지 않고 통합을 개발하고 테스트하는 데 사용할 수 있는 Google Workspace for Education 구독이 있는 가상의 학교를 나타냅니다.
테스트 도메인을 사용하여 관리자 기능을 테스트하거나 Classroom API로 개발할 수 있습니다.
관리 테스트 도메인 가져오기
API의 관리자 권한만 테스트하면 되는 경우 사전 빌드된 데모 환경을 사용할 수 있습니다. 예를 들어 교사를 대신하여 과정을 만드는 것이 여기에 해당합니다.
사전 빌드된 환경을 사용하려면 Google Cloud 파트너 어드밴티지 프로그램에 가입하세요. 회원은 파트너 어드밴티지의 Google for Education 페이지에 액세스할 수 있습니다. 이 페이지에서는 고객 데모, 제품 문제 해결, 기능 테스트 등에 사용할 수 있는 사전 빌드된 Google Workspace for Education 데모 환경에 액세스하는 방법을 설명합니다.
개발자 데모 도메인 받기
교사 및 학생 사용자를 대신하여 요청하려면 자체 Google Workspace for Education 데모 도메인을 만들고 관리해야 합니다. 데모 도메인에는 무료 영구 Google Workspace for Education Fundamentals 라이선스가 포함됩니다. 필요에 따라 도메인에 제품을 더 추가할 수 있습니다.
개발자 데모 도메인을 받으려면 다음 단계를 완료하세요.
gedu.demo.YOUR DOMAIN 형식으로 도메인을 구매합니다.
예를 들어 myedtech.com 도메인을 운영하는 조직은 gedu.demo.myedtech.com을 만들어야 합니다. 데모 도메인은 다음 형식을 따라야 합니다.
Google Workspace for Education에 가입할 때 지정한 관리자 계정을 사용하여 Google 관리 콘솔에 로그인합니다. 여기에서 새 데모 도메인 사용자를 만듭니다. 교사 역할을 할 사용자 1명과 학생 역할을 할 사용자 2명 등 추가 사용자를 3명 이상 만드는 것이 좋습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-01(UTC)"],[],[],null,["# Prerequisites\n\nAll Google Workspace integrations depend on Google Cloud to configure API\naccess, handle authentication and authorization, and manage applications. You\nmight also need to obtain access to Google Classroom to test your integration.\nThis guide describes how to request and configure these resources.\n\nSet up a Google Cloud project\n-----------------------------\n\n| **Key Point:** You must use a Google Cloud project to manage a Google Classroom integration. You don't need to use any paid Google Cloud features to use Classroom API.\n\nComplete the [steps to get started](/workspace/guides/get-started) for Google Workspace\ndevelopers. These steps are **required** for all Google Workspace\nintegrations.\n\nTest accounts and domains\n-------------------------\n\n| **Key Point:** While standard Gmail accounts can access Google Classroom, you will need a demo domain if you are attempting to test behaviors that only apply to Google Workspace for Education users, such as special administrator capabilities.\n\n**Demo domains** are test accounts for Classroom API integrations. A\ndemo domain represents a fictional school with a Google Workspace for Education subscription you can\nuse for developing and testing integrations without affecting live users.\n\nYou can get a test domain to test administrator capabilities or for development\nwith the Classroom API.\n\n### Get an administrative test domain\n\nYou can use a prebuilt demo environment if you only need to test administrator\npermissions of the API. This includes, for example, creating courses on behalf\nof teachers.\n\nTo use the prebuilt environment, join the Google Cloud [Partner Advantage\nProgram](//www.partneradvantage.goog/GCPPRM/s/partnerselfregistration). Members receive access to the [Google for Education page](//www.partneradvantage.goog/GCPPRM/s/productgoogleeducation) of Partner\nAdvantage. This page describes how to access our prebuilt Google Workspace for\nEducation demo environment that can be used for customer demos, product\ntroubleshooting, feature testing, and more.\n\n### Get a developer demo domain\n\nTo make requests on behalf of teacher and student users, you need to create and\nmanage your own Google Workspace for Education demo domain. Demo domains include a free, permanent\nGoogle Workspace for Education Fundamentals [license](//edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/). More products can be added to the domain as\nneeded.\n\nComplete the following steps to get a developer demo domain.\n\n1. Purchase a domain in the format `gedu.demo.`\u003cvar translate=\"no\"\u003eYOUR DOMAIN\u003c/var\u003e. For example, an organization that operates the domain `myedtech.com` should create `gedu.demo.myedtech.com`. Demo domains must follow this format.\n2. [Sign up for Google Workspace for Education](//workspace.google.com/signup/edu/welcome) using the demo domain. This starts a\n two-week trial period.\n\n | **Important:** The new domain must be a **primary** Google Workspace domain. This means that your demo domain cannot be a subdomain of an existing Google Workspace domain, which are referred to as *secondary* domains. Google cannot grant a demo license to a secondary domain. See the [Choose your primary domain](//support.google.com/a/answer/182080) and [Change your primary domain](//support.google.com/a/topic/6302293) Help Center articles for more information about managing domains used for Google Workspace.\n | **Caution:** Don't wait! Complete the following steps *as soon as possible* after starting the two-week trial period. We can only take action on *active\n | Google Workspace for Education subscriptions*.\n3. [Verify](//support.google.com/a/answer/60216) that you own the demo domain.\n\n4. Fill out this [form](//docs.google.com/a/google.com/forms/d/e/1FAIpQLScFnnpQCCbqw-Phwv3ZOkFkSRnH7JhpyBgPl15M_oZBbC3FjA/viewform) to notify Google of your domain registration.\n\n5. If you are developing an integration that uses paid Google Classroom\n features, [request a demo domain upgrade](#request-demo).\n\n6. Sign in to the [Google Admin console](//admin.google.com/) using the\n administrator account you specified when signing up for Google Workspace for Education. From here,\n [create new demo domain users](//knowledge.workspace.google.com/kb/how-to-create-a-new-user-000007668); we recommend creating at least three\n additional users: one to act as teacher and two students.\n\n7. Sign in to [Google Classroom](//classroom.google.com/) using a new teacher account.\n [Create a new class](//support.google.com/edu/classroom/answer/6020273) and [add your new student accounts](//support.google.com/edu/classroom/answer/6020282) to it.\n\n| **Tip:** Create separate Chrome profiles for your demo domain users so that you can quickly switch between them while using your demo domain.\n\n#### Request a demo domain upgrade for premium features\n\n| **Key Point:** Some Google Classroom features require a paid Google Workspace for Education [license](//edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/). Request an upgrade for your demo domain to be able to test an integration that relies on these features.\n\nUsers must have an appropriate Google Workspace for Education license to use integrations that affect\nor depend on premium Classroom features. These features include:\n\n- Classroom add-ons\n- Grading periods\n- Grading scales\n- Grade export\n- Roster sync\n- Rubrics\n\nSee the [Google Workspace for Education licenses](//edu.google.com/intl/ALL_us/workspace-for-education/editions/compare-editions/) page for the full list of features\navailable at each subscription level.\n\nIf your integration will use any of these features, complete the following steps\nto request a demo domain upgrade. An upgraded domain will be granted ten free\nGoogle Workspace for Education Plus licenses to assign to your test users.\n\n1. Complete the steps to [get a developer demo domain](#get-developer) if you haven't already.\n2. Complete and submit the [demo domain upgrade request form](//docs.google.com/forms/d/e/1FAIpQLSeBARH7nviEOyqFp3OWKVR6m4621UW9ELzUFI_XDu5ENqUUGw/viewform?usp=sf_link). Submitting this form requests that Google upgrade your demo domain to Google Workspace for Education Plus with ten licenses.\n3. You will receive an email when the upgrade process is complete.\n4. Assign Plus licenses to your test teacher accounts in the upgraded demo domain [Admin console](//admin.google.com/).\n 1. Under **Directory \\\u003e Users**, create or select your test teacher account(s).\n 2. In each teacher's **Licenses** , confirm that Google Workspace for Education Plus is **Assigned**."]]
