Method: courses.courseWork.studentSubmissions.list

Renvoie la liste des devoirs rendus par les élèves que l'utilisateur est autorisé à consulter, en tenant compte des portées OAuth de la requête. Vous pouvez spécifier - comme courseWorkId pour inclure les devoirs des élèves pour plusieurs éléments de cours.

Les élèves du cours ne peuvent voir que leur propre travail. 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 à l'origine de la demande n'est pas autorisé à accéder au cours ou au travail demandé, ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si la requête est incorrecte.
  • 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 l'identifiant attribué par Classroom ou un alias.
courseWorkId

string

Identifiant du devoir à demander. Vous pouvez définir cette valeur sur la chaîne littérale "-" pour demander le travail 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 aux devoirs appartenant à l'élève associé à l'identifiant spécifié. L'identifiant peut être l'un des éléments suivants:

  • Identifiant numérique de l'utilisateur
  • l'adresse e-mail de l'utilisateur ;
  • le littéral de chaîne "me", qui indique l'utilisateur à l'origine de la requête
states[]

enum (SubmissionState)

États d'envoi demandés. Si elles sont spécifiées, les devoirs renvoyés correspondent à l'un des états d'envoi spécifiés.
late

enum (LateValues)

Valeur de retard demandée. Si elle est spécifiée, la valeur demandée limite les devoirs rendus par les élèves. Si ce paramètre n'est pas spécifié, les envois sont renvoyés quelle que soit la valeur de late.
pageSize

integer

Nombre maximal d'éléments à renvoyer. Une valeur nulle ou non spécifiée indique que le serveur peut attribuer une valeur maximale.

Le serveur peut renvoyer un nombre inférieur au nombre de résultats 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 lorsque vous listez les 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)

Le travail des élèves 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 d'autorisation.

LateValues

Restrictions concernant la valeur tardive des articles retournés.

Enums
LATE_VALUES_UNSPECIFIED Aucune restriction sur les valeurs de retard d'envoi spécifiée.
LATE_ONLY Renvoie les "StudentSubmissions" pour lesquels "late" est défini sur "true".
NOT_LATE_ONLY Renvoyez les "StudentSubmissions" pour lesquels "late" est défini sur "false".