Method: courses.courseWorkMaterials.list

Affiche une liste des supports de cours que le demandeur est autorisé à consulter.

Les étudiants du cours ne peuvent consulter que PUBLISHED de devoirs. Les enseignants du cours et les administrateurs de domaine peuvent afficher tous les devoirs.

Cette méthode renvoie les codes d'erreur suivants:

  • PERMISSION_DENIED si l'utilisateur à l'origine de la demande n'est pas autorisé à accéder au cours demandé ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si le format de la requête est incorrect.
  • NOT_FOUND si le cours demandé n'existe pas.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
courseId

string

Identifiant du cours. Il peut s'agir de l'identifiant attribué par Classroom ou d'un alias.

Paramètres de requête

Paramètres
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Restriction de l'état des devoirs à rendre. Seuls les supports de cours qui correspondent sont renvoyés. Si aucune valeur n'est spécifiée, les éléments dont l'état de tâche est PUBLISHED sont renvoyés.
orderBy

string

Ordre de tri facultatif pour les résultats. Liste de champs séparés par une virgule avec un mot clé dans l'ordre de tri facultatif. Champ accepté : updateTime. Les mots clés d'orientation acceptés sont asc et desc. S'il n'est pas spécifié, updateTime desc est le comportement par défaut. Exemples: updateTime asc, updateTime
pageSize

integer

Nombre maximal d'éléments à renvoyer. La valeur "zéro" ou "non spécifié" indique que le serveur peut attribuer une valeur maximale.

Le serveur peut renvoyer un nombre de résultats inférieur au nombre spécifié.
pageToken

string

Valeur nextPageToken renvoyée par un appel list précédent, indiquant que la page de résultats suivante doit être renvoyée.

Par ailleurs, la requête list doit être identique à celle qui a généré ce jeton.
materialDriveId

string

Filtrage facultatif des supports de cours contenant au moins un support Drive dont l'ID correspond à la chaîne fournie. Si materialLink est également spécifié, les supports de devoir doivent correspondre aux deux filtres.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse lors de la liste des devoirs.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "courseWorkMaterial": [
    {
      object (CourseWorkMaterial)
    }
  ],
  "nextPageToken": string
}
Champs
courseWorkMaterial[]

object (CourseWorkMaterial)

Éléments des supports de cours correspondant à la demande.
nextPageToken

string

Jeton identifiant la page suivante de résultats à renvoyer. Si ce champ n'est pas renseigné, aucun autre résultat n'est disponible.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/classroom.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

Pour en savoir plus, consultez le guide relatif aux autorisations.