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 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.
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 | ||
calendarId |
string |
Es el identificador del calendario. Para recuperar los IDs de calendario, llama al método calendarList.list. Si quieres 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 devolverá 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 la conferencia que admite el cliente de la API. La versión 0 no admite 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.
|
eventLabelVersion |
integer |
Es el número de versión de la función de etiquetas de eventos que admite el cliente de API. La versión 0 no admite etiquetas de eventos y procesa el campo colorId para la administración del color. La versión 1 habilita la compatibilidad con etiquetas de eventos y procesa el objeto eventLabelId en el cuerpo del evento. En este caso, se ignora el campo colorId. El valor predeterminado es 0.
Los valores aceptables son de 0 a 1, inclusive.
|
maxAttendees |
integer |
Es la cantidad máxima de asistentes que se incluirán en la respuesta. Si hay más asistentes de los que se especificaron, solo se devolverá el participante. Opcional. |
sendNotifications |
boolean |
Obsoleta. En su lugar, usa sendUpdates. Indica 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 sigan enviando algunos correos electrónicos incluso si estableces el valor en false. El valor predeterminado es false.
|
sendUpdates |
string |
Son los 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:
|
supportsAttachments |
boolean |
Indica si el cliente de 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 de autenticación y autorización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona las partes pertinentes de un recurso Events, según las reglas de la semántica de parches.
Respuesta
Si la respuesta es correcta, este método devuelve un recurso Events 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.