Events: patch

Обновляет событие. Этот метод поддерживает семантику патчей. Обратите внимание, что каждый запрос на патч потребляет три единицы квоты; предпочтительнее использовать запрос get с последующим update . Указанные вами значения полей заменяют существующие значения. Поля, которые вы не указываете в запросе, остаются неизменными. Если указаны поля массива, они перезаписывают существующие массивы; это отбрасывает все предыдущие элементы массива. Попробуйте прямо сейчас .

Запрос

HTTP-запрос

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

Параметры

Имя параметра Ценить Описание
Параметры пути
calendarId string Идентификатор календаря. Для получения идентификаторов календарей вызовите метод calendarList.list . Если вы хотите получить доступ к основному календарю текущего пользователя, используйте ключевое слово " primary ".
eventId string Идентификатор события.
Дополнительные параметры запроса
alwaysIncludeEmail boolean Устарело и игнорируется. В поле email всегда будет возвращаться значение для организатора, создателя и участников, даже если реальный адрес электронной почты недоступен (т.е. будет предоставлено сгенерированное, неработоспособное значение).
conferenceDataVersion integer Номер версии данных конференции, поддерживаемых API-клиентом. Версия 0 предполагает отсутствие поддержки данных конференции и игнорирует данные конференции в теле события. Версия 1 включает поддержку копирования ConferenceData, а также создания новых конференций с помощью поля createRequest объекта conferenceData. Значение по умолчанию — 0. Допустимые значения — от 0 до 1 включительно.
eventLabelVersion integer Номер версии функции меток событий, поддерживаемой API-клиентом. Версия 0 предполагает отсутствие поддержки меток событий и обрабатывает поле colorId для управления цветом. Версия 1 включает поддержку меток событий и обрабатывает eventLabelId в теле события. В этом случае поле colorId игнорируется. Значение по умолчанию — 0 Допустимые значения — от 0 до 1 включительно.
maxAttendees integer Максимальное количество участников, которое следует включить в ответ. Если участников больше указанного числа, возвращается только сам участник. Необязательный параметр.
sendNotifications boolean Устарело. Пожалуйста, используйте sendUpdates вместо этого.

Отправлять ли уведомления об обновлении события (например, об изменении описания и т. д.). Обратите внимание, что некоторые электронные письма могут быть отправлены, даже если вы установите значение false . Значение по умолчанию — false .
sendUpdates string Гости, которым следует отправлять уведомления об обновлении информации о мероприятии (например, об изменении названия и т. д.).

Допустимые значения:
  • " all ": Уведомления отправляются всем гостям.
  • " externalOnly ": Уведомления отправляются только гостям, не зарегистрированным в Google Календаре.
  • " none ": Уведомления не отправляются. Для задач миграции календаря рекомендуется использовать метод Events.import .
supportsAttachments boolean Указывает, поддерживает ли API-клиент, выполняющий операцию, прикрепление событий. Необязательный параметр. По умолчанию — False.

Авторизация

Для выполнения этого запроса требуется авторизация как минимум в одной из следующих областей действия:

Объем
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

Для получения более подробной информации см. страницу аутентификации и авторизации .

Текст запроса

В теле запроса укажите соответствующие части ресурса Events в соответствии с правилами семантики патчей.

Ответ

В случае успеха этот метод возвращает ресурс Events в теле ответа.

Попробуйте!

Воспользуйтесь приведенным ниже инструментом API Explorer, чтобы вызвать этот метод на реальных данных и увидеть ответ.