- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- LateValues
- Faça um teste
Retorna uma lista dos envios de estudantes que o solicitante tem permissão para ver, considerando os escopos do OAuth da solicitação. -
pode ser especificado como courseWorkId
para incluir os envios dos estudantes para vários itens de trabalho do curso.
Os estudantes do curso só podem acessar os próprios trabalhos. Professores do curso e administradores do domínio têm acesso a todos os envios dos estudantes.
Esse método retorna os seguintes códigos de erro:
PERMISSION_DENIED
: se o usuário solicitante não tiver permissão para acessar o curso ou o trabalho do curso solicitado ou devido a erros de acesso.INVALID_ARGUMENT
se a solicitação for inválida.NOT_FOUND
se o curso solicitado não existir.
Solicitação HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
courseId |
Identificador do curso. Esse identificador pode ser atribuído pelo Google Sala de Aula ou um |
courseWorkId |
Identificador do trabalho do estudante a ser solicitado. Isso pode ser definido como o literal de string |
Parâmetros de consulta
Parâmetros | |
---|---|
userId |
Argumento opcional para restringir os trabalhos devolvidos aos trabalhos do estudante com o identificador especificado. O identificador pode ser um dos seguintes:
|
states[] |
Estados do envio solicitado. Se especificado, os envios devolvidos dos estudantes correspondem a um dos estados de envio especificados. |
late |
Valor de atraso solicitado. Se especificado, os envios devolvidos dos estudantes vão ser restritos pelo valor solicitado. Se não for especificado, os envios serão retornados, independentemente do valor de |
pageSize |
Número máximo de itens a serem devolvidos. Zero ou não especificado indica que o servidor pode atribuir um máximo. O servidor pode retornar menos do que o número especificado de resultados. |
pageToken |
Valor A solicitação |
previewVersion |
Opcional. A versão de pré-lançamento da API. Isso precisa ser definido para acessar os novos recursos da API disponibilizados aos desenvolvedores no Programa de testes. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Resposta ao listar os envios dos estudantes.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{
"studentSubmissions": [
{
object ( |
Campos | |
---|---|
studentSubmissions[] |
O trabalho do estudante corresponde à solicitação. |
nextPageToken |
Token que identifica a próxima página de resultados a serem retornados. Se estiver vazio, não haverá mais resultados disponíveis. |
Escopos de autorização
Requer um dos seguintes escopos 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 mais informações, consulte o Guia de autorização.
LateValues
Restrições sobre o valor atrasado dos itens devolvidos.
Enums | |
---|---|
LATE_VALUES_UNSPECIFIED |
Nenhuma restrição quanto aos valores de envios atrasados especificados. |
LATE_ONLY |
Devolver StudentSubmissions quando o atraso for verdadeiro. |
NOT_LATE_ONLY |
Retorne StudentSubmissions quando o atraso for falso. |