Events: 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. Es preferible usar get seguido de update. Los valores de campo que especifiques reemplazarán los valores existentes. Los campos que no especifiques en la solicitud no se modificarán. Los campos de array, si se especifican, reemplazan los arrays existentes. Esto descarta cualquier elemento de array anterior. Pruébalo ahora.

Solicitud

Solicitud HTTP

PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de ruta de acceso
calendarId string Es el identificador del calendario. Para recuperar los ID de calendario, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario actual, usa la palabra clave “primary”.
eventId string Es el identificador del evento.
Parámetros de consulta opcionales
alwaysIncludeEmail boolean Se ignoró y dejó de estar disponible. Siempre se mostrará un valor en el campo email para el organizador, el creador y los asistentes, incluso si no hay una dirección de correo electrónico real disponible (es decir, se proporcionará un valor generado que no funcione).
conferenceDataVersion integer Número de versión de los datos de conferencia que admite el cliente de la API. La versión 0 no supone que se admiten datos de conferencia y, además, ignora los datos de conferencia en el cuerpo del evento. La versión 1 habilita la compatibilidad con la copia de ConferenceData y también para la creación de nuevas conferencias mediante el campo createRequest deferenceData. El valor predeterminado es 0. Los valores aceptables son 0 a 1, ambos inclusive.
maxAttendees integer Indica la cantidad máxima de asistentes que se deben incluir en la respuesta. Si la cantidad de asistentes supera la cantidad especificada, solo se devolverá al participante. Opcional.
sendNotifications boolean Ya no está disponible. En su lugar, usa sendUpdates.

Indica si se debe enviar notificaciones sobre la actualización del evento (por ejemplo, cambios en la descripción, etcétera). Ten en cuenta que es posible que algunos correos electrónicos se envíen incluso si configuras el valor como false. El valor predeterminado es false.
sendUpdates string Invitados que deben recibir notificaciones sobre la actualización del evento (por ejemplo, cambios de título, etcétera)

Los valores aceptables son los siguientes:
  • "all": Se envían notificaciones a todos los invitados.
  • externalOnly”: Las notificaciones se envían solo a los invitados que no sean usuarios de Calendario de Google.
  • "none": No se envían notificaciones. Para las tareas de migración de calendario, considera usar el método Events.import en su lugar.
supportsAttachments boolean Indica si el cliente de API que realiza la operación admite adjuntos de eventos. Opcional. El valor predeterminado es False.

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes alcances:

Permiso
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

Para obtener más información, consulta la página de autenticación y autorización.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona las partes relevantes de un recurso de eventos, de acuerdo con las reglas de semántica de parches.

Respuesta

Si se aplica de forma correcta, este método muestra un recurso de eventos en el cuerpo de la respuesta.

Pruébala

Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos en tiempo real y ver la respuesta.