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 que Classroom asigna a este anuncio, único por curso.

Solo lectura.

text

string

Es la 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 materiales.

state

enum (AnnouncementState)

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

creationTime

string (Timestamp format)

Marca de tiempo del momento en que se creó este anuncio.

Solo lectura.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. 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 que se realizó en este anuncio.

Solo lectura.

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

scheduledTime

string (Timestamp format)

Es la marca de tiempo opcional de la fecha en que está programada 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 fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

assigneeMode

enum (AssigneeMode)

Modo del anuncio para el destinatario. Si no se especifica, el valor predeterminado es ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

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

creatorUserId

string

Es el identificador del usuario que creó el anuncio.

Solo lectura.

AnnouncementState

Posibles estados de los anuncios

Enumeradores
ANNOUNCEMENT_STATE_UNSPECIFIED No se especificó ningún estado. Este 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ó. Los anuncios con este estado solo son visibles para los profesores del curso y los administradores del dominio.
DELETED Estado del anuncio que se publicó, pero ahora se borró. Los anuncios con este estado solo son visibles para los profesores del curso y los administradores del dominio. Los anuncios con 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 para los complementos de Classroom en el contexto de una publicación específica.

list

Muestra una lista de anuncios que el solicitante tiene permitido ver.

modifyAssignees

Modifica el modo de destinatario y las opciones de un anuncio.

patch

Actualiza uno o más campos de un anuncio.