Google Classroom 外掛程式現已全面開放開發人員使用!詳情請參閱
外掛程式說明文件。
版本資訊
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本頁面提供 Classroom API 的版本資訊。訂閱公告清單,接收電子郵件最新消息。
2023 年 11 月 13 日:開發人員預先發布版:CRUD 評量表
評量表 CRUD 屬於 Google Workspace 開發人員預先發布計畫的一部分,可搶先體驗特定功能。這項功能可讓開發人員代表老師管理 Classroom 評量表。如要進一步瞭解如何參與預先發布功能,請參閱路線圖。
2023 年 6 月 26 日:受邀使用者不會造成中斷的錯誤碼異動
如果受邀使用者 (已受邀加入課程但尚未接受邀請的老師或學生) 提出要求,下列端點現在會傳回 404 錯誤。先前這些端點會傳回 403 錯誤:
courses.courseWork.create
courses.courseWork.delete
courses.courseWork.get
courses.courseWork.patch
courses.courseWorkMaterials.create
courses.courseWorkMaterials.delete
courses.courseWorkMaterials.get
courses.courseWorkMaterials.patch
courses.announcements.create
courses.announcements.delete
courses.announcements.get
courses.announcements.patch
下列相關端點不受影響:
courses.courseWork.list
courses.courseWork.modifyAssignees
courses.courseWorkMaterials.list
courses.announcements.list
courses.announcements.modifyAssignees
2022 年 8 月 8 日:成績類別和成績單設定
現在可以使用 API 擷取作業的成績類別,以及課程的成績單設定。
2020 年 9 月 21 日:Classroom Materials
開發人員現在可以在 Classroom 中讀取、寫入及修改 CourseWork Material 項目:
- 將內容分享至 Classroom 時,請為課程 ID 和教材類型設定分享標記屬性。
2019 年 4 月 2 日:Classroom 主題
- 擷取、
建立、
編輯、
以及刪除
Classroom 中的主題 - 現在您可以使用 API 整理及擷取 Classroom 中的作業項目。
2018 年 8 月 7 日:課程作業和學生繳交作業的推播通知
- 即時接收通知,掌握課程作業和學生繳交內容的變更情況。現在,你可以聆聽新發布的作業、學生繳交的內容、老師評分的內容等
2017 年 9 月 26 日:推播通知、公告和個人化貼文
- 接收學生名單異動的即時通知:您可以使用 Google Cloud Pub/Sub 取得課程或網域的學生名單更新,不必輪詢 Classroom API 端點的異動
- 建立及更新公告:除了課程作業,應用程式現在還可以在課程訊息串中建立及更新公告
- 建立及更新個人化訊息:應用程式現在可以針對個別學生發布公告或指派課堂作業,不必再發布給全班
2017 年 8 月 1 日:轉移課程擁有權和提交記錄
- 使用管理員憑證更新課程的主要擁有者 (ownerId),或邀請老師成為課程擁有者
- 存取學生提交內容的繳交記錄
2017 年 6 月 19 日:安排課程、日曆和已驗證的老師
Classroom API 更新
2017 年 1 月 11 日:課程更新
更新 coursework 端點後,應用程式就能:
- 建立及更新問題
- 修改及刪除作業
- 在課程作業和學生提交內容中新增雲端硬碟項目和 YouTube 影片
2016 年 8 月 17 日:Classroom API 中的監護人
Google Classroom 會為監護人產生學生活動的電子郵件摘要,Classroom API 支援監護人。開發人員可以
2016 年 5 月 18 日:Classroom API 新增作業功能
Classroom API 現在包含課程作業,也就是作業、問題、學生回覆和成績。如要開始使用,請參閱作業指南。
2015 年 8 月 8 日:Classroom API 現已正式發布
Classroom API 現已開放所有開發人員和 G Suite 教育版網域使用。您不必再申請存取權,即可開始使用 API。
2015 年 6 月 29 日:Classroom API 開放開發人員預覽版
Classroom API 現已開放開發人員預覽。歡迎立即註冊搶先體驗並取得測試帳戶。
如需完整公告,請參閱 Google for Education 網誌。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-01 (世界標準時間)。
[null,null,["上次更新時間:2025-08-01 (世界標準時間)。"],[],[],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)."]]