REST Resource: courses.announcements

Recurso: aviso

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

É o identificador deste aviso atribuído pelo Google Sala de Aula, exclusivo por curso.

Somente leitura.

text

string

Descrição deste aviso. O texto precisa ser uma string UTF-8 válida contendo no máximo 30.000 caracteres.

materials[]

object (Material)

Materiais adicionais.

Os anúncios não podem ter mais de 20 itens do Material Design.

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 em que este aviso foi criado.

Somente leitura.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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 RFC3339 UTC "Zulu", 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 do agendamento da publicação do aviso.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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 do usuário atribuído 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. Esse campo só será definido se assigneeMode for INDIVIDUAL_STUDENTS. Se assigneeMode for INDIVIDUAL_STUDENTS, somente os alunos especificados nesse campo poderão ver o aviso.

creatorUserId

string

Identificador do usuário que criou o aviso.

Somente leitura.

AnnouncementState

Possíveis estados dos avisos

Enums
ANNOUNCEMENT_STATE_UNSPECIFIED Nenhum estado especificado. Ele 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. Os avisos nesse estado ficam visíveis apenas para os professores do curso e os administradores do domínio.
DELETED Status do aviso que foi publicado, mas foi excluído. Os avisos nesse estado ficam visíveis apenas para os professores do curso e os administradores do domínio. Os avisos neste estado são excluídos 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 do responsável e as opções de um aviso.

patch

Atualiza um ou mais campos de um aviso.