本文件提供 Google Classroom API 專屬授權和驗證資訊。在閱讀本文件之前，請務必詳閱 Google Workspace 的一般驗證和授權資訊，請參閱「瞭解驗證與授權」一文。
設定 OAuth 2.0 以進行授權
設定 OAuth 同意畫面並選擇範圍，定義要向使用者顯示哪些資訊，以及應用程式審查人員，並註冊應用程式以供日後發布。
Classroom API 範圍
如要定義應用程式獲得的存取層級，您必須識別並宣告授權範圍。授權範圍是 OAuth 2.0 URI 字串，內含 Google Workspace 應用程式名稱、存取的資料類型及存取層級。「範圍」是應用程式處理 Google Workspace 資料的要求，包括使用者的 Google 帳戶資料。
當使用者安裝應用程式時，系統會要求使用者驗證應用程式使用的範圍。一般來說，您應該選擇可能最聚焦的範圍，並避免要求應用程式不需要的範圍。使用者更容易授予清楚明瞭的有限範圍存取權。
Classroom API 支援下列範圍：
| 範圍 | 意義 |
|---|---|
https://www.googleapis.com/auth/classroom.announcements
|
在 Google Classroom 中查看及管理公告。 |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
在 Google Classroom 中查看公告。 |
https://www.googleapis.com/auth/classroom.courses
|
查看、編輯、建立及永久刪除您的 Google Classroom 課程。 |
https://www.googleapis.com/auth/classroom.courses.readonly
|
查看您的 Google Classroom 課程。 |
https://www.googleapis.com/auth/classroom.coursework.me
|
查看、建立及編輯課程作業項目，包括作業、問題和成績。 |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
在 Google Classroom 中查看課程作業和成績。 |
https://www.googleapis.com/auth/classroom.coursework.students
|
管理您授課的 Google Classroom 課程中學生的課程作業和成績，以及查看您管理的課程的課程作業和成績。 |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
查看您授課或管理的 Google Classroom 課程中學生的課程作業和成績。 |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
在 Google Classroom 中查看、編輯和建立課堂作業教材。 |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
查看您 Google Classroom 課程的所有課堂作業教材。 |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
查看您的 Google Classroom 監護人。 |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
查看及管理您 Google Classroom 課程中學生的監護人。 |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
查看您的 Google Classroom 課程的學生監護人。 |
https://www.googleapis.com/auth/classroom.profile.emails
|
查看課程中成員的電子郵件地址。 |
https://www.googleapis.com/auth/classroom.profile.photos
|
查看課程中成員的個人資料相片。 |
https://www.googleapis.com/auth/classroom.push-notifications
|
接收有關 Google Classroom 資料的通知。 |
https://www.googleapis.com/auth/classroom.rosters
|
管理您的 Google Classroom 課程學生名單。 |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
查看您的 Google Classroom 課程學生名單。 |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
在 Google Classroom 中查看課程作業和成績。 |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
查看您授課或管理的 Google Classroom 課程中學生的課程作業和成績。 |
https://www.googleapis.com/auth/classroom.topics
|
在 Google Classroom 中查看、建立及編輯主題。 |
https://www.googleapis.com/auth/classroom.topics.readonly
|
在 Google Classroom 中查看主題。 |