REST Resource: courses.announcements

Recurso: anúncio

Aviso criado por um professor para os alunos 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 deste aviso atribuído pelo Google Sala de Aula. Ele é exclusivo para cada curso.

Somente leitura.

text

string

É a descrição deste anúncio. O texto precisa ser uma string UTF-8 válida com até 30.000 caracteres.

materials[]

object (Material)

Materiais adicionais.

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

state

enum (AnnouncementState)

Status deste aviso. Se não for especificado, o estado padrão será DRAFT.

creationTime

string (Timestamp format)

Carimbo de data/hora de quando este aviso foi criado.

Somente leitura.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

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

Somente leitura.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

scheduledTime

string (Timestamp format)

Carimbo de data/hora opcional de quando este aviso está programado para ser publicado.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

assigneeMode

enum (AssigneeMode)

Modo de usuário do aviso. Se não for especificado, o valor padrão será ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Os identificadores dos estudantes com acesso ao aviso. Este campo só será definido se assigneeMode for INDIVIDUAL_STUDENTS. Se assigneeMode for INDIVIDUAL_STUDENTS, apenas os alunos especificados neste campo poderão ver o aviso.

creatorUserId

string

Identificador do usuário que criou o aviso.

Somente leitura.

AnnouncementState

Possíveis estados dos anúncios

Enums
ANNOUNCEMENT_STATE_UNSPECIFIED Nenhum estado especificado. 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 aviso nesse estado é visível apenas para os professores do curso e administradores do domínio.
DELETED Status do aviso que foi publicado, mas foi excluído. O aviso nesse estado é visível apenas para os professores do curso e administradores do domínio. O anúncio neste estado é excluído após algum tempo.

Métodos

create

Cria um aviso.

delete

Exclui um aviso.

get

Retorna um aviso.

getAddOnContext

Recebe metadados dos 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 do usuário atribuído e as opções de um aviso.

patch

Atualiza um ou mais campos de um aviso.