Calendar API, farklı türde etkinlik kaynakları sunar. Etkinlikler hakkında başlıklı makalede daha fazla bilgi bulabilirsiniz.
Bu kaynağa ilişkin yöntemlerin listesi için bu sayfanın sonuna bakın.
Kaynak temsilleri
{ "kind": "calendar#event", "etag": etag, "id": string, "status": string, "htmlLink": string, "created": datetime, "updated": datetime, "summary": string, "description": string, "location": string, "colorId": string, "creator": { "id": string, "email": string, "displayName": string, "self": boolean }, "organizer": { "id": string, "email": string, "displayName": string, "self": boolean }, "start": { "date": date, "dateTime": datetime, "timeZone": string }, "end": { "date": date, "dateTime": datetime, "timeZone": string }, "endTimeUnspecified": boolean, "recurrence": [ string ], "recurringEventId": string, "originalStartTime": { "date": date, "dateTime": datetime, "timeZone": string }, "transparency": string, "visibility": string, "iCalUID": string, "sequence": integer, "attendees": [ { "id": string, "email": string, "displayName": string, "organizer": boolean, "self": boolean, "resource": boolean, "optional": boolean, "responseStatus": string, "comment": string, "additionalGuests": integer } ], "attendeesOmitted": boolean, "extendedProperties": { "private": { (key): string }, "shared": { (key): string } }, "hangoutLink": string, "conferenceData": { "createRequest": { "requestId": string, "conferenceSolutionKey": { "type": string }, "status": { "statusCode": string } }, "entryPoints": [ { "entryPointType": string, "uri": string, "label": string, "pin": string, "accessCode": string, "meetingCode": string, "passcode": string, "password": string } ], "conferenceSolution": { "key": { "type": string }, "name": string, "iconUri": string }, "conferenceId": string, "signature": string, "notes": string, }, "gadget": { "type": string, "title": string, "link": string, "iconLink": string, "width": integer, "height": integer, "display": string, "preferences": { (key): string } }, "anyoneCanAddSelf": boolean, "guestsCanInviteOthers": boolean, "guestsCanModify": boolean, "guestsCanSeeOtherGuests": boolean, "privateCopy": boolean, "locked": boolean, "reminders": { "useDefault": boolean, "overrides": [ { "method": string, "minutes": integer } ] }, "source": { "url": string, "title": string }, "workingLocationProperties": { "type": string, "homeOffice": (value), "customLocation": { "label": string }, "officeLocation": { "buildingId": string, "floorId": string, "floorSectionId": string, "deskId": string, "label": string } }, "outOfOfficeProperties": { "autoDeclineMode": string, "declineMessage": string }, "focusTimeProperties": { "autoDeclineMode": string, "declineMessage": string, "chatStatus": string }, "attachments": [ { "fileUrl": string, "title": string, "mimeType": string, "iconLink": string, "fileId": string } ], "eventType": string }
Mülk adı | Değer | Açıklama | Notlar |
---|---|---|---|
anyoneCanAddSelf |
boolean |
Herkesin kendisini etkinliğe davet edip edemeyeceği (kullanımdan kaldırıldı). İsteğe bağlı. Varsayılan, Yanlış'tır. | yazılabilir |
attachments[] |
list |
Etkinlikle ilgili dosya ekleri. Ekleri değiştirmek için Etkinlik başına en fazla 25 ek olabilir. |
|
attachments[].fileId |
string |
Ekteki dosyanın kimliği. Salt okunurdur. Google Drive dosyaları için bu, Drive API'deki ilgili |
|
attachments[].fileUrl |
string |
Ekin URL bağlantısı. Google Drive dosya ekleri eklemek için Drive API'deki Ek iliştirirken gereklidir. |
yazılabilir |
attachments[].iconLink |
string |
Ekin simgesine URL bağlantısı. Bu alan yalnızca özel üçüncü taraf ekleri için değiştirilebilir. | |
attachments[].mimeType |
string |
Ekin internet medya türü (MIME türü). | |
attachments[].title |
string |
Ek başlığı. | |
attendeesOmitted |
boolean |
Katılımcıların etkinlik temsilinden çıkarılıp çıkarılmayacağı. Bir etkinlik alınırken bunun nedeni, maxAttendee sorgu parametresi tarafından belirtilen bir kısıtlama olabilir. Bir etkinliği güncellerken, bu seçenek yalnızca katılımcının yanıtını güncellemek için kullanılabilir. İsteğe bağlı. Varsayılan, Yanlış'tır. |
yazılabilir |
attendees[] |
list |
Etkinliğin katılımcıları. Diğer takvim kullanıcılarıyla etkinlik planlama hakkında daha fazla bilgi edinmek için Katılımcıları olan etkinlikler rehberine göz atın. Hizmet hesaplarının katılımcı listesini doldurmak için alan genelinde yetki verme özelliğini 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 |
Varsa katılımcının e-posta adresi. Katılımcı eklerken bu alan mevcut olmalıdır. RFC5322 uyarınca geçerli bir e-posta adresi olmalıdır. Katılımcı eklerken gereklidir. |
yazılabilir |
attendees[].id |
string |
Varsa katılımcının Profil Kimliği. | |
attendees[].optional |
boolean |
Bu katılımcının isteğe bağlı olup olmadığı. İsteğe bağlı. Varsayılan, Yanlış'tır. | yazılabilir |
attendees[].organizer |
boolean |
Katılımcının etkinliği düzenleyen kişi olup olmadığı. Salt okunurdur. Varsayılan, Yanlış'tır. | |
attendees[].resource |
boolean |
Katılımcının bir kaynak olup olmadığı. Yalnızca katılımcı etkinliğe ilk kez eklendiğinde ayarlanabilir. Daha sonraki değişiklikler yoksayılır. İsteğe bağlı. Varsayılan, Yanlış'tır. | yazılabilir |
attendees[].responseStatus |
string |
Katılımcının yanıt durumu. Olası değerler:
|
yazılabilir |
attendees[].self |
boolean |
Bu girişin, etkinliğin bu kopyasının göründüğü takvimi temsil edip etmediği. Salt okunurdur. Varsayılan, Yanlış'tır. | |
colorId |
string |
Etkinliğin rengi. Bu kimlik, renk tanımının event bölümündeki bir girişi ifade eden bir kimliktir ( renk uç noktasına bakın). İsteğe bağlı. |
yazılabilir |
conferenceData |
nested object |
Konferansla ilgili bilgiler (ör. bir Google Meet konferansının ayrıntıları) Yeni konferans ayrıntılarını oluşturmak için createRequest alanını kullanın. Değişikliklerinizi kaybetmemek için tüm etkinlik değişiklik isteklerinde conferenceDataVersion istek parametresini 1 olarak ayarlamayı unutmayın. |
yazılabilir |
conferenceData.conferenceId |
string |
Konferansın kimliği. Geliştiriciler tarafından konferans takibi yapmak için kullanılabilir, kullanıcılara gösterilmemelidir. Kimlik değeri, her konferans çözümü türü için farklı şekilde oluşturulur:
|
|
conferenceData.conferenceSolution |
nested object |
Konferans çözümü (ör. Google Meet). Başarısız bir oluşturma isteği olan konferans için ayarı kaldırın.
|
|
conferenceData.conferenceSolution.iconUri |
string |
Bu çözümün kullanıcı tarafından görülebilen simgesi. | |
conferenceData.conferenceSolution.key |
nested object |
Bu etkinlik için konferans çözümünü benzersiz şekilde tanımlayabilen anahtar. | |
conferenceData.conferenceSolution.key.type |
string |
Konferans çözümü türü. İstemci alışılmadık veya boş bir türle karşılaşırsa giriş noktalarını görüntüleyebilir. Ancak, değişiklik yapılmasına izin verilmemelidir. Olası değerler şunlardır:
|
|
conferenceData.conferenceSolution.name |
string |
Bu çözümün kullanıcı tarafından görülebilen adı. Yerelleştirilmemiş. | |
conferenceData.createRequest |
nested object |
Yeni bir konferans oluşturma ve bunu etkinliğe ekleme isteği. Veriler eşzamansız olarak oluşturulur. Verilerin mevcut olup olmadığını görmek için status alanını kontrol edin.
|
|
conferenceData.createRequest.conferenceSolutionKey |
nested object |
Konferans çözümü (ör. Hangouts veya Google Meet). | |
conferenceData.createRequest.conferenceSolutionKey.type |
string |
Konferans çözümü türü. İstemci alışılmadık veya boş bir türle karşılaşırsa giriş noktalarını görüntüleyebilir. Ancak, değişiklik yapılmasına izin verilmemelidir. Olası değerler şunlardır:
|
|
conferenceData.createRequest.requestId |
string |
Bu istek için istemci tarafından oluşturulan benzersiz kimlik. İstemciler, her yeni istek için bu kimliği yeniden oluşturmalıdır. Sağlanan kimlik önceki istekle aynıysa istek yoksayılır. |
|
conferenceData.createRequest.status |
nested object |
Konferans oluşturma isteğinin durumu. | |
conferenceData.createRequest.status.statusCode |
string |
Konferans oluşturma isteğinin mevcut durumu. Salt okunurdur. Olası değerler şunlardır:
|
|
conferenceData.entryPoints[] |
list |
Konferans giriş noktaları hakkında bilgi (ör. URL'ler veya telefon numaraları). Tüm katılımcılar aynı konferansa ait olmalıdır.
|
|
conferenceData.entryPoints[].accessCode |
string |
Konferansa erişmek için erişim kodu. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen { İsteğe bağlı. |
|
conferenceData.entryPoints[].entryPointType |
string |
Konferans giriş noktasının türü. Olası değerler:
|
|
conferenceData.entryPoints[].label |
string |
URI'nın etiketi. Son kullanıcılar görebilir. Yerelleştirilmemiş. Maksimum uzunluk 512 karakterdir. Örnekler:
İsteğe bağlı. |
|
conferenceData.entryPoints[].meetingCode |
string |
Konferansa erişmek için toplantı kodu. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen { İsteğe bağlı. |
|
conferenceData.entryPoints[].passcode |
string |
Konferansa erişmek için kullanılan şifre kodu. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen { |
|
conferenceData.entryPoints[].password |
string |
Konferansa erişmek için kullanılacak şifre. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen { İsteğe bağlı. |
|
conferenceData.entryPoints[].pin |
string |
Konferansa erişmek için kullanılacak PIN. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen { İsteğe bağlı. |
|
conferenceData.entryPoints[].uri |
string |
Giriş noktasının URI'sı. Maksimum uzunluk 1.300 karakterdir. Biçim:
|
|
conferenceData.notes |
string |
Kullanıcıya görüntülenecek ek notlar (ör. alan yöneticisinin talimatları, yasal uyarılar). HTML içerebilir. Maksimum uzunluk 2048 karakterdir. İsteğe bağlı. | |
conferenceData.signature |
string |
Konferans verilerinin imzası. Sunucu tarafında oluşturulur. Başarısız bir oluşturma isteği olan konferans için ayarı kaldırın. Bekleyen oluşturma isteği olan konferanslar için isteğe bağlıdır. |
|
created |
datetime |
Etkinliğin oluşturulma zamanı (RFC3339 zaman damgası olarak). Salt okunurdur. | |
creator |
object |
Etkinliği oluşturan kullanıcı. Salt okunurdur. | |
creator.displayName |
string |
Varsa içerik üreticinin adı. | |
creator.email |
string |
Varsa oluşturan kişinin e-posta adresi. | |
creator.id |
string |
Varsa içerik üreticinin profil kimliği | |
creator.self |
boolean |
Etkinliği oluşturan kullanıcının, etkinlik kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunurdur. Varsayılan, Yanlış'tır. | |
description |
string |
Etkinliğin açıklaması. HTML içerebilir. İsteğe bağlı. | yazılabilir |
end |
nested object |
Etkinliğin (hariç) bitiş zamanı. Düzenli bir etkinlik için bu, ilk örneğin bitiş zamanıdır. | |
end.date |
date |
Bu tüm gün süren bir etkinlikse, "yyyy-aa-gg" biçiminde tarih. | yazılabilir |
end.dateTime |
datetime |
Birleşik bir tarih-saat değeri (RFC3339'a göre biçimlendirilmiş) olarak saat. timeZone ürününde saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir. |
yazılabilir |
end.timeZone |
string |
Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Avrupa/Zürih".) Düzenli etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek etkinlikler için bu alan isteğe bağlıdır ve etkinlik başlangıcı/sonu için özel bir saat dilimini belirtir. | yazılabilir |
endTimeUnspecified |
boolean |
Bitiş zamanının belirtilmemiş olup olmadığı. Bu özellik Doğru değerine ayarlanmış olsa bile uyumluluk nedeniyle bitiş zamanı sağlanır. Varsayılan, Yanlış'tır. | |
etag |
etag |
Kaynağın ETag. | |
eventType |
string |
Etkinliğin belirli bir türü. Etkinlik oluşturulduktan sonra bu ayar değiştirilemez. Olası değerler:
|
yazılabilir |
extendedProperties |
object |
Etkinliğin genişletilmiş özellikleri. | |
extendedProperties.private |
object |
Bu takvimde görünen etkinliğin kopyasına özel özellikler. | yazılabilir |
extendedProperties.private.(key) |
string |
Özel mülkün adı ve ilgili değer. | |
extendedProperties.shared |
object |
Etkinliğin diğer katılımcıların takvimlerindeki kopyaları arasında paylaşılan özellikler. | yazılabilir |
extendedProperties.shared.(key) |
string |
Paylaşılan mülkün adı ve karşılık gelen değer. | |
focusTimeProperties |
nested object |
Odaklanma Zamanı etkinlik verileri. eventType değeri focusTime ise kullanılır. |
yazılabilir |
focusTimeProperties.autoDeclineMode |
string |
Odaklanma zamanı etkinlikleriyle çakışan toplantı davetiyelerinin reddedilip reddedilmeyeceğini belirtir. Geçerli değerler declineNone değerleridir. Yani hiçbir toplantı daveti reddedilir; declineAllConflictingInvitations , etkinlikle çakışan tüm çakışan toplantı davetiyeleri reddedilir ve declineOnlyNewConflictingInvitations , yani yalnızca Odaklanma Zamanı etkinliği mevcutken gelen yeni çakışan toplantı davetiyeleri reddedilir. |
|
focusTimeProperties.chatStatus |
string |
Kullanıcıyı Chat'te ve ilgili ürünlerde işaretleme durumu. Bu değer, available veya doNotDisturb olabilir. |
|
focusTimeProperties.declineMessage |
string |
Mevcut bir etkinliğin veya yeni bir davetiyenin Takvim tarafından otomatik olarak reddedilip reddedilmeyeceğini belirleyen yanıt iletisi. | |
gadget |
object |
Bu etkinliği genişleten bir gadget. Gadget'lar kullanımdan kaldırılmıştır; bu yapı yalnızca doğum günü takvimi meta verilerini döndürmek için kullanılmaktadır. | |
gadget.display |
string |
Gadget'ın görüntü modu. Kullanımdan kaldırıldı. Olası değerler:
|
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.iconLink |
string |
Gadget'ın simge URL'si. URL şeması HTTPS olmalıdır. Kullanımdan kaldırıldı. | yazılabilir |
gadget.link |
string |
Gadget'ın URL'si. URL şeması HTTPS olmalıdır. Kullanımdan kaldırıldı. | yazılabilir |
gadget.preferences |
object |
Tercihler'e dokunun. | yazılabilir |
gadget.preferences.(key) |
string |
Tercih adı ve ilgili değer. | |
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 |
Etkinliği düzenleyen kullanıcı dışındaki katılımcıların etkinliğe başkalarını davet edip edemeyeceği. İsteğe bağlı. Varsayılan, Doğru değeridir. | yazılabilir |
guestsCanModify |
boolean |
Düzenleyen kişi dışındaki katılımcıların etkinliği değiştirip değiştiremeyeceğini belirler. İsteğe bağlı. Varsayılan, Yanlış'tır. | yazılabilir |
guestsCanSeeOtherGuests |
boolean |
Etkinliği düzenleyen kişi dışındaki katılımcıların, etkinlik katılımcılarının kimler olduğunu görüp göremeyeceği. İsteğe bağlı. Varsayılan, Doğru değeridir. | yazılabilir |
hangoutLink |
string |
Bu etkinlikle ilişkili Google Hangout'un mutlak bağlantısı. Salt okunurdur. | |
htmlLink |
string |
Google Takvim web kullanıcı arayüzünde bu etkinliğin mutlak bağlantısı. Salt okunurdur. | |
iCalUID |
string |
RFC5545'te tanımlandığı şekliyle etkinlik benzersiz tanımlayıcısı. Bu kimlik, takvim sistemleri genelinde etkinlikleri benzersiz şekilde tanımlamak için kullanılır ve etkinlikler import yöntemiyle içe aktarılırken sağlanmalıdır.
|
|
id |
string |
Etkinliğin opak tanımlayıcısı. Yeni tekli veya düzenli etkinlikler oluştururken bu etkinliklerin kimliklerini belirtebilirsiniz. Sağlanan kimlikler aşağıdaki kurallara uygun olmalıdır:
Kimlik belirtmezseniz, sunucu tarafından otomatik olarak oluşturulur.
|
yazılabilir |
kind |
string |
Kaynağın türü ("calendar#event "). |
|
location |
string |
Serbest biçimli metin olarak etkinliğin coğrafi konumu. İsteğe bağlı. | yazılabilir |
locked |
boolean |
Bunun, "özet", "açıklama", "konum", "başlangıç", "bitiş" veya "tekrarlama" ana etkinlik alanlarında hiçbir değişiklik yapılamayan kilitli bir etkinlik kopyası olup olmadığı. Varsayılan, Yanlış'tır. Salt Okunur. | |
organizer |
object |
Etkinliği düzenleyen kullanıcı. Düzenleyen aynı zamanda bir katılımcıysa bu, attendees içinde organizer alanı True olarak ayarlanmış ayrı bir girişle belirtilir. Düzenleyeni değiştirmek için taşı işlemini kullanın. Salt okunur (bir etkinliğin içe aktarıldığı durumlar hariç). |
yazılabilir |
organizer.displayName |
string |
Varsa düzenleyenin adı. | yazılabilir |
organizer.email |
string |
Varsa düzenleyen kişinin e-posta adresi. RFC5322 uyarınca geçerli bir e-posta adresi olmalıdır. | yazılabilir |
organizer.id |
string |
Varsa düzenleyenin Profil Kimliği. | |
organizer.self |
boolean |
Düzenleyenin, etkinliğin bu kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunurdur. Varsayılan, Yanlış'tır. | |
originalStartTime |
nested object |
Düzenli bir etkinliğin örneği için, bu etkinliğin, düzenli etkinlik kimliği tarafından tanımlanan yinelenme verilerine göre başlayacağı zamandır. Örnek farklı bir zamana taşınmış olsa bile düzenli etkinlik serisi içindeki örneği benzersiz şekilde tanımlar. Sabit. | |
originalStartTime.date |
date |
Bu tüm gün süren bir etkinlikse, "yyyy-aa-gg" biçiminde tarih. | yazılabilir |
originalStartTime.dateTime |
datetime |
Birleşik bir tarih-saat değeri (RFC3339'a göre biçimlendirilmiş) olarak saat. timeZone ürününde saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir. |
yazılabilir |
originalStartTime.timeZone |
string |
Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Avrupa/Zürih".) Düzenli etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek etkinlikler için bu alan isteğe bağlıdır ve etkinlik başlangıcı/sonu için özel bir saat dilimini belirtir. | yazılabilir |
outOfOfficeProperties |
nested object |
Ofis dışında etkinlik verileri. eventType değeri outOfOffice ise kullanılır. |
yazılabilir |
outOfOfficeProperties.autoDeclineMode |
string |
Çakışan "Ofis dışında etkinlikleri" olan toplantı davetiyelerinin reddedilip reddedilmeyeceğini belirtir. Geçerli değerler declineNone değerleridir; yani hiçbir toplantı davetiyesi reddedilir; declineAllConflictingInvitations , etkinlikle çakışan tüm çakışan toplantı davetiyeleri reddedilir ve declineOnlyNewConflictingInvitations , yalnızca Ofis dışında etkinliği mevcutken gelen yeni çakışan toplantı davetiyeleri reddedilir. |
|
outOfOfficeProperties.declineMessage |
string |
Mevcut bir etkinliğin veya yeni bir davetiyenin Takvim tarafından otomatik olarak reddedilip reddedilmeyeceğini belirleyen yanıt iletisi. | |
privateCopy |
boolean |
Politika, Doğru değerine ayarlanırsa Etkinlik yayılımı devre dışı bırakılır. Bunun Özel etkinlik özellikleri ile aynı şey olmadığını unutmayın. İsteğe bağlı. Sabit. Varsayılan, Yanlış'tır. | |
recurrence[] |
list |
RFC5545'te belirtildiği şekilde, düzenli bir etkinliğe ait RRULE, EXRULE, RDATE ve EXDATE satırlarının listesi. Bu alanda DTSTART ve DTEND satırlarına izin verilmediğini unutmayın. Etkinlik başlangıç ve bitiş zamanları start ve end alanlarında belirtilir. Bu alan, tek etkinlikler veya yinelenen etkinlik örnekleri için atlanır. |
yazılabilir |
recurringEventId |
string |
Düzenli bir etkinliğin örneği için bu, örneğin ait olduğu düzenli etkinliğin id değeridir. Sabit. |
|
reminders |
object |
Kimliği doğrulanmış kullanıcı için etkinlik hatırlatıcılarıyla ilgili bilgiler. | |
reminders.overrides[] |
list |
Etkinlikte varsayılan hatırlatıcılar kullanılmıyorsa bu, etkinliğe özel hatırlatıcıları listeler. Ayarlanmamışsa bu etkinlik için hatırlatıcı ayarlanmadığını gösterir. Maksimum geçersiz kılma hatırlatıcısı sayısı 5'tir. | yazılabilir |
reminders.overrides[].method |
string |
Bu hatırlatıcının kullandığı yöntem. Olası değerler:
Hatırlatıcı eklerken gerekir. |
yazılabilir |
reminders.overrides[].minutes |
integer |
Hatırlatıcının, etkinliğin başlamasından kaç dakika önce tetikleneceği. Geçerli değerler 0 ile 40320 arasındadır (dakika cinsinden 4 hafta). Hatırlatıcı eklerken gerekir. |
yazılabilir |
reminders.useDefault |
boolean |
Takvimdeki varsayılan hatırlatıcıların etkinliğe uygulanıp uygulanmayacağı. | yazılabilir |
sequence |
integer |
iTakvim'e göre sıra numarası. | yazılabilir |
source |
object |
Etkinliğin oluşturulduğu kaynak. Örneğin bir web sayfası, e-posta mesajı ya da HTTP veya HTTPS şemasına sahip bir URL tarafından tanımlanabilir herhangi bir doküman. Yalnızca etkinliği oluşturan kişi tarafından görüntülenebilir veya değiştirilebilir. | |
source.title |
string |
Kaynağın başlığı. Örneğin, bir web sayfasının başlığı veya e-posta konusu. | yazılabilir |
source.url |
string |
Bir kaynağa işaret eden kaynağın URL'si. URL şeması HTTP veya HTTPS olmalıdır. | yazılabilir |
start |
nested object |
Etkinliğin (dahil) başlangıç zamanı. Düzenli bir etkinlik için bu, ilk örneğin başlangıç zamanıdır. | |
start.date |
date |
Bu tüm gün süren bir etkinlikse, "yyyy-aa-gg" biçiminde tarih. | yazılabilir |
start.dateTime |
datetime |
Birleşik bir tarih-saat değeri (RFC3339'a göre biçimlendirilmiş) olarak saat. timeZone ürününde saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir. |
yazılabilir |
start.timeZone |
string |
Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Avrupa/Zürih".) Düzenli etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek etkinlikler için bu alan isteğe bağlıdır ve etkinlik başlangıcı/sonu için özel bir saat dilimini belirtir. | yazılabilir |
status |
string |
Etkinliğin durumu. İsteğe bağlı. Olası değerler:
|
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:
|
yazılabilir |
updated |
datetime |
Etkinliğin son değiştirme zamanı (RFC3339 zaman damgası olarak). Salt okunurdur. | |
visibility |
string |
Etkinliğin görünürlüğü. İsteğe bağlı. Olası değerler:
|
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 bilgi için isteğe bağlı ekstra etiket. | yazılabilir |
workingLocationProperties.homeOffice |
any value |
Varsa kullanıcının evde çalıştığını belirtir. | yazılabilir |
workingLocationProperties.officeLocation |
object |
Varsa 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 ad, kuruluşun Kaynaklar veritabanındaki bir bina kimliğine referansta bulunmalıdır. | 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ı kat tanımlayıcı. | yazılabilir |
workingLocationProperties.officeLocation.floorSectionId |
string |
İsteğe bağlı kat bölümü tanımlayıcısı. | yazılabilir |
workingLocationProperties.officeLocation.label |
string |
Takvim Web ve Mobil istemcilerinde görüntülenen ofis adı. Kuruluşun Kaynaklar veritabanında bulunan bir bina adına başvurmanızı öneririz. | yazılabilir |
workingLocationProperties.type |
string |
Çalışma yeri türü. Olası değerler:
Çalışma yeri özellikleri eklerken gerekir. |
yazılabilir |
Yöntemler
- sil
- Bir etkinliği siler.
- al
- Google Takvim kimliğine dayalı olarak bir etkinlik döndürür. Bir etkinliği iCalendar kimliğini kullanarak almak için
iCalUID
parametresini kullanarakevents.list yöntemini çağırın. - import
- Bir etkinliği içe aktarır. Bu işlem, mevcut bir etkinliğin gizli kopyasını bir takvime eklemek için kullanılır. Yalnızca
eventType
/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 etkinlik türüne özgü tüm özellikler çıkarılır. - ekle
- Etkinlik oluşturur.
- örnekler
- Belirtilen düzenli etkinliğin örneklerini döndürür.
- list
- Belirtilen takvimdeki etkinlikleri döndürür.
- taşı
- Bir etkinliği başka bir takvime taşır (ör. etkinliğin düzenleyicisini değiştirir). Yalnızca
default
etkinliklerinin taşınabileceğini,outOfOffice
,focusTime
veworkingLocation
etkinliklerinin taşınamayacağını unutmayın. - yama
- Bir etkinliği günceller. Bu yöntem yama semantiğini destekler. Her yama isteğinin üç kota birimi tükettiğini unutmayın; bir
get
ve ardındanupdate
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ı (belirtilmişse) mevcut dizilerin üzerine yazılır. Bu işlem, önceki dizi öğelerini siler. - quickAdd
- Basit bir metin dizesine göre etkinlik oluşturur.
- güncelle
- 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
get
ve ardından, eşitsizlikten emin olmak için etag'leri kullanarakupdate
işlemi gerçekleştirin. - saatinizi
- Etkinlikler kaynaklarında yapılan değişiklikleri takip edin.