Method: courses.courseWork.studentSubmissions.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renvoie la liste des devoirs rendus par les élèves que l'utilisateur est autorisé à consulter, en tenant compte des champs d'application OAuth de la requête. - peut être spécifié 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 |
Renvoyez les "StudentSubmissions" pour lesquels "late" est défini sur "true". |
NOT_LATE_ONLY |
Renvoyez les StudentSubmissions pour lesquels "late" est défini sur "false". |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["# Method: courses.courseWork.studentSubmissions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListStudentSubmissionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [LateValues](#LateValues)\n- [Try it!](#try-it)\n\nReturns a list of student submissions that the requester is permitted to view, factoring in the OAuth scopes of the request. `-` may be specified as the `courseWorkId` to include student submissions for multiple course work items.\n\nCourse students may only view their own work. Course teachers and domain administrators may view all student submissions.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or course work, or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course does not exist.\n\n### HTTP request\n\n`GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course. This identifier can be either the Classroom-assigned identifier or an [alias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias). |\n| `courseWorkId` | `string` Identifier of the student work to request. This may be set to the string literal `\"-\"` to request student work for all course work in the specified course. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userId` | `string` Optional argument to restrict returned student work to those owned by the student with the specified identifier. The identifier can be one of the following: - the numeric identifier for the user - the email address of the user - the string literal `\"me\"`, indicating the requesting user |\n| `states[]` | `enum (`[SubmissionState](/workspace/classroom/reference/rest/v1/SubmissionState)`)` Requested submission states. If specified, returned student submissions match one of the specified submission states. |\n| `late` | `enum (`[LateValues](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions/list#LateValues)`)` Requested lateness value. If specified, returned student submissions are restricted by the requested value. If unspecified, submissions are returned regardless of `late` value. |\n| `pageSize` | `integer` Maximum number of items to return. Zero or unspecified indicates that the server may assign a maximum. The server may return fewer than the specified number of results. |\n| `pageToken` | `string` [nextPageToken](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions/list#body.ListStudentSubmissionsResponse.FIELDS.next_page_token) value returned from a previous `list` call, indicating that the subsequent page of results should be returned. The `list` request must be otherwise identical to the one that resulted in this token. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse when listing student submissions.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"studentSubmissions\": [ { object (/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#StudentSubmission) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `studentSubmissions[]` | `object (`[StudentSubmission](/workspace/classroom/reference/rest/v1/courses.courseWork.studentSubmissions#StudentSubmission)`)` Student work that matches the request. |\n| `nextPageToken` | `string` Token identifying the next page of results to return. If empty, no further results are available. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/classroom.coursework.students.readonly`\n- `\n https://www.googleapis.com/auth/classroom.coursework.me.readonly`\n- `\n https://www.googleapis.com/auth/classroom.coursework.students`\n- `\n https://www.googleapis.com/auth/classroom.coursework.me`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nLateValues\n----------\n\nRestrictions on the late value of returned items.\n\n| Enums ||\n|---------------------------|-----------------------------------------------------|\n| `LATE_VALUES_UNSPECIFIED` | No restriction on submission late values specified. |\n| `LATE_ONLY` | Return StudentSubmissions where late is true. |\n| `NOT_LATE_ONLY` | Return StudentSubmissions where late is false. |"]]
