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, único para cada 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)

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.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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 de este anuncio.

Solo lectura.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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)

Marca de tiempo opcional de la fecha en la que se programó la publicación de este anuncio.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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 asignado del anuncio. Si no se especifica, el valor predeterminado es ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

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 muestra.
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 publica. Los anuncios en este estado solo son visibles para los profesores del curso y los administradores del dominio.
DELETED Es el estado del anuncio que se publicó, pero que ahora se borró. Los anuncios en este estado solo son visibles para los profesores del curso y los administradores del dominio. Los anuncios en este estado se borran después de un tiempo.

Métodos

create

 Crea un anuncio.

delete

 Borra un anuncio.

get

 Muestra un anuncio.

getAddOnContext

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

list

 Muestra una lista de los anuncios que el solicitante puede ver.

modifyAssignees

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

patch

 Actualiza uno o más campos de un anuncio.