Google Classroom API のスコープを選択する

このドキュメントでは、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 Classroom で教えるクラスのストリーム アイテムに対する、リクエスト元の Google Cloud プロジェクトの添付ファイルの参照、作成、更新。
https://www.googleapis.com/auth/classroom.addons.student Google Classroom のストリーム アイテムに対するリクエスト元の Google Cloud プロジェクトの添付ファイルを表示、更新します。
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 のトピックを表示します。
前へ
前提条件
次へ
リクエストの仕組み