Method: courses.courseWork.list

リクエスト元に閲覧が許可されているコース作業のリストを返します。

コースの受講生は、コースの課題 PUBLISHED 件のみ表示できます。コースの教師とドメイン管理者は、コースのすべての課題を閲覧できます。

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

  • PERMISSION_DENIED: リクエストしたユーザーがリクエストされたコースへのアクセスを許可されていない場合、またはアクセスエラーの場合。
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • リクエストされたコースが存在しない場合は NOT_FOUND。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
courseId

string

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

クエリ パラメータ

パラメータ
courseWorkStates[]

enum (CourseWorkState)

返される作業ステータスの制限。一致する courseWork のみが返されます。指定しない場合は、作業ステータスが PUBLISHED のアイテムが返されます。
orderBy

string

結果の並べ替え順序（省略可）。オプションの並べ替え方向のキーワードを含む、フィールドのカンマ区切りのリスト。サポートされているフィールドは updateTime と dueDate です。サポートされている方向のキーワードは asc と desc です。指定しない場合、updateTime desc がデフォルトの動作になります。例: dueDate asc,updateTime desc、updateTime,dueDate desc
pageSize

integer

返されるアイテムの最大数。ゼロまたは未指定の場合は、サーバーが最大値を割り当てることができます。

サーバーが返す結果の数は、指定した数より少ないことがあります。
pageToken

string

前回の list 呼び出しから返された nextPageToken 値。結果の次のページを返す必要があることを示します。

それ以外の点では、list リクエストは、このトークンの生成元となったリクエストと同じである必要があります。
previewVersion

enum (PreviewVersion)

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

リクエスト本文

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

レスポンスの本文

コースの課題を一覧表示するときのレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "courseWork": [
    {
      object (CourseWork)
    }
  ],
  "nextPageToken": string
}
フィールド
courseWork[]

object (CourseWork)

リクエストに一致するコースの作業アイテム。
nextPageToken

string

返される結果の次のページを識別するトークン。空の場合、これ以上結果はありません。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

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