Events: import

Bir etkinliği içe aktarır. Bu işlem, mevcut bir etkinliğin özel kopyasını takvime eklemek için kullanılır. Yalnızca eventType değeri default olan etkinlikler içe aktarılabilir.

Kullanımdan kaldırılan davranış: default olmayan bir etkinlik içe aktarılırsa türü default olarak değiştirilir ve sahip olabileceği etkinliğe özgü tüm özellikler bırakılır.

Şimdi deneyin.

İstek

HTTP isteği

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

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).
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.
iCalUID string RFC5545'te tanımlandığı şekilde etkinliğin benzersiz tanımlayıcısı. Takvim sistemlerindeki etkinlikleri benzersiz şekilde tanımlamak için kullanılır ve etkinlikler import yöntemiyle içe aktarılırken sağlanmalıdır.

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. Bir etkinliği iCalUID kullanarak almak için events.list yöntemini iCalUID parametresiyle çağırın. Bir etkinliği id kullanarak almak için events.get yöntemini çağırın.
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
organizer object Etkinliğin düzenleyicisi. Düzenleyen kişi aynı zamanda katılımcıysa bu durum, attendees içinde ayrı bir girişle belirtilir ve organizer alanı True olarak ayarlanır. Düzenleyeni değiştirmek için taşıma işlemini kullanın. Etkinlik içe aktarma dışında salt okunur. yazılabilir
organizer.displayName string Varsa düzenleyenin adı. yazılabilir
organizer.email string Düzenleyenin e-posta adresi (varsa). RFC5322'ye göre geçerli bir e-posta adresi olmalıdır. 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

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.