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: prefieres 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 no se modificarán. Los campos de array, si se especifican, reemplazan los arrays existentes. esto descarta cualquier elemento anterior del array. 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 de calendario. Para recuperar los ID del calendario, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario que accedió, usa "primary" palabra clave.
eventId string Es el identificador de 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 funciona).
conferenceDataVersion integer Número de versión de los datos de conferencias admitidos por el cliente de la API. La versión 0 supone que no es compatible con los datos de la conferencia e ignora los datos de la conferencia en el cuerpo del evento. La versión 1 admite la copia de ConferenceData y la creación de nuevas conferencias con el campo createRequest de conferenciaData. 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 el número de asistentes supera la cantidad especificada, solo se devuelve el participante. Opcional.
sendNotifications boolean Obsoleta. En su lugar, usa sendUpdates.

Indica si quieres 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 sigan enviando, 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 de título, etcétera).

Los valores aceptables son los siguientes:
  • "all": Se envían notificaciones a todos los invitados.
  • "externalOnly": Las notificaciones solo se envían a los invitados que no usan Calendario de Google.
  • "none": No se envían notificaciones. Para las tareas de migración del calendario, considera usar el método Events.import en su lugar.
supportsAttachments boolean Indica si el cliente de API que realiza una 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:

Alcance
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 del parche.

Respuesta

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

Pruébalo

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