貴社のユーザーは、Google Meet で Classroom を使用していますか?Apps Script のクイックスタート(Google Meet コースで生徒の出席状況を確認する方法)をご覧ください。

Google Classroom API

Google Classroom のクラス、名 、招待を管理します。

サービス: classroom.googleapis.com

このサービスを呼び出すには、Google が提供するクライアント ライブラリを使用することをおすすめします。アプリケーションで独自のライブラリを使用してこのサービスを呼び出す必要がある場合は、API リクエストの際に次の情報を使用します。

ディスカバリ ドキュメント

ディスカバリ ドキュメントは、REST API を記述して使用するための機械可読仕様です。クライアント ライブラリ、IDE プラグイン、Google API と連携するその他のツールのビルドに使用されます。1 つのサービスで複数のディスカバリ ドキュメントを提供できます。このサービスには、次の検索ドキュメントが用意されています。

サービス エンドポイント

サービス エンドポイントは、API サービスのネットワーク アドレスを指定するベース URL です。1 つのサービスに複数のサービス エンドポイントが存在することもあります。このサービスには次のサービス エンドポイントがあり、以下のすべての URI がこのサービス エンドポイントに関連しています。

  • https://classroom.googleapis.com

REST リソース: v1.courses

メソッド
create POST /v1/courses
コースを作成します。
delete DELETE /v1/courses/{id}
コースを削除します。
get GET /v1/courses/{id}
コースを返します。
list GET /v1/courses
リクエストしているユーザーが表示できるコースを、リクエストに一致するコースに限定して返します。
patch PATCH /v1/courses/{id}
コース内の 1 つ以上のフィールドを更新します。
update PUT /v1/courses/{id}
コースを更新します。

REST リソース: v1.courses.aliases

メソッド
create POST /v1/courses/{courseId}/aliases
コースのエイリアスを作成します。
delete DELETE /v1/courses/{courseId}/aliases/{alias}
コースのエイリアスを削除します。
list GET /v1/courses/{courseId}/aliases
コースのエイリアスのリストを返します。

REST リソース: v1.courses.announcements

メソッド
create POST /v1/courses/{courseId}/announcements
お知らせを作成します。
delete DELETE /v1/courses/{courseId}/announcements/{id}
お知らせを削除します。
get GET /v1/courses/{courseId}/announcements/{id}
お知らせを返します。
list GET /v1/courses/{courseId}/announcements
リクエスト送信者が閲覧を許可したお知らせのリストを返します。
modifyAssignees POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees
割り当て先のモードとお知らせのオプションを変更します。
patch PATCH /v1/courses/{courseId}/announcements/{id}
お知らせの 1 つ以上のフィールドを更新します。

REST リソース: v1.courses.courseWork

メソッド
create POST /v1/courses/{courseId}/courseWork
課題を作成します。
delete DELETE /v1/courses/{courseId}/courseWork/{id}
コースの課題を削除します。
get GET /v1/courses/{courseId}/courseWork/{id}
コースの課題を返します。
list GET /v1/courses/{courseId}/courseWork
リクエスト送信者が閲覧可能なコースの課題のリストを返します。
modifyAssignees POST /v1/courses/{courseId}/courseWork/{id}:modifyAssignees
課題のモードと課題のオプションを変更します。
patch PATCH /v1/courses/{courseId}/courseWork/{id}
コースの課題の 1 つ以上のフィールドを更新します。

REST リソース: v1.courses.courseWork.studentSubmissions

メソッド
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
生徒の提出物を返します。
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
リクエストの OAuth スコープを考慮したうえで、リクエスト送信者が閲覧を許可した生徒の提出物のリストを返します。
modifyAttachments POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments
生徒の提出物の添付ファイルが変更されます。
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
生徒の提出物の 1 つ以上のフィールドを更新します。
reclaim POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
提出物を所有する生徒の代理として、その生徒の提出物を再利用できます。
return POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return
生徒の提出物を返します。
turnIn POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn
生徒の提出物を提出します。

REST リソース: v1.courses.courseWorkMaterials

メソッド
create POST /v1/courses/{courseId}/courseWorkMaterials
コースの資料を作成します。
delete DELETE /v1/courses/{courseId}/courseWorkMaterials/{id}
コースの資料を削除します。
get GET /v1/courses/{courseId}/courseWorkMaterials/{id}
コースの資料を返します。
list GET /v1/courses/{courseId}/courseWorkMaterials
リクエスト送信者が閲覧が許可されているコースの課題リストを返します。
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{id}
コースの資料の 1 つ以上のフィールドを更新します。

REST リソース: v1.courses.students

メソッド
create POST /v1/courses/{courseId}/students
コースの生徒としてユーザーを追加します。
delete DELETE /v1/courses/{courseId}/students/{userId}
コースの生徒を削除します。
get GET /v1/courses/{courseId}/students/{userId}
コースの生徒を返します。
list GET /v1/courses/{courseId}/students
リクエスト送信者が閲覧を許可するこのコースの生徒のリストを返します。

REST リソース: v1.courses.teachers

メソッド
create POST /v1/courses/{courseId}/teachers
コースの教師を作成します。
delete DELETE /v1/courses/{courseId}/teachers/{userId}
指定した教師を指定したコースから削除します。
get GET /v1/courses/{courseId}/teachers/{userId}
コースの教師を返します。
list GET /v1/courses/{courseId}/teachers
リクエストの送信者が閲覧権限を持つこのコースの教師のリストを返します。

REST リソース: v1.courses.topics

メソッド
create POST /v1/courses/{courseId}/topics
トピックを作成します。
delete DELETE /v1/courses/{courseId}/topics/{id}
トピックを削除します。
get GET /v1/courses/{courseId}/topics/{id}
トピックを返します。
list GET /v1/courses/{courseId}/topics
リクエスト送信者が表示を許可されているトピックのリストを返します。
patch PATCH /v1/courses/{courseId}/topics/{id}
トピックの 1 つ以上のフィールドを更新します。

REST リソース: v1.invitations

メソッド
accept POST /v1/invitations/{id}:accept
招待を承諾して招待を削除し、招待したユーザーを所定のコースの教師または生徒(該当する場合)に追加します。
create POST /v1/invitations
招待状を作成します。
delete DELETE /v1/invitations/{id}
招待状を削除します。
get GET /v1/invitations/{id}
招待を返します。
list GET /v1/invitations
リクエストしているユーザーに閲覧を許可する招待状のリストを返します。ただし、リスト リクエストに一致するものに限定されます。

REST リソース: v1.registrations

メソッド
create POST /v1/registrations
Registration を作成し、指定された feed から cloudPubSubTopic で指定された宛先への通知の送信を開始します。
delete DELETE /v1/registrations/{registrationId}
Registration を削除します。これにより、Classroom ではその Registration に関する通知が送信されなくなります。

REST リソース: v1.userProfiles

メソッド
get GET /v1/userProfiles/{userId}
ユーザー プロフィールを返します。

REST リソース: v1.userProfiles.guardianInvitations

メソッド
create POST /v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations
保護者の招待を作成し、生徒の保護者であることを確認するメールを保護者に送信します。
get GET /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
特定の保護者の招待を返します。
list GET /v1/userProfiles/{studentId}/guardianInvitations
リクエスト元ユーザーが表示を許可されている保護者の招待のリストを、指定されたパラメータでフィルタして返します。
patch PATCH /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
保護者の招待状を変更します。

REST リソース: v1.userProfiles.guardians

メソッド
delete DELETE /v1/userProfiles/{studentId}/guardians/{guardianId}
保護者を削除します。
get GET /v1/userProfiles/{studentId}/guardians/{guardianId}
特定の保護者を返します。
list GET /v1/userProfiles/{studentId}/guardians
リクエスト元の保護者が許可リストに登録したリストを返します。ただし、リクエストに一致する保護者に限定されます。