미리보기 기능 및 로드맵

이 페이지에는 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년 4분기 2025년 상반기 V1_20240930_PREVIEW
학생 그룹 관리자 및 교사를 대신하여 학생 그룹과 해당 구성원을 관리합니다. 2025년 3분기 미정 미정

이전 버전

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

기능 설명 GA에 통합됨 타겟 미리보기 종료일 미리보기 버전
기준표 CRUD 교사를 대신하여 클래스룸 루브릭을 생성, 읽기, 업데이트, 삭제합니다. 2024년 12월 5일 2025년 4월 1일 V1_20231110_PREVIEW
평가 기간 관리자 및 교사를 대신하여 평가 기간을 생성, 읽기, 업데이트, 삭제합니다. 2025년 4월 8일 2025년 8월 1일 V1_20240401_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 개발자 프리뷰 프로그램 개요 페이지의 활성 개발자 프리뷰 섹션에 연결된 IssueTracker를 통해 프리뷰 기능에 관한 의견을 공유하세요.

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

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