Method: courses.courseWork.create

コースワークを作成する。

結果として得られるコースの課題（および対応する生徒の提出物）は、リクエストの作成に使用された OAuth クライアント ID の Developer Console プロジェクトに関連付けられます。コースの課題や生徒の提出物を変更する Classroom API のリクエストは、関連付けられた Developer Console プロジェクトの OAuth クライアント ID を使用して行う必要があります。

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

  • PERMISSION_DENIED: リクエストされたコースへのアクセス、リクエストされたコースでのコースの課題の作成、ドライブの添付ファイルの共有、またはアクセスエラーがリクエスト元のユーザーに許可されていない場合。
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • リクエストされたコースが存在しない場合は NOT_FOUND。
  • 次のリクエスト エラーの場合は FAILED_PRECONDITION:
    • AttachmentNotVisible

HTTP リクエスト

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

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

パスパラメータ

パラメータ
courseId

string

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

クエリ パラメータ

パラメータ
previewVersion

enum (PreviewVersion)

省略可。エンドポイントのプレビュー版。プレビュー プログラムでデベロッパーが利用できる新しい API 機能にアクセスするには、設定する必要があります。

リクエスト本文

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

レスポンスの本文

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

認可スコープ

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

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

詳細については、承認ガイドをご覧ください。