REST Resource: courses.announcements

Recurso: aviso

Avisos criados por um professor para os estudantes do curso

Representação JSON 
{
  "courseId": string,
  "id": string,
  "text": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (AnnouncementState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string
}
Campos
courseId

string

Identificador do curso.

Somente leitura.
id

string

Identificador atribuído pela sala de aula para este aviso, exclusivo para cada curso.

Somente leitura.
text

string

Descrição deste anúncio. O texto precisa ser uma string UTF-8 válida que não contenha mais de 30.000 caracteres.
materials[]

object (Material)

Outros materiais.

Os avisos não podem ter mais de 20 itens de material.
state

enum (AnnouncementState)

Status deste anúncio. Se não for especificado, o estado padrão será DRAFT.
creationTime

string (Timestamp format)

Carimbo de data/hora em que esse aviso foi criado.

Somente leitura.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Carimbo de data/hora da mudança mais recente nesse aviso.

Somente leitura.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

Carimbo de data/hora opcional quando este anúncio está programado para ser publicado.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
assigneeMode

enum (AssigneeMode)

Modo de atribuição do aviso. Se não for especificado, o valor padrão será ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identificadores dos estudantes com acesso ao aviso. Esse campo só será definido se assigneeMode for INDIVIDUAL_STUDENTS. Se o assigneeMode for INDIVIDUAL_STUDENTS, apenas os estudantes especificados nesse campo poderão ver o aviso.
creatorUserId

string

Identificador do usuário que criou o anúncio.

Somente leitura.

AnnouncementState

Possíveis estados de avisos

Enums
ANNOUNCEMENT_STATE_UNSPECIFIED Nenhum estado especificado. Isso nunca é retornado.
PUBLISHED Status do aviso que foi publicado. Esse é o estado padrão.
DRAFT Status de um aviso que ainda não foi publicado. O anúncio nesse estado só fica visível para professores do curso e administradores de domínio.
DELETED Status do aviso que foi publicado, mas agora foi excluído. O anúncio nesse estado só fica visível para professores do curso e administradores de domínio. O aviso nesse estado é excluído após algum tempo.

Métodos

create

 Cria um aviso.

delete

 Exclui um aviso.

get

 Retorna um aviso.

getAddOnContext

 Recebe metadados de complementos do Google Sala de aula no contexto de uma postagem específica.

list

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

modifyAssignees

 Modifica o modo e as opções de atribuição de um anúncio.

patch

 Atualiza um ou mais campos de um aviso.