Method: courses.courseWork.studentSubmissions.list

Renvoie la liste des devoirs rendus 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 devoir.

Les élèves du cours ne peuvent consulter que leur propre travail. Les enseignants de cours et les administrateurs de domaine peuvent afficher 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 demandé, 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. Peut être défini sur la chaîne littérale "-" pour demander les devoirs des élèves pour tous les devoirs du cours spécifié.

Paramètres de requête

Paramètres
userId

string

Argument facultatif permettant de limiter les devoirs rendus à ceux appartenant à l'élève disposant de l'identifiant spécifié. Il peut s'agir de l'un des éléments 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 à l'origine de la demande
states[]

enum (SubmissionState)

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

enum (LateValues)

Valeur de retard demandée. Si elle 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'é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.
previewVersion

enum (PreviewVersion)

Facultatif. Version preview de l'API. Vous devez définir ce paramètre 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 lorsqu'une liste de devoirs d'élèves est listée.

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 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.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 n'est spécifiée concernant les valeurs de retard d'envoi.
LATE_ONLY Rendre les devoirs des élèves lorsque le retard est vrai
NOT_LATE_ONLY Renvoyer StudentSubmissions si la date de retard correspond à "false".