이제 Google 클래스룸 부가기능이 일반적으로 개발자에게 제공됩니다. 자세한 내용은
부가기능 문서를 참고하세요.
출시 노트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에는 클래스룸 API 출시 노트가 포함되어 있습니다. 공지사항 목록을 구독하여 이메일 업데이트를 받으세요.
2023년 11월 13일: 개발자 프리뷰: 루브릭 CRUD
평가 기준 CRUD는 특정 기능에 대한 사전 액세스 권한을 부여하는 Google Workspace 개발자 프리뷰 프로그램의 일부로 제공됩니다. 이 기능을 사용하면 개발자가 교사를 대신하여 클래스룸 루브릭을 관리할 수 있습니다. 미리보기 기능 참여에 대한 자세한 내용은 로드맵을 참고하세요.
2023년 6월 26일: 초대된 사용자를 위한 비호환성 오류 코드 변경
이제 다음 엔드포인트는 초대된 사용자(수업에 초대되었지만 아직 수락하지 않은 교사 또는 학생)의 요청에 대해 404 오류를 반환합니다. 이전에는 다음 엔드포인트에서 403을 반환했습니다.
courses.courseWork.createcourses.courseWork.deletecourses.courseWork.getcourses.courseWork.patchcourses.courseWorkMaterials.createcourses.courseWorkMaterials.deletecourses.courseWorkMaterials.getcourses.courseWorkMaterials.patchcourses.announcements.createcourses.announcements.deletecourses.announcements.getcourses.announcements.patch
다음 관련 엔드포인트는 영향을 받지 않습니다.
courses.courseWork.listcourses.courseWork.modifyAssigneescourses.courseWorkMaterials.listcourses.announcements.listcourses.announcements.modifyAssignees
2022년 8월 8일: 성적 카테고리 및 성적 기록 설정
이제 API를 사용하여 수업의 성적 카테고리와 강의의 성적부 설정을 가져올 수 있습니다.
2020년 9월 21일: 수업 자료
이제 개발자가 클래스룸에서 수업 과제 자료 항목을 읽고, 쓰고, 수정할 수 있습니다.
- 콘텐츠를 클래스룸에 공유할 때 과정 ID 및 자료 유형에 대해 공유 태그 속성을 설정합니다.
2019년 4월 2일: Classroom의 주제
- 클래스룸에서 주제 가져오기, 만들기, 수정, 삭제: 이제 API를 통해 클래스룸에서 수업 항목을 정리하고 가져올 수 있습니다.
2018년 8월 7일: 수업 과제 및 학생 제출물에 대한 푸시 알림
- 수업 활동 및 학생 제출물의 변경사항에 대한 실시간 알림을 받을 수 있습니다. 이제 새로운 과제가 게시되거나, 학생이 제출물을 제출하거나, 교사가 제출물을 채점하는 등의 상황을 알림으로 확인할 수 있습니다.
2017년 9월 26일: 푸시 알림, 공지, 맞춤 게시물
- 출석부 변경사항에 대한 실시간 알림 받기: 변경사항을 위해 클래스룸 API 엔드포인트를 폴링하는 대신 Google Cloud Pub/Sub를 사용하여 수업 또는 도메인의 출석부 업데이트를 받을 수 있습니다.
- 공지사항 만들기 및 업데이트: 이제 애플리케이션에서 수업 외에도 클래스 스트림에서 공지사항을 만들고 업데이트할 수 있습니다.
- 개별적으로 맞춤설정된 게시물 만들기 및 업데이트: 이제 애플리케이션에서 전체 수업 대신 개별 학생에게 공지사항이나 수업 과제를 게시할 수 있습니다.
2017년 8월 1일: 수업 소유권 및 제출 내역 이전
- 관리자 사용자 인증 정보로 과정의 기본 소유자 (ownerId)를 업데이트하거나 교사가 과정 소유자가 되도록 초대를 시작합니다.
- 학생 제출물의 제출 기록에 액세스
2017년 6월 19일: 수업, 캘린더, 인증된 교사 일정
Classroom API 업데이트
2017년 1월 11일: 과제 업데이트
수업 엔드포인트가 업데이트되면 애플리케이션에서 다음 작업을 할 수 있습니다.
- 질문 만들기 및 업데이트
- 과제 수정 및 삭제
- 수업 자료 및 학생 제출물에 Drive 항목 및 YouTube 동영상 추가
2016년 8월 17일: Classroom API의 보호자
Google 클래스룸에서는 보호자를 위해 학생 활동에 관한 이메일 요약을 생성합니다. Classroom API는 보호자를 지원합니다. 개발자는 다음 작업을 할 수 있습니다.
2016년 5월 18일: Classroom API에 과제 추가
이제 Classroom API에 수업 과제(과제, 질문, 학생 응답, 성적)가 포함됩니다. 시작하려면 과제 가이드를 참고하세요.
2015년 8월 8일: Classroom API 정식 버전 출시
이제 모든 개발자와 G Suite for Education 도메인에서 클래스룸 API를 사용할 수 있습니다. API 사용을 시작하기 위해 더 이상 액세스를 요청할 필요가 없습니다.
- G Suite for Education 관리자는 클래스룸 데이터 액세스 설정이 올바른지 확인해야 합니다.
- 이제 Google Apps Script에서 클래스룸 API를 사용할 수 있습니다. QuickStart을 사용해 보세요.
2015년 6월 29일: Classroom API 개발자 프리뷰 사용 가능
이제 개발자 프리뷰에서 클래스룸 API를 사용할 수 있습니다. 지금 사전 액세스 및 테스트 계정을 신청하세요.
도메인의 사용자에게 API에 대한 사전 액세스 권한을 부여하려는 G Suite for Education 관리자는 도메인 허용 목록에 가입할 수 있습니다.개발자는 API를 사용하여 코드를 사전 체험 신청할 수 있습니다.
전체 공지사항은 Google for Education 블로그를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-01(UTC)
[null,null,["최종 업데이트: 2025-08-01(UTC)"],[],[],null,["# Release Notes\n\nThis page contains release notes for the Classroom API. Subscribe to\nthe [announcement list](https://groups.google.com/forum/#!forum/classroom-dev-announce) to get email updates.\n\n#### 13 November 2023: **Developer Preview: Rubrics CRUD**\n\n[Rubrics CRUD](/workspace/classroom/rubrics) is available as part of the [Google Workspace Developer Preview\nProgram](/workspace/preview), which grants early access to certain features. This feature allows\ndevelopers to manage Classroom [rubrics](https://support.google.com/edu/classroom/answer/9335069?co=GENIE.Platform%3DDesktop) on behalf of teachers. See the\n[roadmap](/workspace/classroom/reference/roadmap) to learn more about participating in preview features.\n\n#### 26 June 2023: **Non-breaking error code change for Invited Users**\n\nThe following endpoints now return a 404 error for requests from Invited Users\n(a teacher or student that has been [invited](/workspace/classroom/guides/manage-invitations) to a course but has not yet\naccepted). Previously these endpoints returned a 403:\n\n- `courses.courseWork.create`\n- `courses.courseWork.delete`\n- `courses.courseWork.get`\n- `courses.courseWork.patch`\n- `courses.courseWorkMaterials.create`\n- `courses.courseWorkMaterials.delete`\n- `courses.courseWorkMaterials.get`\n- `courses.courseWorkMaterials.patch`\n- `courses.announcements.create`\n- `courses.announcements.delete`\n- `courses.announcements.get`\n- `courses.announcements.patch`\n\nThe following related endpoints are unaffected:\n\n- `courses.courseWork.list`\n- `courses.courseWork.modifyAssignees`\n- `courses.courseWorkMaterials.list`\n- `courses.announcements.list`\n- `courses.announcements.modifyAssignees`\n\n#### 8 August 2022: **Grade category and gradebook settings**\n\nIt is now possible to retrieve the [grade category](/workspace/classroom/reference/rest/v1/GradeCategory) for coursework and\n[gradebook settings](/workspace/classroom/reference/rest/v1/courses#gradebooksettings) for courses using the API.\n\n#### 21 September 2020: **Classroom Materials**\n\nDevelopers can now read, write, and modify CourseWork Material items in Classroom:\n\n- [Create CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/create)\n- Retrieve [one](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/get) or [all CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/list)\n- [Update CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/patch)\n- [Modify attachments for CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/modifyAttachments)\n- [Delete CourseWorkMaterials](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWorkMaterials/delete)\n\n#### 18 November 2019: **New Share Button URL Parameters**\n\n- Set [share tag attributes](https://developers.google.com/workspace/classroom/guides/sharebutton#share_tag_attributes) for course ID and material type when sharing content to Classroom.\n\n#### 2 April 2019: **Topics in Classrooom**\n\n- [Retrieve](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/list), [create](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/create), [edit](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/patch), and [delete](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.topics/delete) Topics in Classroom - now you can organize and retrieve Classwork items in Classroom through the API.\n\n#### 7 August 2018: **Push notifications for course work and student submissions**\n\n- Get [real-time notifications](https://developers.google.com/workspace/classroom/guides/push-notifications) of changes to course work and student submissions - now you can listen for new assignments being posted, students turning in their submissions, teachers grading submissions, and more\n\n#### 26 September 2017: **Push notifications, announcements, and individualized posts**\n\n- Get [real-time notifications](https://developers.google.com/workspace/classroom/guides/push-notifications) of roster changes - instead of polling Classroom API endpoints for changes, you can use [Google Cloud Pub/Sub](https://cloud.google.com/pubsub/) to get roster updates for a class or a domain\n- Create and update [announcements](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.announcements) - in addition to coursework, applications can now create and update announcements in the class stream\n- Create and update [individualized posts](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWork) - applications now have the option to post announcements or coursework to individual students, instead of the whole class\n\n#### 1 August 2017: **Transfer course ownership and submission history**\n\n- [Update](https://developers.google.com/workspace/classroom/reference/rest/v1/courses) the primary owner of a course (ownerId) with admin credentials, or initiate an [invitation](https://developers.google.com/workspace/classroom/reference/rest/v1/invitations#courserole) for a teacher to become the course owner\n- Access [submission history](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions) for a student submission\n\n#### 19 June 2017: **Schedule coursework, calendar, and verified teachers**\n\nUpdates to the Classroom API\n\n- [Schedule coursework](https://developers.google.com/workspace/classroom/reference/rest/v1/courses.courseWork) to post at a later date/time by setting the scheduledTime field of coursework\n- Access the [calendarId](https://developers.google.com/workspace/classroom/reference/rest/v1/courses) of a course\n- Identify if a given user is a [verified teacher](https://developers.google.com/workspace/classroom/reference/rest/v1/userProfiles)\n\n#### 11 January 2017: **Coursework updates**\n\nUpdates to the [coursework](https://developers.google.com/workspace/classroom/guides/manage-coursework) endpoints lets applications:\n\n- Create and update questions\n- Modify and delete coursework\n- Add Drive items and YouTube videos to coursework and student submissions\n\n#### 17 August 2016: **Guardians in the Classroom API**\n\nGoogle Classroom generates email summaries of student activities for guardians. The Classroom API has support for [guardians](https://developers.google.com/workspace/classroom/guides/manage-guardians). Developers can\n\n- Invite individuals to become guardians\n- Retrieve a student's invited and active guardians\n- Manage active guardians\n\n- G Suite for Education admins should confirm their\n [Classroom Data access settings](https://admin.google.com/ac/managedsettings/397451267717/DataAccessSettings)\n are correct.\n\n- The Classroom API is now available in Google Apps Script. Try out the [QuickStart](/workspace/classroom/quickstart/apps-script).\n\n#### 18 May 2016: **Coursework added to the Classroom API**\n\nThe Classroom API now includes coursework - the assignments, questions,\nstudent responses, and grades. See the [Coursework guide](/workspace/classroom/guides/manage-coursework)\nto get started.\n\n#### 08 August 2015: **Classroom API now generally available**\n\nThe Classroom API is now available to all developers and G Suite for\nEducation domains. You no longer need to request access to begin using the API.\n\n- G Suite for Education admins should confirm their [Classroom Data access settings](https://admin.google.com/ac/managedsettings/397451267717/DataAccessSettings) are correct.\n- The Classroom API is now available in Google Apps Script. Try out the [QuickStart](/workspace/classroom/quickstart/apps-script).\n\n#### 29 June 2015: **Classroom API now available developer preview**\n\nThe Classroom API is now available for developer preview. You can sign up now\nfor early [access and test accounts](/workspace/classroom/access).\n\n- ~~G Suite for Education admins who want to give users in their domain early\n access to the API can\n [sign up for the domains whitelist](//support.google.com/code/contact/classroom_api_admin_preview).~~\n- ~~Developers can\n [apply for early access](https://docs.google.com/a/google.com/forms/d/1hY4Lk3imYBSOanQHZSqw1AYt9AswVGiltV-Jp7_5QpI/viewform)\n to code with the API.~~\n\nFor the full announcement, see the\n[Google for Education blog](//googleforeducation.blogspot.com/2015/06/new-ways-to-integrate-with-Google-Classroom.html)."]]
