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 niveaux d'accès OAuth de la requête. Un tiret (-) peut être spécifié comme courseWorkId pour inclure les devoirs des élèves pour plusieurs devoirs.

Les élèves d'un cours ne peuvent voir que leurs propres devoirs. Les enseignants du 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 qui en fait la demande n'est pas autorisé à accéder au cours ou au devoir demandé, ou en cas d'erreur d'accès.
  • INVALID_ARGUMENT si la requête est mal formulée.
  • 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. Cet identifiant peut être celui attribué par Classroom ou un alias.
courseWorkId

string

Identifiant du devoir de l'élève à demander. Vous pouvez définir cette valeur 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 renvoyés aux devoirs appartenant à l'élève avec l'identifiant spécifié. L'identifiant peut être l'un des suivants :

  • Identifiant numérique de l'utilisateur
  • 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 ce paramètre est spécifié, les devoirs rendus par les élèves correspondent à l'un des états d'envoi 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 rien n'est spécifié, les réponses sont renvoyées quelle que soit la valeur late.
pageSize

integer

Nombre maximal d'éléments à renvoyer. Si la valeur est nulle ou non spécifiée, le serveur peut attribuer un maximum.

Le serveur peut renvoyer un nombre de résultats inférieur à celui 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.

La requête list doit être identique à celle qui a généré ce jeton.
previewVersion

enum (PreviewVersion)

Facultatif. Version preview de l'API. Ce paramètre 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 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)

Travaux d'élèves correspondant à la demande
nextPageToken

string

Jeton identifiant la page de résultats suivante à renvoyer. Si ce champ est vide, cela signifie qu'il n'y a plus de résultats.

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 d'autorisation.

LateValues

Restrictions concernant la valeur tardive des articles retournés.

Enums
LATE_VALUES_UNSPECIFIED Aucune restriction n'est spécifiée concernant les valeurs tardives des envois.
LATE_ONLY Renvoyez les StudentSubmissions pour lesquels "late" est défini sur "true".
NOT_LATE_ONLY Renvoyez les StudentSubmissions où "late" est défini sur "false".