Method: courses.courseWork.studentSubmissions.list

Renvoie la liste des devoirs remis par les élèves que le demandeur est autorisé à consulter, en tenant compte des champs d'application OAuth de la requête. - peut être spécifié en tant que courseWorkId pour inclure les devoirs des élèves pour plusieurs éléments de travail du cours.

Les élèves du cours peuvent uniquement consulter leur propre travail. Les enseignants de cours et les administrateurs du domaine peuvent consulter tous les devoirs des élèves.

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 ou au devoir, ou en cas d'erreur 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}/courseWork/{courseWorkId}/studentSubmissions

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.
courseWorkId

string

Identifiant du devoir à demander par l'élève. Il peut être défini sur le littéral de chaîne "-" afin de demander les devoirs des élèves pour tous les travaux du cours spécifié.

Paramètres de requête

Paramètres
userId

string

Argument facultatif permettant de limiter les devoirs rendus aux élèves ayant l'identifiant spécifié. Il peut s'agir de l'un des types d'identifiants suivants:

  • l'identifiant numérique de l'utilisateur
  • L'adresse e-mail de l'utilisateur
  • Le littéral de chaîne "me", indiquant l'utilisateur demandeur
states[]

enum (SubmissionState)

États d'envoi demandés. Si cet état est spécifié, les devoirs rendus par les élèves correspondent à l'un des états spécifiés.
late

enum (LateValues)

Valeur de retard demandée. Si une valeur est spécifiée, les devoirs rendus par les élèves sont limités par la valeur demandée. Si aucune valeur n'est spécifiée, les envois sont renvoyés, quelle que soit la valeur late.
pageSize

integer

Nombre maximal d'articles à renvoyer. "0" ou "non spécifié" indique que le serveur peut attribuer une valeur maximale.

Le serveur peut renvoyer moins de résultats que le 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.
previewVersion

enum (PreviewVersion)

Facultatif. Version preview de l'API. Il doit être défini pour accéder aux nouvelles fonctionnalités d'API mises à la disposition des développeurs dans le programme Preview.

Corps de la requête

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

Corps de la réponse

Réponse lors de la création de la liste des devoirs des élèves.

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

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

object (StudentSubmission)

Devoir de l'élève correspondant à la demande.
nextPageToken

string

Jeton identifiant la page de résultats suivante à renvoyer. Si ce champ est vide, 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.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

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

LateValues

Restrictions concernant la valeur tardive des articles retournés.

Enums
LATE_VALUES_UNSPECIFIED Aucune restriction spécifiée concernant les valeurs tardives d'envoi.
LATE_ONLY Envoyez les devoirs rendus lorsque la valeur "retard" est vraie.
NOT_LATE_ONLY Renvoyer les devoirs pour lesquels la valeur "retard" est "false".