이 페이지에는 Classroom API의 예정된 기능에 관한 정보와 개발자 프리뷰 참여 방법에 관한 세부정보가 포함되어 있습니다.
Classroom API 미리보기
Classroom API 기능을 미리 보면 개발자가 의견을 통해 기능 개발에 영향을 미치고 정식 출시 전에 공개용 통합을 준비할 수 있습니다.
미리 보기 수명 주기
개발자는 새로운 하위 호환 기능이 포함된 API 버전을 선택할 수 있습니다. 이러한 '미리보기 버전'은 최소 90일 동안 공개적으로 제공됩니다. 의견에 따라 미리보기 버전과 기능이 기존 v1 API에 통합됩니다. 미리보기 버전은 종료되기 전 최소 90일 동안 계속 사용할 수 있습니다.
프리뷰 버전에 대한 의견이 브레이킹 체인지를 요구할 만큼 강력한 경우 기존 기능을 지원하기 위해 새 버전이 생성됩니다. 두 버전 모두 개발자 이전이 가능하도록 최소 90일 동안 제공됩니다. Classroom API 개발자 미리보기 메일링 리스트에 가입하여 미리보기 변경사항을 확인하고 공지사항 목록을 구독하여 일반적인 Classroom API 업데이트를 확인하세요.
Classroom API 미리보기에 참여
참여하려면 Google Workspace 개발자 프리뷰 프로그램에 가입하세요. 사용 가능한 공개 미리보기 기능은 Google Workspace 활성 개발자 미리보기에 나열되어 있습니다. 비공개 미리보기 기능을 테스트하는 경우 해당 기능이 공개 문서에 표시되지 않을 수 있습니다.
출시 예정 기능
예상되는 API 기능과 그 타임라인을 보여주는 로드맵입니다. 이 목록은 주기적으로 업데이트됩니다.
미리보기 버전 값은 버전의 초기 미리보기 사용 가능 예상 날짜를 나타냅니다. 미리보기 버전 사용 방법을 알아보려면 액세스 미리보기 API를 참고하세요.
미리보기 버전의 기능이 v1 API에 통합되면 관련 API 호출에서 previewVersion 인수를 삭제하여 애플리케이션이 예상대로 계속 작동하도록 합니다. 예를 들어 V1_20231110_PREVIEW 버전에서 도입된 평가 기준 생성 기능에 액세스하는 경우 API 호출은 다음과 같을 수 있습니다.
rubric=service.courses().courseWork().rubrics().create(courseId=course_id,courseWorkId=coursework_id,body=body,# Specify the preview version. Rubrics CRUD capabilities are# supported in V1_20231110_PREVIEW and later.previewVersion="V1_20231110_PREVIEW").execute()
[[["이해하기 쉬움","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-29(UTC)"],[],[],null,["# Preview features & roadmap\n\nThis page contains information on upcoming features for the\nClassroom API and details on how to participate in developer preview.\n\nPreview the Classroom API\n-------------------------\n\nPreviewing Classroom API features provides an opportunity for\ndevelopers to influence the shape of feature development with feedback and have\nintegrations ready for public use ahead of general availability.\n\n### Preview lifecycle\n\nDevelopers can opt-in to versions of the API that contain new,\nbackwards-compatible features. These \"preview versions\" are available publicly\nfor at least 90 days. Subject to feedback, the preview version and its features\nare then incorporated into the existing v1 API. Preview versions remain\navailable for at least another 90 days before being shut down.\n\nIf feedback on a preview version is strong enough to require breaking changes, a\nnew version is created to support the existing capabilities. Both versions are\navailable for at least 90 days to allow developer migration. Join the [Classroom\nAPI Developer Preview](https://groups.google.com/g/classroom-developer-preview-external) mailing list to stay informed\nof preview changes and subscribe to the [announcement\nlist](https://groups.google.com/forum/#!forum/classroom-dev-announce) for more general Classroom API\nupdates.\n| **Note:** Preview versions are intended to be temporary while features are validated for general availability in the v1 API. Preview version behavior is subject to change after being shut down.\n\nParticipate in Classroom API previews\n-------------------------------------\n\nTo participate, join the Google Workspace [Developer Preview\nProgram](/workspace/preview#apply). Available public preview features are listed in\nthe Google Workspace [active developer previews](/workspace/preview#active_developer_previews). If you're testing a private\npreview feature, you may not see that feature listed in any public\ndocumentation.\n\nUpcoming features\n-----------------\n\nThis is our roadmap of expected API features and their timelines. It is updated\nperiodically.\n\nThe preview version value represents the expected date for the version's initial\npreview availability. See [Access preview APIs](/workspace/classroom/reference/preview) to learn how preview versions\nare used.\n| **Note:** Roadmap dates are targets, and may be subject to change. Similarly, preview version identifiers might not represent the *exact* date that a version is available.\n\n| Feature | Description | Target for Preview | Target for GA | Preview Version |\n|---------------------------------------------------------------------|---------------------------------------------------------------------------------|--------------------|---------------|-----------------------|\n| User capabilities | Check whether a user has access to certain Classroom features. | 2024 Q4 | 2025 H1 | `V1_20240930_PREVIEW` |\n| [Student groups](/workspace/classroom/guides/manage-student-groups) | Manage student groups and its members on behalf of administrators and teachers. | 2025 Q3 | TBD | `V1_20250630_PREVIEW` |\n\nPrevious versions\n-----------------\n\nOnce new features are validated, the feature is incorporated into the v1 API and\nthe corresponding preview version is shut down. Developers have at least 90 days\nto migrate before the preview version shuts down.\n| **Important:** API calls to shutdown preview versions might not behave as expected. In general, API calls specifying unsupported preview versions should automatically respond with v1 API behavior, but we recommend proactively migrating off shutdown preview API versions to avoid unexpected disruptions. See [migration guidance](#migration-guidance) to learn more.\n\n| Feature | Description | Incorporated into GA | Target preview shutdown date | Preview Version |\n|--------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|----------------------|------------------------------|-----------------------|\n| [Rubrics CRUD](/workspace/classroom/rubrics) | Create, read, update, and delete classroom rubrics on behalf of teachers. | 2024 Dec 05 | 2025 Apr 1 | `V1_20231110_PREVIEW` |\n| [Grading Periods](/workspace/classroom/grading-periods/manage-grading-periods) | Create, read, update, and delete grading periods on behalf of administrators and teachers. | 2025 Apr 8 | 2025 Aug 1 | `V1_20240401_PREVIEW` |\n\n### Migration guidance\n\nOnce features from a preview version are incorporated into the v1 API, remove\nthe `previewVersion` argument from related API calls to ensure that your\napplication continues to behave as expected. For example, if you were accessing\nrubrics creation capabilities introduced in the `V1_20231110_PREVIEW` version,\nyour API calls might have looked as follows: \n\n rubric = service.courses().courseWork().rubrics().create(\n courseId=course_id, courseWorkId=coursework_id, body=body,\n # Specify the preview version. Rubrics CRUD capabilities are\n # supported in V1_20231110_PREVIEW and later.\n previewVersion=\"V1_20231110_PREVIEW\"\n ).execute()\n\nTo migrate to the v1 GA API, remove the `previewVersion` argument: \n\n rubric = service.courses().courseWork().rubrics().create(\n courseId=course_id, courseWorkId=coursework_id, body=body,\n ).execute()\n\nIf you were using a statically generated client library specifically for\naccessing a given preview version feature, and aren't using other preview API\nfeatures, transition to the default client library for your language. See\n[Access preview APIs](/workspace/classroom/reference/preview) to learn more.\n\nFeedback\n--------\n\nShare your feedback for preview features through the linked IssueTracker in the\n[active developer previews](/workspace/preview#active_developer_previews) section of the\nGoogle Workspace Developer Preview Program overview page.\n\nUse Classroom API preview features in production\n------------------------------------------------\n\nIf you'd like to use Classroom API preview features with end users,\nincluding any real teachers, administrators, or students, you must agree to a\nClassroom-specific amendment to the Google Workspace\nGoogle Workspace [Developer Preview Program terms](/workspace/preview#developer_preview_program_terms) by completing and\nsubmitting this form:\nLoading..."]]
