이 페이지에는 Classroom API의 출시 예정 기능에 대한 정보와 개발자 프리뷰에 참여하는 방법에 대한 세부정보가 포함되어 있습니다.
Classroom API 미리보기
개발자는 Classroom API 기능을 미리 보기를 통해 의견을 제공하여 기능 개발에 영향을 미치고 정식 버전 출시 전에 통합을 준비할 수 있습니다.
미리보기 수명 주기
개발자는 새로운 이전 버전과 호환되는 기능이 포함된 API 버전을 선택할 수 있습니다. 이러한 '미리보기 버전'은 최소 90일 동안 공개적으로 제공됩니다. 의견에 따라 미리보기 버전과 해당 기능이 기존 v1 API에 통합됩니다. 미리보기 버전은 종료되기 전에 최소 90일 동안 계속 사용할 수 있습니다.
미리보기 버전에 대한 의견이 변경사항을 요구할 만큼 충분히 강력한 경우 기존 기능을 지원하기 위해 새 버전이 생성됩니다. 개발자 마이그레이션을 허용하기 위해 두 버전 모두 최소 90일 동안 제공됩니다. Classroom API 개발자 프리뷰 메일링 리스트에 가입하여 미리보기 변경사항을 확인하고 공지사항 리스트를 구독하여 더 일반적인 Classroom API 업데이트를 확인하세요.
Classroom API 미리보기에 참여
참여하려면 Google Workspace 개발자 프리뷰 프로그램에 가입하세요. 사용 가능한 공개 미리보기 기능은 Google Workspace 활성 개발자 미리보기에 나열되어 있습니다. 비공개 미리보기 기능을 테스트하는 경우 공개 문서에 해당 기능이 나열되지 않을 수 있습니다.
출시 예정 기능
예상되는 API 기능과 타임라인을 보여주는 로드맵입니다. 정기적으로 업데이트됩니다.
미리보기 버전 값은 버전의 초기 미리보기 사용 가능일로 예상되는 날짜를 나타냅니다. 미리보기 버전이 사용되는 방법을 알아보려면 미리보기 API 액세스를 참고하세요.
| 기능 | 설명 | 미리보기 목표 | 정식 버전 목표 | 미리보기 버전 |
|---|---|---|---|---|
| 사용자 기능 | 사용자가 특정 클래스룸 기능에 액세스할 수 있는지 확인합니다. | 2024년 4분기 | 2025년 상반기 | V1_20240930_PREVIEW |
| 학습 목표 | 과정의 학습 표준과 CourseWork 및 기준표의 학습 목표를 설정합니다. | 2026년 3분기 | 2026년 4분기 | V1_20260316_PREVIEW |
이전 버전
새 기능이 검증되면 해당 기능이 v1 API에 통합되고 해당 미리보기 버전이 종료됩니다. 개발자는 미리보기 버전이 종료되기 전에 최소 90일 동안 마이그레이션할 수 있습니다.
| 기능 | 설명 | 정식 버전에 통합됨 | 미리보기 종료 목표일 | 미리보기 버전 |
|---|---|---|---|---|
| 기준표 CRUD | 교사를 대신하여 클래스룸 기준표를 생성, 읽기, 업데이트, 삭제합니다. | 2024년 12월 5일 | 2025년 4월 1일 | V1_20231110_PREVIEW |
| 평가 기간 | 관리자와 교사를 대신하여 평가 기간을 생성, 읽기, 업데이트, 삭제합니다. | 2025년 4월 8일 | 2025년 8월 1일 | V1_20240401_PREVIEW |
| 학생 그룹 | 관리자와 교사를 대신하여 학생 그룹과 그룹 구성원을 관리합니다. | 2026년 1월 26일 | 2026년 6월 1일 | V1_20250630_PREVIEW |
마이그레이션 가이드
미리보기 버전의 기능이 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()
v1 정식 버전 API로 마이그레이션하려면 previewVersion 인수를 삭제합니다.
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
특정 미리보기 버전 기능에 액세스하기 위해 정적으로 생성된 클라이언트 라이브러리를 사용하고 다른 미리보기 API 기능을 사용하지 않는 경우 언어의 기본 클라이언트 라이브러리로 전환합니다. 자세한 내용은 미리보기 API 액세스를 참고하세요.
의견
Google Workspace 개발자 프리뷰 프로그램 개요 페이지의 활성 개발자 미리보기 섹션에 연결된 IssueTracker를 통해 미리보기 기능에 대한 의견을 공유하세요.
프로덕션에서 Classroom API 미리보기 기능 사용
실제 교사, 관리자, 학생을 비롯한 최종 사용자와 함께 Classroom API 미리보기 기능을 사용하려면 이 양식을 작성하고 제출하여 Google Workspace Google Workspace 개발자 프리뷰 프로그램 약관에 대한 클래스룸 관련 수정사항에 동의해야 합니다.