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 de este anuncio asignado por Classroom, ú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)

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 una 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 una 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 se programó la publicación de este anuncio.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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)

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

individualStudentsOptions

object (IndividualStudentsOptions)

Los identificadores de los estudiantes con 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 podrán ver el anuncio.

creatorUserId

string

Es el identificador del usuario que creó el anuncio.

Solo lectura.

AnnouncementState

Posibles estados de los anuncios

Enumeraciones
ANNOUNCEMENT_STATE_UNSPECIFIED No se especificó ningún estado. Nunca se devuelve.
PUBLISHED Estado del anuncio que se publicó. Este es el estado predeterminado.
DRAFT 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 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 con este estado se borra después de un tiempo.

Métodos

create

Crea un anuncio.

delete

Borra un anuncio.

get

Muestra un anuncio.

getAddOnContext

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

list

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