Events: insert

Etkinlik oluşturur. Şimdi deneyin.

İstek

HTTP isteği

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

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.
İsteğe bağlı sorgu parametreleri
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.

Yeni etkinliğin oluşturulmasıyla 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 Yeni etkinliğin oluşturulmasıyla ilgili bildirim gönderilip gönderilmeyeceği. Bazı e-postaların gönderilmeye devam edebileceğini unutmayın. Varsayılan değer: false.

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.
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
birthdayProperties nested object Doğum günü veya özel etkinlik verileri. eventType, "birthday" ise kullanılır. Değişmez. yazılabilir
birthdayProperties.type string Doğum günü veya özel etkinlik türü. Olası değerler:
  • "anniversary": Doğum günü dışındaki bir yıl dönümü. Her zaman contact vardır.
  • "birthday": Doğum günü etkinliği. Bu, varsayılan değerdir.
  • "custom" - Etiketi customTypeName alanında daha ayrıntılı olarak belirtilen özel bir tarih. Her zaman contact vardır.
  • "other" - Diğer kategorilere uymayan ve özel etiketi olmayan özel bir tarih. Her zaman contact vardır.
  • "self": Takvim sahibinin kendi doğum günü. contact olamaz.
Calendar API yalnızca "birthday" türünde etkinlik oluşturmayı destekler. Etkinlik oluşturulduktan sonra türü değiştirilemez.		 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
eventType string Etkinliğin türü. Bu ayar, etkinlik oluşturulduktan sonra değiştirilemez. Olası değerler:
  • "birthday": Yıllık olarak tekrarlanan, tüm gün süren özel bir etkinlik.
  • "default": Normal bir etkinlik veya daha fazla belirtilmemiş.
  • "focusTime": Odaklanma zamanı etkinliği.
  • "fromGmail": Gmail'den alınan bir etkinlik. Bu tür etkinlikler oluşturulamaz.
  • "outOfOffice": Ofis dışında etkinliği.
  • "workingLocation": Çalışma yeri etkinliği.
 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
id string Etkinliğin opak tanımlayıcısı. Yeni tek seferlik veya yinelenen etkinlikler oluştururken bunların kimliklerini belirtebilirsiniz. Sağlanan kimlikler aşağıdaki kurallara uymalıdır:
  • Kimlikte izin verilen karakterler, base32hex kodlamasında kullanılan karakterlerdir. Yani küçük harfler (a-v) ve rakamlar (0-9). RFC2938'deki 3.1.2 bölümüne bakın.
  • Kimliğin uzunluğu 5 ile 1.024 karakter arasında olmalıdır.
  • Kimlik, her takvim için benzersiz olmalıdır.
Sistem, dünya genelinde dağıtılmış bir yapıya sahip olduğundan kimlik çakışmalarının etkinlik oluşturma sırasında tespit edileceğini garanti edemeyiz. Çakışma riskini en aza indirmek için RFC4122'de açıklanan gibi yerleşik bir UUID algoritması kullanmanızı öneririz.

Bir kimlik belirtmezseniz sunucu tarafından otomatik olarak oluşturulur.

icalUID ve id özelliklerinin aynı olmadığını ve etkinlik oluşturma sırasında yalnızca birinin sağlanması gerektiğini unutmayın. Semantiklerindeki bir fark, yinelenen etkinliklerde bir etkinliğin tüm oluşumlarının farklı id'lere sahip olması ancak hepsinin aynı icalUID'leri paylaşmasıdır.

 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.