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

Identificador atribuído do Google Sala de Aula deste aviso, exclusivo por curso.

Somente leitura.

text

string

É a descrição deste aviso. 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 materiais.

state

enum (AnnouncementState)

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

creationTime

string (Timestamp format)

É o carimbo de data/hora em que o 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 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)

É o modo do usuário atribuído. Se não for especificado, o valor padrão será ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identificadores de estudantes com acesso ao aviso. Este campo só será definido se assigneeMode for INDIVIDUAL_STUDENTS. Se assigneeMode for INDIVIDUAL_STUDENTS, só os estudantes especificados nesse campo vão poder ver o aviso.

creatorUserId

string

Identificador do usuário que criou o aviso.

Somente leitura.

Estado do aviso

Possíveis estados dos 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. Os avisos só ficam visíveis para os professores e administradores do domínio.
DELETED Status do aviso que foi publicado, mas foi excluído. Os avisos só ficam visíveis para os professores e administradores do domínio. Os avisos nesse estado serão excluídos após algum tempo.

Métodos

create

Cria um aviso.

delete

Exclui um aviso.

get

Retorna um aviso.

list

Retorna uma lista de avisos que o solicitante pode ver.

modifyAssignees

Modifica o modo de usuário e as opções de um aviso.

patch

Atualiza um ou mais campos de um aviso.