このドキュメントでは、Google Classroom API 固有の認可と認証について説明します。このドキュメントを読む前に、認証と認可についてで Google Workspace の一般的な認証と認可に関する情報をご確認ください。
認可用に OAuth 2.0 を構成する
OAuth 同意画面を設定し、スコープを選択することで、ユーザーとアプリの審査担当者に表示する情報を定義し、後でアプリを公開できるようにアプリを登録します。
Classroom API スコープ
アプリに付与されるアクセスレベルを定義するには、認可スコープを特定して宣言する必要があります。認可スコープは、Google Workspace アプリ名、アクセスするデータの種類、アクセスレベルを含む OAuth 2.0 URI 文字列です。スコープとは、ユーザーの Google アカウント データなど、Google Workspace データの操作に対するアプリのリクエストです。
アプリがインストールされると、アプリで使用されるスコープをユーザーが検証するよう求められます。通常は、できるだけ範囲の狭いスコープを選択し、アプリで必要のないスコープはリクエストしないようにします。ユーザーは、明確に説明された限定的なスコープに対してアクセス権限を付与する傾向があります。
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 でトピックを表示します。 |