Method: courses.studentGroups.delete

生徒グループを削除します。

このメソッドは、次のエラーコードを返します。

  • リクエストしたユーザーがリクエストされた生徒グループの削除を許可されていない場合、またはアクセス エラーが発生した場合の PERMISSION_DENIED。
  • 生徒グループが存在しない場合、またはユーザーが生徒グループにアクセスできない場合は NOT_FOUND。

HTTP リクエスト

DELETE https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{id}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
courseId

string

必須。削除する生徒グループを含むコースの ID。
id

string

必須。削除する生徒グループの識別子。

クエリ パラメータ

パラメータ
previewVersion

enum (PreviewVersion)

省略可。API のプレビュー バージョン。プレビュー プログラムでデベロッパーが利用できる新しい API 機能にアクセスするには、この設定を行う必要があります。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文は空の JSON オブジェクトになります。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/classroom.rosters

詳しくは、承認ガイドをご覧ください。