REST Resource: courses.announcements

Recurso: anúncio

Aviso criado 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 pelo Google Sala de Aula para este aviso, exclusivo por curso.

Somente leitura.
text

string

Descrição do anúncio. O texto precisa ser uma string UTF-8 válida com no máximo 30.000 caracteres.
materials[]

object (Material)

Materiais extras.

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

enum (AnnouncementState)

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

string (Timestamp format)

Carimbo de data/hora em que o anúncio foi criado.

Somente leitura.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes 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 neste anúncio.

Somente leitura.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes 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 em que o anúncio está programado para ser publicado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes 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, somente os estudantes especificados nesse campo poderão ver o aviso.
creatorUserId

string

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

Somente leitura.

AnnouncementState

Estados possíveis dos anúncios

Tipos enumerados
ANNOUNCEMENT_STATE_UNSPECIFIED Nenhum estado especificado. Esse valor nunca é retornado.
PUBLISHED Status do aviso publicado. Esse é o estado padrão.
DRAFT Status de um aviso que ainda não foi publicado. O aviso nesse estado fica visível apenas para professores do curso e administradores do domínio.
DELETED Status de um aviso que foi publicado, mas agora está excluído. O aviso nesse estado fica visível apenas para professores do curso e administradores do 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 para 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 ver.

modifyAssignees

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

patch

 Atualiza um ou mais campos de um anúncio.