Events: patch

Bir etkinliği günceller. Bu yöntem, yama semantiğini destekler. Her yama isteğinin üç kota birimi kullandığını unutmayın. get ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri, mevcut değerlerin yerini alır. İstek içinde belirtmediğiniz alanlar değişmeden kalır. Belirtilmişse dizi alanları mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir. 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 Kullanımdan kaldırıldı ve yoksayıldı. Gerçek bir e-posta adresi olmasa bile (ör. oluşturulmuş, çalışmayan bir değer sağlanır) düzenleyen, oluşturucu ve katılımcılar için email alanında her zaman bir değer döndürülür.
conferenceDataVersion integer API istemcisi tarafından desteklenen konferans verilerinin sürüm numarası. 0 sürümünde konferans verileri desteği olmadığı varsayılır ve etkinlik gövdesindeki konferans verileri yoksayılır. 1. sürüm, ConferenceData'nın kopyalanmasının yanı sıra conferenceData'nın createRequest alanı kullanılarak yeni konferanslar oluşturulmasını destekler. Varsayılan değer 0'dır. Kabul edilen değerler 0 ile 1 arasındadır (bu değerler dahil).
eventLabelVersion integer API istemcisi tarafından desteklenen etkinlik etiketi özelliğinin sürüm numarası. 0 sürümünde etkinlik etiketi desteği olmadığı varsayılır ve renk yönetimi için colorId alanı işlenir. 1 sürümü, etkinlik etiketleri için desteği etkinleştirir ve etkinlik gövdesindeki eventLabelId öğesini işler. Bu durumda, colorId alanı yoksayılır. Varsayılan değer 0'dir. Kabul edilen değerler 0 ile 1 arasındadır (bu değerler dahil).
maxAttendees integer Yanıtın dahil edilecek maksimum katılımcı sayısı. Belirtilen sayıda katılımcıdan fazla 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 kullanın.

Etkinlik güncellemesiyle (ör. açıklama değişiklikleri vb.) ilgili bildirimlerin gönderilip gönderilmeyeceği. Değeri false olarak ayarlasanız bile bazı e-postaların gönderilmeye devam edebileceğini unutmayın. Varsayılan değer false'dir.
sendUpdates string Etkinlik güncellemesiyle (ör. başlık değişiklikleri vb.) ilgili bildirimleri alması gereken davetliler.

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 eklerini destekleyip desteklemediği. İsteğe bağlı. Varsayılan değer False'tur.

Yetkilendirme

Bu istek için aşağıdaki kapsamların en az biriyle yetkilendirme yapılması 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 metni

İstek gövdesinde, yama semantiği kurallarına göre Events kaynağının ilgili bölümlerini sağlayın.

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir Events kaynağı döndürür.

Deneyin.

Bu yöntemi canlı verilerde çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.