本文包含 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.addons.teacher
|
查看、建立及更新提出要求的 Google Cloud 專案附件，以串流您在 Google Classroom 中教授的課程項目。 |
https://www.googleapis.com/auth/classroom.addons.student
|
查看及更新提出要求的 Google Cloud 專案附件，以便在 Google Classroom 中串流項目。 |
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 中查看主題。 |