미리보기 기능 및 로드맵

이 페이지에는 Classroom API의 예정된 기능에 관한 정보와 개발자 프리뷰에 참여하는 방법에 관한 세부정보가 포함되어 있습니다.

Classroom API 미리보기

Classroom API 기능을 미리 보면서 개발자는 의견을 통해 기능 개발의 방향에 영향을 미치고 정식 버전 출시 전에 공개적으로 사용할 수 있는 통합을 준비할 수 있습니다.

미리보기 수명 주기

개발자는 이전 버전과 호환되는 새로운 기능이 포함된 API 버전을 선택할 수 있습니다. 이러한 '미리보기 버전'은 최소 90일 동안 공개적으로 제공됩니다. 의견을 바탕으로 미리보기 버전과 기능이 기존 v1 API에 통합됩니다. 미리보기 버전은 지원 중단되기 최소 90일 전에 계속 사용할 수 있습니다.

미리보기 버전에 대한 의견이 브레이킹 체인지가 필요할 만큼 강력한 경우 기존 기능을 지원하기 위해 새 버전이 만들어집니다. 개발자 이전을 위해 두 버전 모두 최소 90일 동안 사용할 수 있습니다. Classroom API 개발자 미리보기 메일링리스트에 가입하여 미리보기 변경사항을 확인하고 공지사항 목록을 구독하여 더 일반적인 Classroom API 업데이트를 확인하세요.

Classroom API 미리보기 참여

참여하려면 Google Workspace 개발자 프리뷰 프로그램에 가입하세요. 사용 가능한 공개 미리보기 기능은 Google Workspace 활성 개발자 프리뷰에 나와 있습니다. 비공개 미리보기 기능을 테스트하는 경우 해당 기능이 공개 문서에 표시되지 않을 수 있습니다.

출시 예정 기능

다음은 예상되는 API 기능과 타임라인에 관한 로드맵입니다. 주기적으로 업데이트됩니다.

미리보기 버전 값은 버전의 최초 미리보기 사용 가능 날짜를 나타냅니다. 미리보기 버전이 사용되는 방식을 알아보려면 미리보기 API 액세스를 참고하세요.

기능	설명	미리보기 타겟	GA 타겟	미리보기 버전
평가 기간	관리자 및 교사를 대신하여 평가 기간을 생성, 읽기, 업데이트, 삭제합니다.	2024년 상반기	TBD	V1_20240401_PREVIEW
사용자 기능	사용자가 특정 클래스룸 기능에 액세스할 수 있는지 확인합니다.	2024년 4분기	2025년 상반기	V1_20240930_PREVIEW

이전 버전

새 기능이 검증되면 기능이 v1 API에 통합되고 해당 미리보기 버전이 종료됩니다. 개발자는 미리보기 버전이 종료되기 전에 최소 90일 동안 이전할 수 있습니다.

기능	설명	GA에 통합됨	타겟 미리보기 종료일	미리보기 버전
기준표 CRUD	교사를 대신하여 교실 평가 기준을 생성, 읽기, 업데이트, 삭제합니다.	2024년 12월 5일	2025년 4월 1일	V1_20231110_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 GA API로 이전하려면 previewVersion 인수를 삭제합니다.

rubric = service.courses().courseWork().rubrics().create(
        courseId=course_id, courseWorkId=coursework_id, body=body,
        ).execute()

특정 미리보기 버전 기능에 액세스하기 위해 정적 생성 클라이언트 라이브러리를 사용하고 있고 다른 미리보기 API 기능을 사용하지 않는 경우 언어의 기본 클라이언트 라이브러리로 전환하세요. 자세한 내용은 액세스 미리보기 API를 참고하세요.

의견

Google Workspace Developer Preview 프로그램 개요 페이지의 활성 개발자 프리뷰 섹션에 있는 연결된 IssueTracker를 통해 미리보기 기능에 관한 의견을 공유하세요.

프로덕션에서 Classroom API 미리보기 기능 사용

실제 교사, 관리자, 학생을 비롯한 최종 사용자와 함께 Classroom API 미리보기 기능을 사용하려면 이 양식을 작성하고 제출하여 Google Workspace 개발자 미리보기 프로그램 약관의 클래스룸 관련 개정안에 동의해야 합니다.