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. 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. 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 IDs de calendario, llama al método calendarList.list. Si deseas acceder al calendario principal del usuario que accedió actualmente, usa la palabra clave "primary".
eventId string Es el identificador del evento.
Parámetros de consulta opcionales
alwaysIncludeEmail boolean Dejó de estar disponible y se ignora. 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 Es el número de versión de los datos de la conferencia que admite el cliente de la API. La versión 0 supone que no se admiten datos de conferencias y los ignora en el cuerpo del evento. La versión 1 habilita la compatibilidad con la copia de ConferenceData y la creación de conferencias nuevas con el campo createRequest de conferenceData. El valor predeterminado es 0. Los valores aceptables son 0 a 1, ambos inclusive.
maxAttendees integer Es la cantidad máxima de asistentes que se deben incluir en la respuesta. Si hay más de la cantidad especificada de asistentes, solo se muestra el participante. Opcional.
sendNotifications boolean Obsoleta. En su lugar, usa sendUpdates.

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

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

Autorización

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

Alcance
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.owned

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

Cuerpo de la solicitud

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

Respuesta

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

Pruébalo

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