Method: courses.list

Retorna uma lista de cursos que o usuário solicitante tem permissão para visualizar, restrita àqueles que correspondem à solicitação. Os cursos retornados são ordenados por data de criação, com os mais recentes primeiro.

Esse método retorna os seguintes códigos de erro:

  • PERMISSION_DENIED para erros de acesso.
  • INVALID_ARGUMENT se o argumento de consulta estiver incorreto.
  • NOT_FOUND se algum dos usuários especificados nos argumentos da consulta não existir.

Solicitação HTTP

GET https://classroom.googleapis.com/v1/courses

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
studentId

string

Restringe os cursos retornados àqueles que têm um estudante com o identificador especificado. O identificador pode ser um dos seguintes:

  • o identificador numérico do usuário
  • o endereço de e-mail do usuário
  • o literal de string "me", indicando o usuário solicitante

Se especificado, teacherId precisa estar vazio.
teacherId

string

Restringe os cursos retornados àqueles que têm um professor com o identificador especificado. O identificador pode ser um dos seguintes:

  • o identificador numérico do usuário
  • o endereço de e-mail do usuário
  • o literal de string "me", indicando o usuário solicitante

Se especificado, studentId precisa estar vazio.
courseStates[]

enum (CourseState)

Restringe os cursos retornados àqueles em um dos estados especificados. O valor padrão é ACTIVE, ARCHIVED, PROVISIONED, DECLINED.
pageSize

integer

Número máximo de itens a serem retornados. Zero ou não especificado indica que o servidor pode atribuir um máximo.

O servidor pode retornar menos resultados do que o número especificado.
pageToken

string

Valor nextPageToken retornado de uma chamada list anterior, indicando que a página de resultados subsequente deve ser retornada.

A solicitação list precisa ser idêntica àquela que resultou nesse token.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta ao listar cursos.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "courses": [
    {
      object (Course)
    }
  ],
  "nextPageToken": string
}
Campos
courses[]

object (Course)

Cursos que correspondem à solicitação de lista.
nextPageToken

string

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 do OAuth:

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly

Para mais informações, consulte o guia de autorização.