Events: update

Bir etkinliği günceller. Bu yöntem, yama semantiğini desteklemez ve her zaman tüm etkinlik kaynağını günceller. Kısmi güncelleme yapmak için atomikliği sağlamak üzere etag'leri kullanarak get ve ardından update işlemi gerçekleştirin. Hemen deneyin.

İstek

HTTP isteği

PUT 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).
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 aşağıdaki özelliklere sahip bir Events kaynağı sağlayın:

Mülk adı Değer Açıklama Notlar
Zorunlu özellikler
end nested object Etkinliğin bitiş zamanı (girilen tarihler dahil değil). Yinelenen etkinliklerde bu, ilk örneğin bitiş zamanıdır.
start nested object Etkinliğin başlangıç zamanı (girilen tarihler dahil). Yinelenen bir etkinlik için bu, ilk örneğin başlangıç zamanıdır.
İsteğe bağlı özellikler
anyoneCanAddSelf boolean Kullanıcıların etkinliğe kendi kendilerini davet edip edemeyeceği (kullanımdan kaldırıldı). İsteğe bağlı. Varsayılan değer False'tur. yazılabilir
attachments[].fileUrl string Ekin URL bağlantısı.

Google Drive dosya eklerini eklemek için Drive API'deki Files kaynağının alternateLink özelliğinde kullanılan biçimi kullanın.

Ek eklerken gereklidir.

 yazılabilir
attendees[] list Etkinliğe katılanlar. Diğer takvim kullanıcılarıyla etkinlik planlama hakkında daha fazla bilgi için Katılımcıların olduğu etkinlikler rehberine bakın. Hizmet hesaplarının, katılımcı listesini doldurmak için alan genelinde yetki devri kullanması gerekir. yazılabilir
attendees[].additionalGuests integer Ek konuk sayısı. İsteğe bağlı. Varsayılan değer 0'dır. yazılabilir
attendees[].comment string Katılımcının yanıt yorumu. İsteğe bağlı. yazılabilir
attendees[].displayName string Varsa katılımcının adı. İsteğe bağlı. yazılabilir
attendees[].email string Katılımcının e-posta adresi (varsa). Katılımcı eklerken bu alan bulunmalıdır. RFC5322'ye göre geçerli bir e-posta adresi olmalıdır.

Katılımcı eklerken gereklidir.

 yazılabilir
attendees[].optional boolean Bu katılımcının isteğe bağlı olup olmadığı. İsteğe bağlı. Varsayılan değer False'tur. yazılabilir
attendees[].resource boolean Katılımcının kaynak olup olmadığı. Yalnızca katılımcı etkinliğe ilk kez eklendiğinde ayarlanabilir. Sonraki değişiklikler yoksayılır. İsteğe bağlı. Varsayılan değer False'tur. yazılabilir
attendees[].responseStatus string Katılımcının yanıt durumu. Olası değerler:
  • "needsAction": Katılımcı, davete yanıt vermedi (yeni etkinlikler için önerilir).
  • "declined": Katılımcı daveti reddetti.
  • "tentative": Katılımcı, daveti geçici olarak kabul etti.
  • "accepted": Katılımcı daveti kabul etti.
 yazılabilir
attendeesOmitted boolean Katılımcıların etkinliğin gösteriminden çıkarılıp çıkarılmadığı Bir etkinlik alınırken bu durum, maxAttendee sorgu parametresiyle belirtilen bir kısıtlamadan kaynaklanıyor olabilir. Bir etkinlik güncellenirken bu parametre yalnızca katılımcının yanıtını güncellemek için kullanılabilir. İsteğe bağlı. Varsayılan değer False'tur. yazılabilir
colorId string Etkinliğin rengi. Bu, renk tanımının event bölümündeki bir girişi ifade eden kimliktir (bkz. renkler uç noktası). İsteğe bağlı. yazılabilir
conferenceData nested object Konferansla ilgili bilgiler (ör. Google Meet konferansının ayrıntıları). Yeni konferans ayrıntıları oluşturmak için createRequest alanını kullanın. Değişikliklerinizin kalıcı olması için tüm etkinlik değişikliği isteklerinde conferenceDataVersion istek parametresini 1 olarak ayarlamayı unutmayın. yazılabilir
description string Etkinliğin açıklaması. HTML içerebilir. İsteğe bağlı. yazılabilir
end.date date Tüm gün süren bir etkinlikse tarih "yyyy-aa-gg" biçiminde olmalıdır. yazılabilir
end.dateTime datetime Birleşik tarih-saat değeri olarak zaman (RFC3339'a göre biçimlendirilmiş). timeZone içinde saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir. yazılabilir
end.timeZone string Zamanın belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Europe/Zurich".) Yinelenen etkinlikler için bu alan zorunludur ve yinelenmenin genişletildiği saat dilimini belirtir. Tek seferlik etkinliklerde bu alan isteğe bağlıdır ve etkinliğin başlangıç/bitişi için özel bir saat dilimini gösterir. yazılabilir
extendedProperties.private object Bu takvimde görünen etkinlik kopyasına özel olan özellikler. yazılabilir
extendedProperties.shared object Etkinliğin diğer katılımcıların takvimlerindeki kopyaları arasında paylaşılan özellikler. yazılabilir
focusTimeProperties nested object Odaklanma zamanı etkinlik verileri. eventType, focusTime ise kullanılır. yazılabilir
gadget.display string Gadget'ın görüntüleme modu. Kullanımdan kaldırıldı. Olası değerler:
  • "icon": Araç, takvim görünümünde etkinliğin başlığının yanında gösterilir.
  • "chip": Etkinlik tıklandığında gadget görüntülenir.
 yazılabilir
gadget.height integer Gadget'ın piksel cinsinden yüksekliği. Yükseklik, 0'dan büyük bir tam sayı olmalıdır. İsteğe bağlı. Kullanımdan kaldırıldı. yazılabilir
gadget.preferences object Tercihler'i tıklayın. yazılabilir
gadget.title string Gadget'ın başlığı. Kullanımdan kaldırıldı. yazılabilir
gadget.type string Gadget'ın türü. Kullanımdan kaldırıldı. yazılabilir
gadget.width integer Gadget'ın piksel cinsinden genişliği. Genişlik, 0'dan büyük bir tam sayı olmalıdır. İsteğe bağlı. Kullanımdan kaldırıldı. yazılabilir
guestsCanInviteOthers boolean Düzenleyen dışındaki katılımcıların etkinliğe başkalarını davet edip edemeyeceği. İsteğe bağlı. Varsayılan değer True'dur. yazılabilir
guestsCanModify boolean Düzenleyici dışındaki katılımcıların etkinliği değiştirip değiştiremeyeceği İsteğe bağlı. Varsayılan değer False'tur. yazılabilir
guestsCanSeeOtherGuests boolean Düzenleyici dışındaki katılımcıların, etkinliğe katılan diğer kullanıcıları görüp göremeyeceğini belirler. İsteğe bağlı. Varsayılan değer True'dur. yazılabilir
location string Etkinliğin coğrafi konumu (serbest biçimli metin olarak). İsteğe bağlı. yazılabilir
originalStartTime.date date Tüm gün süren bir etkinlikse tarih "yyyy-aa-gg" biçiminde olmalıdır. yazılabilir
originalStartTime.dateTime datetime Birleşik tarih-saat değeri olarak zaman (RFC3339'a göre biçimlendirilmiş). timeZone içinde saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir. yazılabilir
originalStartTime.timeZone string Zamanın belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Europe/Zurich".) Yinelenen etkinlikler için bu alan zorunludur ve yinelenmenin genişletildiği saat dilimini belirtir. Tek seferlik etkinliklerde bu alan isteğe bağlıdır ve etkinliğin başlangıç/bitişi için özel bir saat dilimini gösterir. yazılabilir
outOfOfficeProperties nested object Ofis dışında etkinlik verileri. eventType, outOfOffice ise kullanılır. yazılabilir
recurrence[] list RFC5545'te belirtildiği gibi, yinelenen bir etkinlik için RRULE, EXRULE, RDATE ve EXDATE satırlarının listesi. Bu alanda DTSTART ve DTEND satırlarına izin verilmediğini unutmayın. Etkinliğin başlangıç ve bitiş zamanları start ve end alanlarında belirtilir. Bu alan, tek seferlik etkinlikler veya yinelenen etkinliklerin örnekleri için atlanır. yazılabilir
reminders.overrides[] list Etkinlikte varsayılan hatırlatıcılar kullanılmıyorsa etkinliğe özel hatırlatıcılar listelenir veya ayarlanmamışsa bu etkinlik için hatırlatıcı ayarlanmadığı belirtilir. Maksimum geçersiz kılma hatırlatıcısı sayısı 5'tir. yazılabilir
reminders.overrides[].method string Bu hatırlatıcı tarafından kullanılan yöntem. Olası değerler:
  • "email": Hatırlatmalar e-postayla gönderilir.
  • "popup": Hatırlatmalar, kullanıcı arayüzünde pop-up olarak gönderilir.

Hatırlatıcı eklerken gereklidir.

 yazılabilir
reminders.overrides[].minutes integer Hatırlatıcının tetiklenmesi gereken, etkinliğin başlangıcından önceki dakika sayısı. Geçerli değerler 0 ile 40320 (4 hafta dakika cinsinden) arasındadır.

Hatırlatıcı eklerken gereklidir.

 yazılabilir
reminders.useDefault boolean Takvimin varsayılan hatırlatıcılarının etkinlik için geçerli olup olmadığı. yazılabilir
sequence integer iCalendar'a göre sıra numarası. yazılabilir
source.title string Kaynağın başlığı (ör. web sayfasının başlığı veya e-posta konusu). yazılabilir
source.url string Bir kaynağı işaret eden kaynağın URL'si. URL şeması HTTP veya HTTPS olmalıdır. yazılabilir
start.date date Tüm gün süren bir etkinlikse tarih "yyyy-aa-gg" biçiminde olmalıdır. yazılabilir
start.dateTime datetime Birleşik tarih-saat değeri olarak zaman (RFC3339'a göre biçimlendirilmiş). timeZone içinde saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir. yazılabilir
start.timeZone string Zamanın belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Europe/Zurich".) Yinelenen etkinlikler için bu alan zorunludur ve yinelenmenin genişletildiği saat dilimini belirtir. Tek seferlik etkinliklerde bu alan isteğe bağlıdır ve etkinliğin başlangıç/bitişi için özel bir saat dilimini gösterir. yazılabilir
status string Etkinliğin durumu. İsteğe bağlı. Olası değerler:
  • "confirmed": Etkinlik onaylanmıştır. Bu, varsayılan durumdur.
  • "tentative": Etkinlik geçici olarak onaylanmıştır.
  • "cancelled": Etkinlik iptal edildi (silindi). List yöntemi, iptal edilen etkinlikleri yalnızca artımlı senkronizasyonda (syncToken veya updatedMin belirtildiğinde) ya da showDeleted işareti true olarak ayarlanmışsa döndürür. get yöntemi her zaman bunları döndürür.

    İptal edildi durumu, etkinlik türüne bağlı olarak iki farklı durumu ifade eder:

    1. İptal edilmemiş bir düzenli etkinliğin iptal edilen istisnaları, bu örneğin artık kullanıcıya sunulmaması gerektiğini gösterir. İstemciler, bu etkinlikleri üst düzenli etkinliğin kullanım ömrü boyunca saklamalıdır.

      İptal edilen istisnaların yalnızca id, recurringEventId ve originalStartTime alanları için değerler içerdiği garanti edilir. Diğer alanlar boş olabilir.

    2. Diğer tüm iptal edilen etkinlikler, silinen etkinlikleri gösterir. Müşteriler, yerel olarak senkronize edilmiş kopyalarını kaldırmalıdır. Bu tür iptal edilen etkinlikler zamanla kaybolur. Bu nedenle, süresiz olarak kullanılabilir olmalarına güvenmeyin.

      Silinen etkinliklerde yalnızca id alanının doldurulacağı garanti edilir.

    Düzenleyenin takviminde, iptal edilen etkinlikler, geri yüklenebilmeleri (silinmemiş) için etkinlik ayrıntılarını (özet, konum vb.) göstermeye devam eder. Benzer şekilde, kullanıcının davet edildiği ve manuel olarak kaldırdığı etkinlikler de ayrıntı sağlamaya devam eder. Ancak showDeleted değeri false olarak ayarlanmış artımlı senkronizasyon istekleri bu ayrıntıları döndürmez.

    Bir etkinliğin düzenleyeni değişirse (örneğin, taşıma işlemiyle) ve ilk düzenleyen katılımcı listesinde yer almıyorsa yalnızca id alanının doldurulacağı iptal edilmiş bir etkinlik oluşturulur.

yazılabilir
summary string Etkinliğin adı. yazılabilir
transparency string Etkinliğin takvimde zamanı engelleyip engellemediği. İsteğe bağlı. Olası değerler:
  • "opaque": Varsayılan değer. Etkinlik, takvimde zamanı engeller. Bu, Takvim kullanıcı arayüzünde Beni şöyle göster ayarını Meşgul olarak ayarlamaya eşdeğerdir.
  • "transparent": Etkinlik, takvimde zamanı engellemez. Bu, Takvim kullanıcı arayüzünde Beni şöyle göster ayarını Kullanılabilir olarak ayarlamaya eşdeğerdir.
 yazılabilir
visibility string Etkinliğin görünürlüğü. İsteğe bağlı. Olası değerler:
  • "default": Takvimdeki etkinlikler için varsayılan görünürlüğü kullanır. Bu, varsayılan değerdir.
  • "public": Etkinlik herkese açıktır ve etkinlik ayrıntıları takvimin tüm okuyucularına görünür.
  • "private": Etkinlik özeldir ve etkinlik ayrıntılarını yalnızca etkinlik katılımcıları görüntüleyebilir.
  • "confidential": Etkinlik gizlidir. Bu değer, uyumluluk nedeniyle sağlanır.
 yazılabilir
workingLocationProperties nested object Çalışma yeri etkinlik verileri. yazılabilir
workingLocationProperties.customLocation object Varsa kullanıcının özel bir konumdan çalıştığını belirtir. yazılabilir
workingLocationProperties.customLocation.label string Ek bilgiler için isteğe bağlı bir ek etiket. yazılabilir
workingLocationProperties.homeOffice any value Varsa kullanıcının evden çalıştığını belirtir. yazılabilir
workingLocationProperties.officeLocation object Mevcutsa kullanıcının ofisten çalıştığını belirtir. yazılabilir
workingLocationProperties.officeLocation.buildingId string İsteğe bağlı bina tanımlayıcısı. Bu, kuruluşun Kaynaklar veritabanındaki bir bina kimliğine referans vermelidir. yazılabilir
workingLocationProperties.officeLocation.deskId string İsteğe bağlı masa tanımlayıcısı. yazılabilir
workingLocationProperties.officeLocation.floorId string İsteğe bağlı bir kat tanımlayıcısı. yazılabilir
workingLocationProperties.officeLocation.floorSectionId string İsteğe bağlı bir kat bölümü tanımlayıcısı. yazılabilir
workingLocationProperties.officeLocation.label string Takvim'in web ve mobil istemcilerinde gösterilen ofis adı. Kuruluşun Kaynaklar veritabanında bir bina adına referans vermenizi öneririz. yazılabilir
workingLocationProperties.type string Çalışma yerinin türü. Olası değerler:
  • "homeOffice": Kullanıcı evden çalışıyor.
  • "officeLocation": Kullanıcı ofisten çalışıyor.
  • "customLocation": Kullanıcı özel bir konumdan çalışıyor.
Ayrıntılar, belirtilen adın bir alt alanında belirtilir ancak boşsa bu alan eksik olabilir. Diğer tüm alanlar yoksayılır.

Çalışma yeri özellikleri eklerken gereklidir.

 yazılabilir

Yanıt

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

Deneyin.

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