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

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