Los complementos de Google Classroom ya están en fase de disponibilidad general para desarrolladores. Consulta la
documentación sobre complementos para obtener más información.
Method: courses.courseWork.studentSubmissions.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muestra una lista de las entregas de los estudiantes que el solicitante puede ver, teniendo en cuenta los alcances de OAuth de la solicitud. Se puede especificar - como courseWorkId para incluir las entregas de los estudiantes de varios elementos del trabajo del curso.
Los estudiantes del curso solo pueden ver su propio trabajo. Los profesores del curso y los administradores del dominio pueden ver todas las tareas de los estudiantes.
Este método muestra los siguientes códigos de error:
PERMISSION_DENIED si el usuario solicitante no tiene permiso para acceder al curso o al trabajo del curso solicitado, o por errores de acceso.INVALID_ARGUMENT si la solicitud tiene un formato incorrecto.NOT_FOUND si el curso solicitado no existe.
Solicitud HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
courseId |
string
Es el identificador del curso. Este identificador puede ser el asignado por Classroom o un alias.
|
courseWorkId |
string
Es el identificador del trabajo del estudiante que se solicitará. Se puede establecer en la cadena literal "-" para solicitar el trabajo de los estudiantes para todas las actividades del curso especificado.
|
Parámetros de consulta
| Parámetros |
userId |
string
Es un argumento opcional para restringir el trabajo de los estudiantes devueltos a aquellos que son propiedad del estudiante con el identificador especificado. El identificador puede ser uno de los siguientes:
- el identificador numérico del usuario
- la dirección de correo electrónico del usuario
- el literal de cadena
"me", que indica el usuario solicitante
|
states[] |
enum (SubmissionState)
Estados de envío solicitados Si se especifica, las entregas de los estudiantes que se devuelven coinciden con uno de los estados de entrega especificados.
|
late |
enum (LateValues)
Valor de retraso solicitado. Si se especifica, las entregas de los estudiantes que se devuelven se restringen según el valor solicitado. Si no se especifica, se muestran los envíos independientemente del valor de late.
|
pageSize |
integer
Es la cantidad máxima de elementos que se mostrarán. Cero o no especificado indica que el servidor puede asignar un máximo. Es posible que el servidor muestre menos de la cantidad especificada de resultados.
|
pageToken |
string
Es el valor de nextPageToken que se muestra de una llamada list anterior y que indica que se debe mostrar la página de resultados posterior. De lo contrario, la solicitud list debe ser idéntica a la que generó este token.
|
previewVersion |
enum (PreviewVersion)
Opcional. La versión preliminar de la API. Se debe configurar para acceder a las nuevas funciones de la API que se ponen a disposición de los desarrolladores en el programa de versión preliminar.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Respuesta cuando se muestra una lista de las entregas de los estudiantes.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
{
"studentSubmissions": [
{
object (StudentSubmission)
}
],
"nextPageToken": string
} |
| Campos |
studentSubmissions[] |
object (StudentSubmission)
Trabajos de los estudiantes que coinciden con la solicitud
|
nextPageToken |
string
Es un token que identifica la siguiente página de resultados que se mostrará. Si está vacío, significa que no hay más resultados disponibles.
|
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
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
Para obtener más información, consulta la Guía de autorización.
LateValues
Restricciones sobre el valor tardío de los artículos devueltos
| Enumeraciones |
LATE_VALUES_UNSPECIFIED |
No se especificó ninguna restricción sobre los valores de entrega tardía. |
LATE_ONLY |
Muestra StudentSubmissions donde late es verdadero. |
NOT_LATE_ONLY |
Muestra StudentSubmissions donde late es falso. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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. |"]]
