Method: courses.announcements.list

Retorna uma lista de avisos que o solicitante tem permissão para ver.

Os estudantes do curso só podem ver os avisos do PUBLISHED. Os professores do curso e administradores do domínio podem ver todos os avisos.

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 solicitado ou tiver erros de acesso.
  • INVALID_ARGUMENT se a solicitação estiver incorreta.
  • NOT_FOUND se o curso solicitado não existir.

Solicitação HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements

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

Parâmetros de caminho

Parâmetros
courseId

string

Identificador do curso. Esse identificador pode ser atribuído ao Google Sala de Aula ou alias.

Parâmetros de consulta

Parâmetros
announcementStates[]

enum (AnnouncementState)

Uma restrição para state dos avisos foi retornada. Se esse argumento não for especificado, o valor padrão será PUBLISHED.

orderBy

string

Ordem de classificação opcional para os resultados. Uma lista de campos separada por vírgulas com uma palavra-chave opcional de direção de classificação. O campo aceito é updateTime. As palavras-chave de rotas aceitas são asc e desc. Se não for especificado, updateTime desc será o comportamento padrão. Exemplos: updateTime asc, updateTime

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 que o especificado.

pageToken

string

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

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

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta ao listar o trabalho do curso.

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

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

object (Announcement)

Itens de aviso que correspondem à solicitação.

nextPageToken

string

Token que identifica a próxima página de resultados a serem retornados. Se estiver vazio, nenhum outro resultado estará disponível.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

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