- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- LateValues
- Essayer
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 |
Identifiant du cours. Il peut s'agir de l'identifiant attribué par Classroom ou d'un |
courseWorkId |
Identifiant du devoir à demander. Peut être défini sur la chaîne littérale |
Paramètres de requête
Paramètres | |
---|---|
userId |
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:
|
states[] |
É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 |
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 |
pageSize |
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 |
Valeur Par ailleurs, la requête |
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 ( |
Champs | |
---|---|
studentSubmissions[] |
Devoir correspondant à la demande. |
nextPageToken |
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". |