Events: patch

Bir etkinliği günceller. Bu yöntem yama semantiğini destekler. Her yama isteğinin üç kota birimi tükettiğini unutmayın; get ve ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri mevcut değerlerin yerine geçer. İstekte belirtmediğiniz alanlar değişmeden kalır. Dizi alanları belirtilirse, mevcut dizilerin üzerine yazılır. Bu işlem, önceki dizi öğelerini siler. 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. Oturum açmış olan kullanıcının birincil takvimine erişmek istiyorsanız "primary" anahtar kelimesini kullanın.
eventId string Etkinlik tanımlayıcı.
İsteğe bağlı sorgu parametreleri
alwaysIncludeEmail boolean Kullanımdan kaldırıldı ve yoksayıldı. Gerçek bir e-posta adresi olmasa bile (yani oluşturulmuş, çalışmayan bir değer sağlanacak) etkinliği düzenleyen, oluşturan 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ı. Sürüm 0, konferans veri desteğinin olmadığını varsayar ve etkinlik gövdesindeki konferans verilerini yoksayar. Sürüm 1, ConferenceData'nın kopyalanması ve ConferenceData'nın createRequest alanını kullanarak yeni konferanslar oluşturma desteği sağlar. Varsayılan değer 0'dır. Kabul edilebilir değerler 0 - 1 (bu değerler dahil) arasındadır.
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ı. Bunun yerine lütfen sendUpdates'i kullanın.

Etkinlik güncellemesiyle ilgili bildirim gönderilip gönderilmeyeceği (örneğin, açıklama değişiklikleri vb.). Değeri false olarak ayarlasanız bile bazı e-postaların yine de gönderilebileceğini unutmayın. Varsayılan değer: false.
sendUpdates string Etkinlik güncellemeleriyle ilgili bildirim alması gereken davetliler (örneğin, başlık değişiklikleri vb.).

Kabul edilebilir değerler şunlardır:
  • "all": Bildirimler tüm davetlilere gönderilir.
  • "externalOnly": Bildirimler yalnızca Google Takvim kullanıcısı olmayan davetlilere gönderilir.
  • "none": Bildirim gönderilmez. Takvim taşıma görevleri için bunun yerine Events.import yöntemini kullanabilirsiniz.
supportsAttachments boolean API istemcisi gerçekleştirme işleminin etkinlik eklerini destekleyip desteklemediği. İsteğe bağlı. Varsayılan, Yanlış değeridir.

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir:

Kapsam
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına göz atın.

İstek içeriği

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

Yanıt

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

Deneyin.

Aşağıdaki API Gezgini'ni kullanarak canlı verilerde bu yöntemi çağırın ve yanıtı görün.