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 pelo Classroom 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.

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 nesse 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 em que este anúncio está programado para ser publicado.

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 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ó é 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 aviso.

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 os 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 os 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.