リクエスト元が閲覧を許可されているコース教材のリストを返します。
コースの生徒は、PUBLISHED
コースの課題のみを閲覧できます。コースの教師とドメイン管理者は、コースのすべての課題を閲覧できます。
このメソッドは、次のエラーコードを返します。
PERMISSION_DENIED
: リクエスト元のユーザーがリクエストされたコースへのアクセスを許可されていない場合、またはアクセスエラーのため。INVALID_ARGUMENT
: リクエストの形式が正しくない場合。NOT_FOUND
: リクエストされたコースが存在しない場合。
HTTP リクエスト
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
courseId |
コースの識別子。この識別子は、Classroom で割り当てられた識別子または |
クエリ パラメータ
パラメータ | |
---|---|
courseWorkMaterialStates[] |
返される課題ステータスの制限。一致するコースの課題のみが返されます。指定しない場合、処理ステータスが |
orderBy |
結果の並べ替え順(省略可)。オプションの並べ替え方向キーワードを含むフィールドのカンマ区切りリスト。サポートされているフィールドは |
pageSize |
返されるアイテムの最大数。ゼロまたは未指定の場合、サーバーが最大値を割り当て可能であることを示します。 サーバーから返される結果の数よりも少ない結果が返されることがあります。 |
pageToken |
前の 他の点では、 |
materialLink |
指定した文字列と URL が部分的に一致するリンク教材を 1 つ以上含むコース教材のフィルタ(省略可)。 |
materialDriveId |
指定した文字列と一致する ID のドライブ教材を 1 つ以上含むコースの教材をフィルタします(省略可)。 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
コースの教材をリストする際のレスポンス。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"courseWorkMaterial": [
{
object ( |
フィールド | |
---|---|
courseWorkMaterial[] |
リクエストに一致するコースの教材アイテム。 |
nextPageToken |
返される結果の次のページを識別するトークン。空の場合、それ以上の結果はありません。 |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/classroom.courseworkmaterials
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
詳細については、承認ガイドをご覧ください。