Calendars

Es una colección de todos los calendarios existentes. Consulta también Calendars vs CalendarList.

Para obtener una lista de los métodos de este recurso, consulta el final de esta página.

Representaciones de recursos

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  }
}
Nombre de la propiedad Valor Descripción Notas
conferenceProperties nested object Son las propiedades de conferencia de este calendario, por ejemplo, qué tipos de conferencias se permiten.
conferenceProperties.allowedConferenceSolutionTypes[] list Son los tipos de soluciones de conferencia que se admiten para este calendario.

Los siguientes son los valores posibles:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
Opcional.
dataOwner string Es el correo electrónico del propietario del calendario. Solo se establece para los calendarios secundarios. Solo lectura.
description string Es la descripción del calendario. Opcional. admite escritura
etag etag ETag del recurso.
id string Es el identificador del calendario. Para recuperar los IDs, llama al método calendarList.list().
kind string Tipo de recurso ("calendar#calendar").
location string Ubicación geográfica del calendario como texto de formato libre. Opcional. admite escritura
summary string Es el título del calendario. admite escritura
timeZone string Zona horaria del calendario (Con el formato de un nombre de la base de datos de zonas horarias de IANA, p.ej., "Europe/Zurich"). Opcional. admite escritura

Métodos

sencillo
Borra un calendario principal. Esta operación borra todos los eventos asociados al calendario principal de una cuenta.
borrar
Borra un calendario secundario. Usa calendars.clear para borrar todos los eventos de los calendarios principales.
get
Devuelve los metadatos de un calendario.
insertar
Crea un calendario secundario.

El usuario autenticado para la solicitud se convierte en propietario de los datos del calendario nuevo.

patch
Actualiza los metadatos de un calendario. Este método es compatible con la semántica de parches. Ten en cuenta que cada solicitud de parche consume tres unidades de cuota. Es preferible usar un get seguido de un update. Los valores de campo que especifiques reemplazarán los valores existentes. Los campos que no especifiques en la solicitud permanecerán sin cambios. Los campos de array, si se especifican, reemplazan los arrays existentes, lo que descarta cualquier elemento de array anterior.
actualizar
Actualiza los metadatos de un calendario.