ユーザーが Classroom と Google Meet を使用している場合は、Google Meet コースの生徒の出席状況を確認する Apps Script クイックスタートをご覧ください。

Method: courses.courseWork.patch

コース課題の 1 つ以上のフィールドを更新します。

更新される可能性があるフィールドと変更されるフィールドの詳細については、google.classroom.v1.CourseWork をご覧ください。

このリクエストは、対応するコースの作業アイテムの作成に使用された OAuth クライアント ID の Google Play Console プロジェクトによって行う必要があります。

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

  • PERMISSION_DENIED: リクエスト元のデベロッパー プロジェクトに対応するコースの課題が作成されていない場合、または学生がリクエストされた提出の変更をユーザーが許可していない場合、またはアクセスエラーがある場合。
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • FAILED_PRECONDITION（リクエストされたコースの課題がすでに削除されている場合）
  • NOT_FOUND リクエストされたコース、コースの課題、または生徒の提出物が存在しない場合。

HTTP リクエスト

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}

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

パスパラメータ

パラメータ
courseId

string

コースの識別子。この ID は、Classroom によって割り当てられた ID または alias のいずれかです。
id

string

コース課題の識別子。

クエリ パラメータ

パラメータ
updateMask

string (FieldMask format)

コースで更新するフィールドを識別するマスク。更新するには、このフィールドが必要です。無効なフィールドを指定すると、更新に失敗します。フィールドが空の値をサポートしている場合は、CourseWork オブジェクトではなく更新マスクで指定するとクリアできます。空の値をサポートしていないフィールドが更新マスクに含まれていて、CourseWork オブジェクトに設定されていない場合、INVALID_ARGUMENT エラーが返されます。

教師は次のフィールドを指定できます。

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId

これは、完全修飾された項目名のカンマ区切りリストです。（例: "user.displayName,photo"）。

リクエストの本文

リクエストの本文には CourseWork のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には CourseWork のインスタンスが含まれます。

認可スコープ

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

  • https://www.googleapis.com/auth/classroom.coursework.students

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