REST Resource: courses.announcements

Recurso: Anuncio

Anuncio creado por un profesor para los alumnos del curso

Representación 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

Es el identificador del curso.

Solo lectura

id

string

Es el identificador asignado por el aula de este anuncio, único por curso.

Solo lectura

text

string

Descripción de este anuncio. El texto debe ser una string UTF-8 válida que no contenga más de 30,000 caracteres.

materials[]

object (Material)

Materiales adicionales.

Los anuncios no deben tener más de 20 elementos de material.

state

enum (AnnouncementState)

Estado de este anuncio. Si no se especifica, el estado predeterminado es DRAFT.

creationTime

string (Timestamp format)

Marca de tiempo de la creación de este anuncio.

Solo lectura

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Marca de tiempo del cambio más reciente en este anuncio.

Solo lectura

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

scheduledTime

string (Timestamp format)

Es una marca de tiempo opcional en la que se programó la publicación de este anuncio.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

assigneeMode

enum (AssigneeMode)

Modo de usuario asignado del anuncio. Si no se especifica, el valor predeterminado es ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Identificadores de alumnos con acceso al anuncio. Este campo se establece solo si assigneeMode es INDIVIDUAL_STUDENTS. Si el assigneeMode es INDIVIDUAL_STUDENTS, solo los alumnos especificados en este campo podrán ver el anuncio.

creatorUserId

string

Es el identificador del usuario que creó el anuncio.

Solo lectura

Estado del anuncio

Estados posibles de anuncios

Enumeradores
ANNOUNCEMENT_STATE_UNSPECIFIED No se especificó ningún estado. Nunca se muestra.
PUBLISHED Estado del anuncio que se publicó Este es el estado predeterminado.
DRAFT Es el estado de un anuncio que aún no se publicó. Solo los docentes y administradores del dominio pueden ver el anuncio en este estado.
DELETED Es el estado del anuncio que se publicó, pero que ahora se borró. Solo los docentes y administradores del dominio pueden ver el anuncio en este estado. El anuncio en este estado se borra después de un tiempo.

Métodos

create

Crea un anuncio.

delete

Borra un anuncio.

get

Muestra un anuncio.

list

Muestra una lista de anuncios que el solicitante puede ver.

modifyAssignees

Modifica el modo de usuario asignado y las opciones de un anuncio.

patch

Actualiza uno o más campos de un anuncio.