Events: patch
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir etkinliği günceller. Bu yöntem, yama semantiklerini destekler. Her bir yama isteği üç kota birimi tüketir. get ve ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri, mevcut değerlerin yerini alır. İstekte belirtmediğiniz alanlar aynı kalır. Belirtilen dizi alanları, mevcut dizilerin üzerine yazar. Bu işlem, önceki tüm dizi öğelerini atar.
Hemen deneyin.
İstek
HTTP isteği
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
Parametreler
| Parametre adı |
Değer |
Açıklama |
| Yol parametreleri |
calendarId |
string |
Takvim tanımlayıcısı. Takvim kimliklerini almak için calendarList.list yöntemini çağırın. Şu anda oturum açmış kullanıcının birincil takvimine erişmek istiyorsanız "primary" anahtar kelimesini kullanın.
|
eventId |
string |
Etkinlik tanımlayıcısı.
|
| İsteğe bağlı sorgu parametreleri |
alwaysIncludeEmail |
boolean |
Desteği sonlandırıldı ve yoksayıldı. Gerçek bir e-posta adresi olmasa bile düzenleyen, içerik üretici ve katılımcılar için email alanında her zaman bir değer döndürülür (yani oluşturulan, çalışmayan bir değer sağlanır).
|
conferenceDataVersion |
integer |
API istemcisi tarafından desteklenen konferans verilerinin sürüm numarası. 0 sürümü, konferans verisi desteğinin olmadığını varsayar ve etkinliğin gövdesinde bulunan konferans verilerini yoksayar. 1. sürüm, ConferenceData öğesinin kopyalanmasına ve conferenceData öğesinin createRequest alanını kullanarak yeni konferanslar oluşturulmasına olanak tanır. Varsayılan değer 0'dır.
Kabul edilen değerler 0 ile 1 arasıdır (bu değerler dahil).
|
maxAttendees |
integer |
Yanıta dahil edilecek maksimum katılımcı sayısı. Belirtilen sayıdan fazla katılımcı varsa yalnızca katılımcı döndürülür. İsteğe bağlı.
|
sendNotifications |
boolean |
Kullanımdan kaldırıldı. Lütfen bunun yerine sendUpdates işlevini kullanın.
Etkinlik güncellemesiyle ilgili bildirimlerin (ör. açıklama değişiklikleri vb.) gönderilip gönderilmeyeceği. Değeri false olarak ayarlasanız bile bazı e-postaların yine de gönderilebileceğini unutmayın. Varsayılan değer false'tir.
|
sendUpdates |
string |
Etkinlik güncellemesiyle ilgili bildirim alması gereken konuklar (ör. başlık değişiklikleri vb.).
Kabul edilen değerler şunlardır:
- "
all": Bildirimler tüm davetlilere gönderilir.
- "
externalOnly": Bildirimler yalnızca Google Takvim kullanmayan davetlilere gönderilir.
- "
none": Bildirim gönderilmez. Takvim taşıma görevleri için bunun yerine Events.import yöntemini kullanabilirsiniz.
|
supportsAttachments |
boolean |
İşlemi gerçekleştiren API istemcisinin etkinlik ekleriyle ilgili desteği olup olmadığı. İsteğe bağlı. Varsayılan değer False'tır.
|
Yetkilendirme
Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir:
| Kapsam |
|---|
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 |
Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına bakın.
İstek içeriği
İstek gövdesinde, Etkinlikler kaynağının ilgili bölümlerini, yama semantiği kurallarına göre sağlayın.
Yanıt
Başarılı olursa bu yöntem, yanıt gövdesinde bir Events kaynağı döndürür.
Deneyin!
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# Events: patch\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates an event. This method supports patch semantics. Note that each patch request consumes three quota units; prefer using a `get` followed by an `update`. The field values you specify replace the existing values. Fields that you don't specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays; this discards any previous array elements.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|-------------------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier. To retrieve calendar IDs call the [calendarList.list](/workspace/calendar/api/v3/reference/calendarList/list) method. If you want to access the primary calendar of the currently logged in user, use the \"`primary`\" keyword. |\n| `eventId` | `string` | Event identifier. |\n| **Optional query parameters** |||\n| `alwaysIncludeEmail` | `boolean` | Deprecated and ignored. A value will always be returned in the `email` field for the organizer, creator and attendees, even if no real email address is available (i.e. a generated, non-working value will be provided). |\n| `conferenceDataVersion` | `integer` | Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in the event's body. Version 1 enables support for copying of ConferenceData as well as for creating new conferences using the createRequest field of conferenceData. The default is 0. Acceptable values are `0` to `1`, inclusive. |\n| `maxAttendees` | `integer` | The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional. |\n| `sendNotifications` | `boolean` | Deprecated. Please use [sendUpdates](/workspace/calendar/api/v3/reference/events/update#sendUpdates) instead. Whether to send notifications about the event update (for example, description changes, etc.). Note that some emails might still be sent even if you set the value to `false`. The default is `false`. |\n| `sendUpdates` | `string` | Guests who should receive notifications about the event update (for example, title changes, etc.). \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`all`\": Notifications are sent to all guests. - \"`externalOnly`\": Notifications are sent to non-Google Calendar guests only. - \"`none`\": No notifications are sent. For calendar migration tasks, consider using the [Events.import](/workspace/calendar/api/v3/reference/events/import) method instead. |\n| `supportsAttachments` | `boolean` | Whether API client performing operation supports event attachments. Optional. The default is False. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|---------------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.events` |\n| `https://www.googleapis.com/auth/calendar.app.created` |\n| `https://www.googleapis.com/auth/calendar.events.owned` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nIn the request body, supply the relevant portions of an [Events resource](/workspace/calendar/api/v3/reference/events#resource), according to the rules of patch semantics.\n\nResponse\n--------\n\nIf successful, this method returns an [Events resource](/workspace/calendar/api/v3/reference/events#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
