Se usó la API de Cloud Translation para traducir esta página.

Events

La API de Calendar ofrece diferentes variantes de recursos de eventos. Puedes encontrar más información en el artículo Acerca de los eventos.

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

Representaciones de recursos

{
  "kind": "calendar#event",
  "etag": etag,
  "id": string,
  "status": string,
  "htmlLink": string,
  "created": datetime,
  "updated": datetime,
  "summary": string,
  "description": string,
  "location": string,
  "colorId": string,
  "creator": {
    "id": string,
    "email": string,
    "displayName": string,
    "self": boolean
  },
  "organizer": {
    "id": string,
    "email": string,
    "displayName": string,
    "self": boolean
  },
  "start": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "end": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "endTimeUnspecified": boolean,
  "recurrence": [
    string
  ],
  "recurringEventId": string,
  "originalStartTime": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "transparency": string,
  "visibility": string,
  "iCalUID": string,
  "sequence": integer,
  "attendees": [
    {
      "id": string,
      "email": string,
      "displayName": string,
      "organizer": boolean,
      "self": boolean,
      "resource": boolean,
      "optional": boolean,
      "responseStatus": string,
      "comment": string,
      "additionalGuests": integer
    }
  ],
  "attendeesOmitted": boolean,
  "extendedProperties": {
    "private": {
      (key): string
    },
    "shared": {
      (key): string
    }
  },
  "hangoutLink": string,
  "conferenceData": {
    "createRequest": {
      "requestId": string,
      "conferenceSolutionKey": {
        "type": string
      },
      "status": {
        "statusCode": string
      }
    },
    "entryPoints": [
      {
        "entryPointType": string,
        "uri": string,
        "label": string,
        "pin": string,
        "accessCode": string,
        "meetingCode": string,
        "passcode": string,
        "password": string
      }
    ],
    "conferenceSolution": {
      "key": {
        "type": string
      },
      "name": string,
      "iconUri": string
    },
    "conferenceId": string,
    "signature": string,
    "notes": string,
  },
  "gadget": {
    "type": string,
    "title": string,
    "link": string,
    "iconLink": string,
    "width": integer,
    "height": integer,
    "display": string,
    "preferences": {
      (key): string
    }
  },
  "anyoneCanAddSelf": boolean,
  "guestsCanInviteOthers": boolean,
  "guestsCanModify": boolean,
  "guestsCanSeeOtherGuests": boolean,
  "privateCopy": boolean,
  "locked": boolean,
  "reminders": {
    "useDefault": boolean,
    "overrides": [
      {
        "method": string,
        "minutes": integer
      }
    ]
  },
  "source": {
    "url": string,
    "title": string
  },
  "workingLocationProperties": {
    "type": string,
    "homeOffice": (value),
    "customLocation": {
      "label": string
    },
    "officeLocation": {
      "buildingId": string,
      "floorId": string,
      "floorSectionId": string,
      "deskId": string,
      "label": string
    }
  },
  "outOfOfficeProperties": {
    "autoDeclineMode": string,
    "declineMessage": string
  },
  "focusTimeProperties": {
    "autoDeclineMode": string,
    "declineMessage": string,
    "chatStatus": string
  },
  "attachments": [
    {
      "fileUrl": string,
      "title": string,
      "mimeType": string,
      "iconLink": string,
      "fileId": string
    }
  ],
  "birthdayProperties": {
    "contact": string,
    "type": string,
    "customTypeName": string
  },
  "eventType": string
}

Nombre de la propiedad	Valor	Descripción	Notas
`anyoneCanAddSelf`	`boolean`	Si alguien puede invitarse a sí mismo al evento (no disponible) Opcional. El valor predeterminado es False.	admite escritura
`attachments[]`	`list`	Archivos adjuntos del evento Para modificar los archivos adjuntos, el parámetro de solicitud `supportsAttachments` debe establecerse en `true`. Puede haber como máximo 25 archivos adjuntos por evento.
`attachments[].fileId`	`string`	Es el ID del archivo adjunto. Solo lectura. En el caso de los archivos de Google Drive, este es el ID de la entrada de recursos `Files` correspondiente en la API de Drive.
`attachments[].fileUrl`	`string`	URL que dirige al archivo adjunto. Para agregar archivos adjuntos de Google Drive, usa el mismo formato que en la propiedad `alternateLink` del recurso `Files` en la API de Drive. Obligatorio cuando se agrega un archivo adjunto.	admite escritura
`attachments[].iconLink`	`string`	Es el vínculo de URL al ícono del archivo adjunto. Este campo solo se puede modificar para archivos adjuntos de terceros personalizados.
`attachments[].mimeType`	`string`	Es el tipo de contenido multimedia de Internet (tipo MIME) del archivo adjunto.
`attachments[].title`	`string`	Título del archivo adjunto.
`attendeesOmitted`	`boolean`	Si se puede haber omitido o no a los asistentes en la representación del evento. Cuando se recupera un evento, esto puede deberse a una restricción especificada por el parámetro de consulta `maxAttendee`. Cuando se actualiza un evento, se puede usar para actualizar solo la respuesta del participante. Opcional. El valor predeterminado es False.	admite escritura
`attendees[]`	`list`	Los asistentes al evento. Consulta la guía Eventos con asistentes para obtener más información sobre cómo programar eventos con otros usuarios del calendario. Las cuentas de servicio deben usar la delegación de autoridad en todo el dominio para propagar la lista de asistentes.	admite escritura
`attendees[].additionalGuests`	`integer`	Cantidad de invitados adicionales. Opcional. El valor predeterminado es 0.	admite escritura
`attendees[].comment`	`string`	Es el comentario de respuesta del asistente. Opcional.	admite escritura
`attendees[].displayName`	`string`	El nombre del asistente, si está disponible Opcional.	admite escritura
`attendees[].email`	`string`	La dirección de correo electrónico del asistente, si está disponible. Este campo debe estar presente cuando se agrega un asistente. Debe ser una dirección de correo electrónico válida según el RFC5322. Obligatorio cuando se agrega un asistente.	admite escritura
`attendees[].id`	`string`	El ID de perfil del asistente, si está disponible
`attendees[].optional`	`boolean`	Indica si se trata de un asistente opcional. Opcional. El valor predeterminado es False.	admite escritura
`attendees[].organizer`	`boolean`	Indica si el asistente es el organizador del evento. Solo lectura. El valor predeterminado es False.
`attendees[].resource`	`boolean`	Indica si el asistente es un recurso. Solo se puede establecer cuando el asistente se agrega al evento por primera vez. Las modificaciones posteriores se ignorarán. Opcional. El valor predeterminado es False.	admite escritura
`attendees[].responseStatus`	`string`	Es el estado de respuesta del asistente. Los valores posibles son los siguientes: "`needsAction`": El asistente no respondió a la invitación (recomendado para eventos nuevos). "`declined`": El asistente rechazó la invitación. "`tentative`": El asistente aceptó la invitación de manera provisoria. "`accepted`": El asistente aceptó la invitación. Advertencia: Si agregas un evento con los valores `declined`, `tentative` o `accepted`, es posible que la respuesta de los asistentes que tengan configurada la configuración “Agregar invitaciones a mi calendario” en “Después de responder a la invitación por correo electrónico” o “Solo si el remitente es conocido” se restablezca a `needsAction` y no vean ningún evento en su calendario, a menos que cambien su respuesta en el correo electrónico de invitación al evento. Además, si se invitan más de 200 personas al evento, el estado de la respuesta no se propaga a los invitados.	admite escritura
`attendees[].self`	`boolean`	Indica si esta entrada representa el calendario en el que aparece esta copia del evento. Solo lectura. El valor predeterminado es False.
`birthdayProperties`	`nested object`	Datos de cumpleaños o eventos especiales Se usa si `eventType` es `"birthday"`. Inmutable.	admite escritura
`birthdayProperties.contact`	`string`	Es el nombre del recurso del contacto al que está vinculado este evento de cumpleaños. Se puede usar para recuperar detalles de contacto de la API de People. Formato: `"people/c12345"`. Solo lectura.
`birthdayProperties.customTypeName`	`string`	Es la etiqueta de tipo personalizada especificada para este evento. Se propaga si `birthdayProperties.type` se establece en `"custom"`. Solo lectura.
`birthdayProperties.type`	`string`	Tipo de cumpleaños o evento especial Los valores posibles son los siguientes: `"anniversary"`: Un aniversario que no sea de cumpleaños. Siempre tiene un `contact`. `"birthday"`: Es un evento de cumpleaños. Este es el valor predeterminado. `"custom"`: Es una fecha especial cuya etiqueta se especifica con mayor detalle en el campo `customTypeName`. Siempre tiene un `contact`. `"other"`: Es una fecha especial que no se incluye en las otras categorías y no tiene una etiqueta personalizada. Siempre tiene un `contact`. `"self"`: Es el cumpleaños del propietario del calendario. No puede tener un `contact`. La API de Calendar solo admite la creación de eventos con el tipo `"birthday"`. No se puede cambiar el tipo después de crear el evento.	admite escritura
`colorId`	`string`	Es el color del evento. Este es un ID que hace referencia a una entrada en la sección `event` de la definición de colores (consulta el extremo de colores). Opcional.	admite escritura
`conferenceData`	`nested object`	La información relacionada con la conferencia, como los detalles de una conferencia de Google Meet Para crear nuevos detalles de la conferencia, usa el campo `createRequest`. Para conservar los cambios, recuerda establecer el parámetro de solicitud `conferenceDataVersion` en `1` para todas las solicitudes de modificación de eventos.	admite escritura
`conferenceData.conferenceId`	`string`	Es el ID de la conferencia. Los desarrolladores pueden usarlo para hacer un seguimiento de las conferencias, pero no debe mostrarse a los usuarios. El valor del ID se forma de manera diferente para cada tipo de solución de conferencia: `eventHangout`: No se configuró el ID. (Este tipo de conferencia dejó de estar disponible). `eventNamedHangout`: ID es el nombre del Hangout. (Este tipo de conferencia dejó de estar disponible). `hangoutsMeet`: El ID es el código de reunión de 10 letras, por ejemplo `aaa-bbbb-ccc`. `addOn`: El proveedor de terceros define el ID. Opcional.
`conferenceData.conferenceSolution`	`nested object`	La solución de videoconferencia, como Google Meet No establecida para una conferencia con solicitud de creación fallida. Se requiere `conferenceSolution` y al menos un `entryPoint`, o bien `createRequest`.
`conferenceData.conferenceSolution.iconUri`	`string`	El ícono visible para el usuario de esta solución.
`conferenceData.conferenceSolution.key`	`nested object`	Es la clave que puede identificar de manera única la solución de la conferencia para este evento.
`conferenceData.conferenceSolution.key.type`	`string`	El tipo de solución de conferencia. Si un cliente encuentra un tipo desconocido o vacío, debería poder mostrar los puntos de entrada. Sin embargo, no debe permitir modificaciones. Los siguientes son los valores posibles: `"eventHangout"` para Hangouts para consumidores (obsoleto; es posible que los eventos existentes muestren este tipo de solución de conferencia, pero no se pueden crear conferencias nuevas) `"eventNamedHangout"` para la versión clásica de Hangouts para usuarios de Google Workspace (obsoleto; es posible que los eventos existentes muestren este tipo de solución de conferencia, pero no se pueden crear conferencias nuevas) `"hangoutsMeet"` para Google Meet (http://meet.google.com) `"addOn"` para proveedores de conferencias externos
`conferenceData.conferenceSolution.name`	`string`	Es el nombre visible para el usuario de esta solución. No se localiza.
`conferenceData.createRequest`	`nested object`	Es una solicitud para generar una conferencia nueva y adjuntarla al evento. Los datos se generan de forma asíncrona. Para ver si los datos están presentes, verifica el campo `status`. Se requiere `conferenceSolution` y, al menos, un `entryPoint` o `createRequest`.
`conferenceData.createRequest.conferenceSolutionKey`	`nested object`	La solución de conferencias, como Hangouts o Google Meet
`conferenceData.createRequest.conferenceSolutionKey.type`	`string`	El tipo de solución de conferencia. Si un cliente encuentra un tipo desconocido o vacío, debería poder mostrar los puntos de entrada. Sin embargo, no debe permitir modificaciones. Los siguientes son los valores posibles: `"eventHangout"` para Hangouts para consumidores (obsoleto; es posible que los eventos existentes muestren este tipo de solución de conferencia, pero no se pueden crear conferencias nuevas) `"eventNamedHangout"` para la versión clásica de Hangouts para usuarios de Google Workspace (obsoleto; es posible que los eventos existentes muestren este tipo de solución de conferencia, pero no se pueden crear conferencias nuevas) `"hangoutsMeet"` para Google Meet (http://meet.google.com) `"addOn"` para proveedores de conferencias externos
`conferenceData.createRequest.requestId`	`string`	El ID único que genera el cliente para esta solicitud. Los clientes deben volver a generar este ID para cada solicitud nueva. Si el ID proporcionado es el mismo que el de la solicitud anterior, se ignora la solicitud.
`conferenceData.createRequest.status`	`nested object`	Es el estado de la solicitud de creación de la conferencia.
`conferenceData.createRequest.status.statusCode`	`string`	Es el estado actual de la solicitud de creación de la conferencia. Solo lectura. Los siguientes son los valores posibles: `"pending"`: Todavía se está procesando la solicitud de creación de conferencia. `"success"`: La solicitud de creación de la conferencia se realizó correctamente, y se propagaron los puntos de entrada. `"failure"`: La solicitud de creación de la conferencia falló, no hay puntos de entrada.
`conferenceData.entryPoints[]`	`list`	Información sobre los puntos de entrada individuales de la conferencia, como URLs o números de teléfono Todos deben pertenecer a la misma conferencia. Se requiere `conferenceSolution` y, al menos, un `entryPoint` o `createRequest`.
`conferenceData.entryPoints[].accessCode`	`string`	El código de acceso para acceder a la conferencia La longitud máxima es de 128 caracteres. Cuando crees datos de conferencias nuevos, propaga solo el subconjunto de campos {`meetingCode`, `accessCode`, `passcode`, `password`, `pin`} que coincidan con la terminología que usa el proveedor de la conferencia. Solo se deben mostrar los campos propagados. Opcional.
`conferenceData.entryPoints[].entryPointType`	`string`	Es el tipo de punto de entrada de la conferencia. Los valores posibles son: `"video"`: Unirse a una conferencia a través de HTTP Una conferencia puede tener cero o un punto de entrada `video`. `"phone"`: Unirse a una conferencia marcando un número de teléfono. Una conferencia puede tener cero o más puntos de entrada `phone`. `"sip"`: Unirse a una conferencia a través de SIP. Una conferencia puede tener cero o un punto de entrada `sip`. `"more"`: Instrucciones adicionales para unirse a la conferencia, por ejemplo, números de teléfono adicionales. Una conferencia puede tener cero o un punto de entrada `more`. Una conferencia con solo un punto de entrada `more` no es una conferencia válida.
`conferenceData.entryPoints[].label`	`string`	Es la etiqueta del URI. Visible para los usuarios finales. No se localiza. La longitud máxima es de 512 caracteres. Ejemplos: para `video`: meet.google.com/aaa-bbbb-ccc para `phone`: +1 123 268 2601 para `sip`: 12345678@altostrat.com para `more`: No se debe completar. Opcional.
`conferenceData.entryPoints[].meetingCode`	`string`	El código de reunión para acceder a la conferencia La longitud máxima es de 128 caracteres. Cuando crees datos de conferencias nuevos, propaga solo el subconjunto de campos {`meetingCode`, `accessCode`, `passcode`, `password`, `pin`} que coincidan con la terminología que usa el proveedor de la conferencia. Solo se deben mostrar los campos propagados. Opcional.
`conferenceData.entryPoints[].passcode`	`string`	La contraseña para acceder a la conferencia La longitud máxima es de 128 caracteres. Cuando crees datos de conferencias nuevos, propaga solo el subconjunto de campos {`meetingCode`, `accessCode`, `passcode`, `password`, `pin`} que coincidan con la terminología que usa el proveedor de la conferencia. Solo se deben mostrar los campos completados.
`conferenceData.entryPoints[].password`	`string`	La contraseña para acceder a la conferencia. La longitud máxima es de 128 caracteres. Cuando crees datos de conferencias nuevos, propaga solo el subconjunto de campos {`meetingCode`, `accessCode`, `passcode`, `password`, `pin`} que coincidan con la terminología que usa el proveedor de la conferencia. Solo se deben mostrar los campos propagados. Opcional.
`conferenceData.entryPoints[].pin`	`string`	El PIN para acceder a la conferencia La longitud máxima es de 128 caracteres. Cuando crees datos de conferencias nuevos, propaga solo el subconjunto de campos {`meetingCode`, `accessCode`, `passcode`, `password`, `pin`} que coincidan con la terminología que usa el proveedor de la conferencia. Solo se deben mostrar los campos propagados. Opcional.
`conferenceData.entryPoints[].uri`	`string`	Es el URI del punto de entrada. La longitud máxima es de 1,300 caracteres. Formato: para los esquemas `video`, `http:` o `https:`. para `phone`, se requiere el esquema `tel:`. El URI debe incluir la secuencia de marcado completa (p. ej., tel.:+12345678900,,123456789;1234). para `sip`, se requiere el esquema `sip:`, p.ej., sip:12345678@miproveedor.com. para `more`, `http:` o `https:`, se requiere el esquema
`conferenceData.notes`	`string`	Son notas adicionales (como instrucciones del administrador del dominio o avisos legales) que se mostrarán al usuario. Puede contener HTML. La longitud máxima es de 2,048 caracteres. Opcional.
`conferenceData.signature`	`string`	La firma de los datos de la conferencia Se genera en el servidor. No establecida para una conferencia con solicitud de creación fallida. Opcional para una conferencia con una solicitud de creación pendiente.
`created`	`datetime`	Hora de creación del evento (como una marca de tiempo RFC3339) Solo lectura.
`creator`	`object`	Es el creador del evento. Solo lectura.
`creator.displayName`	`string`	Es el nombre del creador, si está disponible.
`creator.email`	`string`	La dirección de correo electrónico del creador, si está disponible
`creator.id`	`string`	El ID de perfil del creador, si está disponible
`creator.self`	`boolean`	Si el creador corresponde al calendario en el que aparece esta copia del evento. Solo lectura. El valor predeterminado es False.
`description`	`string`	Descripción del evento. Puede contener HTML. Opcional.	admite escritura
`end`	`nested object`	Es la hora de finalización (exclusiva) del evento. En el caso de un evento recurrente, esta es la hora de finalización de la primera instancia.
`end.date`	`date`	Es la fecha, en el formato "aaaa-mm-dd", si se trata de un evento de todo el día.	admite escritura
`end.dateTime`	`datetime`	La hora, como un valor de fecha y hora combinado (con el formato de RFC3339) Se requiere un desplazamiento de zona horaria, a menos que se especifique explícitamente una zona horaria en `timeZone`.	admite escritura
`end.timeZone`	`string`	Es la zona horaria en la que se especifica la hora. (con el formato de un nombre de la base de datos de zonas horarias de IANA, p.ej., "Europe/Zurich"). Para los eventos recurrentes, este campo es obligatorio y especifica la zona horaria en la que se expande la recurrencia. Para los eventos individuales, este campo es opcional e indica una zona horaria personalizada para el inicio y la finalización del evento.	admite escritura
`endTimeUnspecified`	`boolean`	Si la hora de finalización no está realmente especificada. Se sigue proporcionando una hora de finalización por motivos de compatibilidad, incluso si este atributo se establece como verdadero. El valor predeterminado es False.
`etag`	`etag`	ETag del recurso.
`eventType`	`string`	Es el tipo específico del evento. No se puede modificar después de crear el evento. Los valores posibles son los siguientes: "`birthday`": Es un evento especial de todo el día con una recurrencia anual. "`default`": Es un evento normal o no se especifica más. "`focusTime`": Es un evento de tiempo dedicado. "`fromGmail`": Un evento de Gmail. No se puede crear este tipo de evento. "`outOfOffice`": Un evento fuera de la oficina. "`workingLocation`": Es un evento de ubicación de trabajo.	admite escritura
`extendedProperties`	`object`	Son las propiedades extendidas del evento.
`extendedProperties.private`	`object`	Son propiedades privadas de la copia del evento que aparece en este calendario.	admite escritura
`extendedProperties.private.(key)`	`string`	El nombre de la propiedad privada y el valor correspondiente.
`extendedProperties.shared`	`object`	Propiedades que se comparten entre copias del evento en los calendarios de otros asistentes.	admite escritura
`extendedProperties.shared.(key)`	`string`	El nombre de la propiedad compartida y el valor correspondiente.
`focusTimeProperties`	`nested object`	Datos del evento de tiempo dedicado Se usa si `eventType` es `focusTime`.	admite escritura
`focusTimeProperties.autoDeclineMode`	`string`	Si se rechazan las invitaciones a reuniones que se superponen con los eventos de tiempo dedicado Los valores válidos son `declineNone`, que significa que no se rechazan invitaciones a reuniones; `declineAllConflictingInvitations`, que significa que se rechazan todas las invitaciones a reuniones en conflicto con el evento; y `declineOnlyNewConflictingInvitations`, que significa que solo se deben rechazar las invitaciones a reuniones nuevas en conflicto que lleguen mientras el evento de tiempo dedicado esté presente.
`focusTimeProperties.chatStatus`	`string`	El estado para marcar al usuario en Chat y los productos relacionados. Puede ser `available` o `doNotDisturb`.
`focusTimeProperties.declineMessage`	`string`	Es el mensaje de respuesta que se establecerá si el Calendario rechaza automáticamente un evento existente o una invitación nueva.
`gadget`	`object`	Un gadget que extiende este evento. Los gadgets dejaron de estar disponibles. En cambio, esta estructura solo se usa para mostrar los metadatos del calendario de cumpleaños.
`gadget.display`	`string`	Es el modo de visualización del gadget. Obsoleta. Los valores posibles son los siguientes: "`icon`": El gadget se muestra junto al título del evento en la vista de calendario. "`chip`": El gadget se muestra cuando se hace clic en el evento.	admite escritura
`gadget.height`	`integer`	Es la altura del gadget en píxeles. La altura debe ser un número entero mayor que 0. Opcional. Obsoleta.	admite escritura
`gadget.iconLink`	`string`	La URL del ícono del gadget. El esquema de la URL debe ser HTTPS. Obsoleta.	admite escritura
`gadget.link`	`string`	La URL del gadget. El esquema de URL debe ser HTTPS. Obsoleta.	admite escritura
`gadget.preferences`	`object`	Preferencias.	admite escritura
`gadget.preferences.(key)`	`string`	El nombre de la preferencia y el valor correspondiente.
`gadget.title`	`string`	Es el título del gadget. Obsoleta.	admite escritura
`gadget.type`	`string`	Es el tipo de gadget. Obsoleta.	admite escritura
`gadget.width`	`integer`	Es el ancho del gadget en píxeles. El ancho debe ser un número entero mayor que 0. Opcional. Obsoleta.	admite escritura
`guestsCanInviteOthers`	`boolean`	Indica si los asistentes que no sean el organizador pueden invitar a otras personas al evento. Opcional. El valor predeterminado es True.	admite escritura
`guestsCanModify`	`boolean`	Indica si los asistentes que no sean el organizador pueden modificar el evento. Opcional. El valor predeterminado es False.	admite escritura
`guestsCanSeeOtherGuests`	`boolean`	Indica si los asistentes que no sean el organizador pueden ver quiénes son los asistentes del evento. Opcional. El valor predeterminado es True.	admite escritura
`hangoutLink`	`string`	Es un vínculo absoluto al Hangout de Google asociado con este evento. Solo lectura.
`htmlLink`	`string`	Es un vínculo absoluto a este evento en la IU web del Calendario de Google. Solo lectura.
`iCalUID`	`string`	Es el identificador único del evento, como se define en RFC5545. Se usa para identificar eventos de forma exclusiva en todos los sistemas de calendarios y se debe proporcionar cuando se importan eventos a través del método import. Ten en cuenta que `iCalUID` y `id` no son idénticos y que solo se debe proporcionar uno de ellos en el momento de la creación del evento. Una diferencia en su semántica es que, en los eventos recurrentes, todos los casos de un evento tienen diferentes `id`, mientras que todos comparten los mismos `iCalUID`. Para recuperar un evento con su `iCalUID`, llama al método events.list con el parámetro `iCalUID`. Para recuperar un evento mediante su `id`, llama al método events.get.
`id`	`string`	Es el identificador opaco del evento. Al crear nuevos eventos únicos o recurrentes, puedes especificar sus IDs. Los IDs proporcionados deben seguir estas reglas: Los caracteres permitidos en el ID son los que se usan en la codificación base32hex, es decir, letras minúsculas de la a a la v y dígitos del 0 al 9.Consulta la sección 3. 1.2 de la RFC2938. La longitud del ID debe ser de entre 5 y 1,024 caracteres. El ID debe ser único para cada calendario. Debido a la naturaleza distribuida a nivel global del sistema, no podemos garantizar que las colisiones de IDs se detecten en el momento de la creación del evento. Para minimizar el riesgo de colisiones, recomendamos usar un algoritmo de UUID establecido, como el que se describe en RFC4122. Si no especificas un ID, el servidor lo generará automáticamente. Ten en cuenta que `icalUID` y `id` no son idénticos y que solo se debe proporcionar uno de ellos en el momento de la creación del evento. Una diferencia en su semántica es que, en los eventos recurrentes, todos los casos de un evento tienen diferentes `id`, mientras que todos comparten los mismos `icalUID`.	admite escritura
`kind`	`string`	Es el tipo de recurso ("`calendar#event`").
`location`	`string`	Es la ubicación geográfica del evento como texto de formato libre. Opcional.	admite escritura
`locked`	`boolean`	Indica si se trata de una copia de evento bloqueada en la que no se pueden realizar cambios en los campos principales del evento "summary", "description", "location", "start", "end" o "recurrence". El valor predeterminado es False. Solo lectura.
`organizer`	`object`	El organizador del evento. Si el organizador también es un asistente, esto se indica con una entrada separada en `attendees` con el campo `organizer` establecido en Verdadero. Para cambiar el organizador, usa la operación move. De solo lectura, excepto cuando se importa un evento.	admite escritura
`organizer.displayName`	`string`	Nombre del organizador, si está disponible.	admite escritura
`organizer.email`	`string`	Dirección de correo electrónico del organizador, si está disponible. Debe ser una dirección de correo electrónico válida, según RFC5322.	admite escritura
`organizer.id`	`string`	El ID de perfil del organizador, si está disponible
`organizer.self`	`boolean`	Si el organizador corresponde al calendario en el que aparece esta copia del evento. Solo lectura. El valor predeterminado es False.
`originalStartTime`	`nested object`	Para una instancia de un evento recurrente, esta es la hora en la que este evento comenzaría según los datos de recurrencia en el evento recurrente identificado por recurringEventId. Identifica de forma exclusiva la instancia dentro de la serie de eventos recurrentes, incluso si se trasladó a un horario diferente. Inmutable.
`originalStartTime.date`	`date`	Es la fecha, en el formato “aaaa-mm-dd”, si el evento dura todo el día.	admite escritura
`originalStartTime.dateTime`	`datetime`	La hora, como un valor de fecha y hora combinado (con el formato de RFC3339) Se requiere una compensación de zona horaria, a menos que se especifique una zona horaria de forma explícita en `timeZone`.	admite escritura
`originalStartTime.timeZone`	`string`	Es la zona horaria en la que se especifica la hora. (con el formato de un nombre de la base de datos de zonas horarias de IANA, p.ej., "Europe/Zurich"). Para los eventos recurrentes, este campo es obligatorio y especifica la zona horaria en la que se expande la recurrencia. Para los eventos individuales, este campo es opcional e indica una zona horaria personalizada para el inicio y la finalización del evento.	admite escritura
`outOfOfficeProperties`	`nested object`	Datos del evento fuera de la oficina. Se usa si `eventType` es `outOfOffice`.	admite escritura
`outOfOfficeProperties.autoDeclineMode`	`string`	Establece si se deben rechazar invitaciones a reuniones que se superpongan con los eventos fuera de la oficina. Los valores válidos son `declineNone`, que significa que no se rechazan invitaciones a reuniones; `declineAllConflictingInvitations`, que significa que se rechazan todas las invitaciones a reuniones en conflicto con el evento; y `declineOnlyNewConflictingInvitations`, que significa que solo se deben rechazar las invitaciones a reuniones nuevas en conflicto que lleguen mientras el evento Ausente esté presente.
`outOfOfficeProperties.declineMessage`	`string`	Mensaje de respuesta para establecer si el Calendario rechaza automáticamente un evento existente o una invitación nueva.
`privateCopy`	`boolean`	Si la estableces como verdadera, se inhabilitará la Propagación de eventos. Ten en cuenta que no es lo mismo que las propiedades de eventos privados. Opcional. Inmutable. El valor predeterminado es False.
`recurrence[]`	`list`	Es la lista de líneas RRULE, EXRULE, RDATE y EXDATE para un evento recurrente, como se especifica en RFC5545. Ten en cuenta que no se permiten las líneas DTSTART y DTEND en este campo. Las horas de inicio y finalización del evento se especifican en los campos `start` y `end`. Este campo se omite para eventos individuales o instancias de eventos recurrentes.	admite escritura
`recurringEventId`	`string`	Para una instancia de un evento recurrente, este es el `id` del evento recurrente al que pertenece esta instancia. Inmutable.
`reminders`	`object`	Información sobre los recordatorios del evento para el usuario autenticado. Ten en cuenta que cambiar los recordatorios no cambia la propiedad `updated` del evento envolvente.
`reminders.overrides[]`	`list`	Si el evento no usa los recordatorios predeterminados, se enumeran los recordatorios específicos del evento o, si no se establecen, se indica que no hay recordatorios establecidos para este evento. La cantidad máxima de recordatorios de anulación es 5.	admite escritura
`reminders.overrides[].method`	`string`	Es el método que usa este recordatorio. Los valores posibles son los siguientes: "`email`": Los recordatorios se envían por correo electrónico. "`popup`": Los recordatorios se envían a través de una ventana emergente de la IU. Obligatorio cuando se agrega un recordatorio.	admite escritura
`reminders.overrides[].minutes`	`integer`	Es la cantidad de minutos antes del inicio del evento en los que se debe activar el recordatorio. Los valores válidos están entre 0 y 40320 (4 semanas en minutos). Obligatorio cuando se agrega un recordatorio.	admite escritura
`reminders.useDefault`	`boolean`	Indica si los recordatorios predeterminados del calendario se aplican al evento.	admite escritura
`sequence`	`integer`	Es el número de secuencia según iCalendar.	admite escritura
`source`	`object`	Es la fuente desde la que se creó el evento. Por ejemplo, una página web, un mensaje de correo electrónico o cualquier documento que se pueda identificar con una URL con el esquema HTTP o HTTPS. Solo el creador del evento puede verlos o modificarlos.
`source.title`	`string`	Es el título de la fuente, por ejemplo, el título de una página web o el asunto de un correo electrónico.	admite escritura
`source.url`	`string`	Es la URL de la fuente que apunta a un recurso. El esquema de URL debe ser HTTP o HTTPS.	admite escritura
`start`	`nested object`	Es la hora de inicio (inclusive) del evento. En el caso de un evento recurrente, esta es la hora de inicio de la primera instancia.
`start.date`	`date`	Es la fecha, en formato "aaaa-mm-dd", si se trata de un evento de todo el día.	admite escritura
`start.dateTime`	`datetime`	La hora, como un valor de fecha y hora combinado (con el formato de RFC3339) Se requiere un desplazamiento de zona horaria, a menos que se especifique explícitamente una zona horaria en `timeZone`.	admite escritura
`start.timeZone`	`string`	Es la zona horaria en la que se especifica la hora. (con el formato de un nombre de la base de datos de zonas horarias de IANA, p.ej., "Europe/Zurich"). Para los eventos recurrentes, este campo es obligatorio y especifica la zona horaria en la que se expande la recurrencia. Para los eventos individuales, este campo es opcional e indica una zona horaria personalizada para el inicio y la finalización del evento.	admite escritura
`status`	`string`	Estado del evento. Opcional. Los valores posibles son los siguientes: "`confirmed`": El evento se confirmó. Este es el estado predeterminado. "`tentative`": El evento se confirmó de forma provisional. "`cancelled`": El evento se canceló (se borró). El método list muestra eventos cancelados solo en la sincronización incremental (cuando se especifican `syncToken` o `updatedMin`) o si la marca `showDeleted` se establece en `true`. El método get siempre los muestra. Un estado cancelado representa dos estados diferentes según el tipo de evento: Las excepciones canceladas de un evento recurrente no cancelado indican que esta instancia ya no se debe presentar al usuario. Los clientes deben almacenar estos eventos durante el ciclo de vida del evento recurrente superior. Solo se garantiza que las excepciones canceladas tengan valores para los campos `id`, `recurringEventId` y `originalStartTime` propagados. Es posible que los otros campos estén vacíos. Todos los demás eventos cancelados representan eventos borrados. Los clientes deben quitar sus copias sincronizadas de forma local. Estos eventos cancelados desaparecerán con el tiempo, por lo que no debes suponer que estarán disponibles de forma indefinida. Solo se garantiza que los eventos borrados tengan propagado el campo `id`. En el calendario del organizador, los eventos cancelados siguen exponiendo los detalles del evento (resumen, ubicación, etc.) para que se puedan restablecer (no borrar). De manera similar, seguirán proporcionando detalles los eventos a los que se haya invitado al usuario y que este haya quitado manualmente. Sin embargo, las solicitudes de sincronización incremental con `showDeleted` establecido como falso no mostrarán estos detalles. Si un evento cambia de organizador (por ejemplo, a través de la operación mover) y el organizador original no está en la lista de asistentes, dejará un evento cancelado en el que solo se garantiza que se completará el campo `id`.	admite escritura
`summary`	`string`	Corresponde al título del evento.	admite escritura
`transparency`	`string`	Indica si el evento bloquea el tiempo en el calendario. Opcional. Los valores posibles son los siguientes: "`opaque`": Es el valor predeterminado. Sin embargo, el evento establece un horario en el calendario. Esto equivale a configurar Show me as en Busy en la IU del Calendario. "`transparent`": El evento no bloquea el tiempo en el calendario. Esto equivale a configurar Show me as en Available en la IU del Calendario.	admite escritura
`updated`	`datetime`	Es la hora de la última modificación de los datos del evento principal (como una marca de tiempo RFC3339). Actualizar los recordatorios de eventos no hará que esto cambie. Solo lectura.
`visibility`	`string`	Visibilidad del evento Opcional. Los valores posibles son: "`default`": Usa la visibilidad predeterminada para los eventos del calendario. Este es el valor predeterminado. "`public`": El evento es público y todos los lectores del calendario pueden ver sus detalles. "`private`": El evento es privado y solo los asistentes pueden ver los detalles. "`confidential`": El evento es privado. Este valor se proporciona por motivos de compatibilidad.	admite escritura
`workingLocationProperties`	`nested object`	Datos de eventos de ubicación de trabajo	admite escritura
`workingLocationProperties.customLocation`	`object`	Si está presente, especifica que el usuario está trabajando desde una ubicación personalizada.	admite escritura
`workingLocationProperties.customLocation.label`	`string`	Una etiqueta adicional opcional para obtener información adicional.	admite escritura
`workingLocationProperties.homeOffice`	`any value`	Si está presente, especifica que el usuario está trabajando desde casa.	admite escritura
`workingLocationProperties.officeLocation`	`object`	Si está presente, especifica que el usuario está trabajando desde una oficina.	admite escritura
`workingLocationProperties.officeLocation.buildingId`	`string`	Un identificador de edificio opcional. Debe hacer referencia a un ID de edificio en la base de datos de recursos de la organización.	admite escritura
`workingLocationProperties.officeLocation.deskId`	`string`	Es un identificador de escritorio opcional.	admite escritura
`workingLocationProperties.officeLocation.floorId`	`string`	Es un identificador de piso opcional.	admite escritura
`workingLocationProperties.officeLocation.floorSectionId`	`string`	Un identificador opcional de la sección del piso.	admite escritura
`workingLocationProperties.officeLocation.label`	`string`	Es el nombre de la oficina que se muestra en los clientes del Calendario web y para dispositivos móviles. Te recomendamos que hagas referencia a un nombre de edificio en la base de datos de recursos de la organización.	admite escritura
`workingLocationProperties.type`	`string`	Es el tipo de ubicación de trabajo. Los valores posibles son los siguientes: "`homeOffice`": El usuario está trabajando en casa. "`officeLocation`": El usuario está trabajando desde una oficina. "`customLocation`": El usuario está trabajando desde una ubicación personalizada. Los detalles se especifican en un subcampo del nombre especificado, pero es posible que este campo no esté presente si está vacío. Se ignoran los demás campos. Es obligatorio cuando se agregan propiedades de ubicación de trabajo.	admite escritura

Métodos

borrar: Borra un evento.
get: Devuelve un evento según su ID de Calendario de Google. Para recuperar un evento con su ID de iCalendar, llama al método events.list con el parámetro iCalUID.
import: Importa un evento. Esta operación se usa para agregar una copia privada de un evento existente a un calendario. Solo se pueden importar eventos con una eventType de default.
Comportamiento obsoleto: Si se importa un evento que no es default, su tipo cambiará a default y se descartarán las propiedades específicas del tipo de evento que pueda tener.
insertar: Crea un evento.
instances: Devuelve instancias del evento recurrente especificado.
list: Devuelve los eventos del calendario especificado.
move: Mueve un evento a otro calendario, es decir, cambia el organizador de un evento. Ten en cuenta que solo se pueden mover los eventos default; no se pueden mover los eventos birthday, focusTime, fromGmail, outOfOffice y workingLocation.
patch: Actualiza un evento. Este método es compatible con la semántica de parches. Ten en cuenta que cada solicitud de parche consume tres unidades de cuota. Te recomendamos que uses 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 no se modificarán. Si se especifican, los campos de array reemplazan los arrays existentes, lo que descarta cualquier elemento de array anterior.
quickAdd: Crea un evento basado en una cadena de texto simple.
actualización: Actualiza un evento. Este método no admite la semántica de parches y siempre actualiza todo el recurso de evento. Para realizar una actualización parcial, realiza un get seguido de un update con etags para garantizar la atomicidad.
watch: Presta atención a los cambios en los recursos de eventos.