REST Resource: courses.announcements

Recurso: Anuncio

Anuncio creado por un profesor para los estudiantes 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 Classroom a este anuncio, que es único por curso.

Solo lectura.
text

string

Descripción de este anuncio. El texto debe ser una cadena 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)

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

string (Timestamp format)

Es la marca de tiempo de la creación de este anuncio.

Solo lectura.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Es la marca de tiempo del cambio más reciente en este anuncio.

Solo lectura.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

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

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
assigneeMode

enum (AssigneeMode)

Es el modo de asignación del anuncio. Si no se especifica, el valor predeterminado es ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Son los identificadores de los estudiantes que tienen acceso al anuncio. Este campo solo se establece si assigneeMode es INDIVIDUAL_STUDENTS. Si assigneeMode es INDIVIDUAL_STUDENTS, solo los estudiantes especificados en este campo pueden ver el anuncio.
creatorUserId

string

Es el identificador del usuario que creó el anuncio.

Solo lectura.

AnnouncementState

Estados posibles de los anuncios

Enumeraciones
ANNOUNCEMENT_STATE_UNSPECIFIED No se especificó ningún estado. Este valor nunca se devuelve.
PUBLISHED Es el estado del anuncio que se publicó. Este es el estado predeterminado.
DRAFT Es el estado de un anuncio que aún no se publicó. El anuncio en este estado solo es visible para los profesores del curso y los administradores del dominio.
DELETED Es el estado del anuncio que se publicó, pero que ahora se borró. El anuncio en este estado solo es visible para los profesores del curso y los administradores del dominio. El anuncio en este estado se borra después de un tiempo.

Métodos

create

 Crea un anuncio.

delete

 Borra un anuncio.

get

 Devuelve un anuncio.

getAddOnContext

 Obtiene metadatos para los complementos de Classroom en el contexto de una publicación específica.

list

 Devuelve una lista de los anuncios que el solicitante tiene permiso para ver.

modifyAssignees

 Modifica el modo y las opciones de asignación de un anuncio.

patch

 Actualiza uno o más campos de un anuncio.