Calendar API farklı etkinlik kaynakları türleri sunar. Daha fazla bilgiyi Etkinlikler hakkında bölümünde bulabilirsiniz.
Bu kaynağa yönelik yöntem 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 (desteği sonlandırılmış). İsteğe bağlı. Varsayılan değer, Yanlış'tır. | yazılabilir |
attachments[] |
list |
Etkinlikle ilgili dosya ekleri. Eklerde değişiklik yapabilmek için Etkinlik başına en fazla 25 ek olabilir. |
|
attachments[].fileId |
string |
Eklenen dosyanın kimliği. Salt okunur. Google Drive dosyaları için bu, Drive API'deki karşılık gelen |
|
attachments[].fileUrl |
string |
Ekin URL bağlantısı. Google Drive dosya ekleri eklemek için, Drive API'deki Ek iliştirilirken gereklidir. |
yazılabilir |
attachments[].iconLink |
string |
Ekin simgesinin 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 etkinliğin temsilinden çıkarılıp çıkarılmadığı. Bir etkinlik alınırken bunun nedeni maxAttendee sorgu parametresi tarafından belirtilen bir kısıtlama olabilir. Bir etkinlik güncellenirken 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 değer, 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ılı etkinlikler kılavuzuna göz atın. Katılımcı listesini doldurmak için hizmet hesaplarının alan genelinde yetki yetkisini 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ıyla ilgili yorum. İ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ı eklenirken bu alan bulunmalıdır. Bu, RFC5322'ye göre geçerli bir e-posta adresi olmalıdır. Katılımcı eklerken gerekir. |
yazılabilir |
attendees[].id |
string |
Varsa katılımcının profil kimliği. | |
attendees[].optional |
boolean |
Bunun isteğe bağlı bir katılımcı olup olmadığı bilgisi. İsteğe bağlı. Varsayılan değer, Yanlış'tır. | yazılabilir |
attendees[].organizer |
boolean |
Katılımcının etkinliği düzenleyen kişi olup olmadığı. Salt okunur. Varsayılan değer, Yanlış'tır. | |
attendees[].resource |
boolean |
Katılımcının kaynak olup olmadığı. Yalnızca katılımcı etkinliğe ilk kez eklendiğinde ayarlanabilir. Daha sonra yapılacak değişiklikler yoksayılır. İsteğe bağlı. Varsayılan değer, 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 okunur. Varsayılan değer, Yanlış'tır. | |
colorId |
string |
Etkinliğin rengi. Bu, renk tanımının event bölümündeki bir girişi ifade eden bir kimliktir ( renkler uç noktasına bakın). İsteğe bağlı. |
yazılabilir |
conferenceData |
nested object |
Google Meet konferansının ayrıntıları gibi konferansla ilgili bilgiler. Yeni konferans ayrıntıları oluşturmak için createRequest alanını kullanın. Değişikliklerinizi sürdürmek istiyorsanız tüm etkinlik değiştirme isteklerinde conferenceDataVersion istek parametresini 1 olarak ayarlamayı unutmayın. |
yazılabilir |
conferenceData.conferenceId |
string |
Konferansın kimliği. Geliştiriciler tarafından konferansları takip etmek 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). Oluşturma isteği başarısız olan bir konferansın ayarını kaldırın.
|
|
conferenceData.conferenceSolution.iconUri |
string |
Bu çözüm için kullanıcıların görebileceği simge. | |
conferenceData.conferenceSolution.key |
nested object |
Bu etkinlik için konferans çözümünü benzersiz şekilde tanımlayabilecek anahtar. | |
conferenceData.conferenceSolution.key.type |
string |
Konferans çözümü türü. Bir istemci bilinmeyen veya boş türle karşılaşırsa yine de giriş noktalarını görüntüleyebilmelidir. Ancak, değişikliklere izin verilmemelidir. Olası değerler şunlardır:
|
|
conferenceData.conferenceSolution.name |
string |
Bu çözümün kullanıcı tarafından görülebilen adı. Yerelleştirilmedi. | |
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 |
Hangouts veya Google Meet gibi bir konferans çözümü. | |
conferenceData.createRequest.conferenceSolutionKey.type |
string |
Konferans çözümü türü. Bir istemci bilinmeyen veya boş türle karşılaşırsa yine de giriş noktalarını görüntüleyebilmelidir. Ancak, değişikliklere izin verilmemelidir. Olası değerler şunlardır:
|
|
conferenceData.createRequest.requestId |
string |
Bu istek için müşteri 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 okunur. Olası değerler şunlardır:
|
|
conferenceData.entryPoints[] |
list |
Bağımsız konferans giriş noktalarıyla ilgili bilgiler (ör. URL'ler veya telefon numaraları) Hepsi aynı konferansa ait olmalıdır.
|
|
conferenceData.entryPoints[].accessCode |
string |
Konferansa erişmek için kullanılacak erişim kodu. En çok 128 karakter kullanılabilir. 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ştirilmedi. En çok 512 karakter kullanılabilir. Örnekler:
İsteğe bağlı. |
|
conferenceData.entryPoints[].meetingCode |
string |
Konferansa erişmek için kullanılacak toplantı kodu. En çok 128 karakter kullanılabilir. 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. En çok 128 karakter kullanılabilir. 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ılan şifre. En çok 128 karakter kullanılabilir. 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. En çok 128 karakter kullanılabilir. 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ı. En çok 1.300 karakter kullanılabilir. Biçim:
|
|
conferenceData.notes |
string |
Kullanıcıya gösterilecek ek notlar (alan yöneticisinin talimatları, yasal uyarılar gibi). HTML içerebilir. En çok 2048 karakter kullanılabilir. İsteğe bağlı. | |
conferenceData.signature |
string |
Konferans verilerinin imzası. Sunucu tarafında oluşturulur. Oluşturma isteği başarısız olan bir konferansın ayarını kaldırın. Bekleyen oluşturma isteği olan konferanslarda isteğe bağlıdır. |
|
created |
datetime |
Etkinliğin oluşturulma zamanı (RFC3339 zaman damgası olarak). Salt okunur. | |
creator |
object |
Etkinliği oluşturan kullanıcı. Salt okunur. | |
creator.displayName |
string |
Varsa içerik üreticinin adı. | |
creator.email |
string |
Varsa içerik üreticinin e-posta adresi | |
creator.id |
string |
Oluşturanın profil kimliği (varsa). | |
creator.self |
boolean |
İçerik üreticinin etkinlik kopyasının göründüğü takvimle uyumlu olup olmadığı. Salt okunur. Varsayılan değer, Yanlış'tır. | |
description |
string |
Etkinliğin açıklaması. HTML içerebilir. İsteğe bağlı. | yazılabilir |
end |
nested object |
Etkinliğin (özel) bitiş zamanı. Düzenli bir etkinlik için bu, ilk etkinliğ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ştirilmiş tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone içinde bir 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çimlendirilmiştir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan gereklidir ve yinelenmenin genişletildiği saat dilimini belirtir. Tek bir etkinlik için bu alan isteğe bağlıdır ve etkinliğin başlangıcı/bitişi için özel bir saat dilimi belirtir. | yazılabilir |
endTimeUnspecified |
boolean |
Bitiş zamanının gerçekten belirtilmemiş olup olmadığı. Bu özellik Doğru değerine ayarlanmış olsa bile uyumluluk nedeniyle bitiş zamanı sağlanır. Varsayılan değer, Yanlış'tır. | |
etag |
etag |
Kaynağın eTag'i. | |
eventType |
string |
Etkinliğin 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 |
Etkinliğin bu takvimde görünen kopyasına özel özellikler. | yazılabilir |
extendedProperties.private.(key) |
string |
Özel mülkün adı ve ilgili değer. | |
extendedProperties.shared |
object |
Diğer katılımcıların cihazındaki etkinlik kopyaları arasında paylaşılan mülkler takvim. | yazılabilir |
extendedProperties.shared.(key) |
string |
Paylaşılan mülkün adı ve ilgili 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 belirler. Geçerli değerler declineNone şeklindedir. Diğer bir deyişle hiçbir toplantı davetiyesi reddedilmez; declineAllConflictingInvitations : Etkinlikle çakışan tüm çakışan toplantı davetiyeleri reddedilir; ve declineOnlyNewConflictingInvitations (yani yalnızca Odaklanma Zamanı etkinliği varken gelen yeni çakışan toplantı davetiyeleri reddedilecek). |
|
focusTimeProperties.chatStatus |
string |
Kullanıcıyı Chat'te ve ilgili ürünlerde işaretleme durumu. Bu, available veya doNotDisturb olabilir. |
|
focusTimeProperties.declineMessage |
string |
Mevcut bir etkinlik veya yeni davetiye Takvim tarafından otomatik olarak reddedilirse ayarlanacak yanıt iletisi. | |
gadget |
object |
Bu etkinliğin süresini uzatan bir widget. 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ılır. | |
gadget.display |
string |
Aygıtın görüntü modu. Kullanımdan kaldırıldı. Olası değerler:
|
yazılabilir |
gadget.height |
integer |
Aygıtı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 |
Aygıtın simge URL'si. URL şeması HTTPS olmalıdır. Kullanımdan kaldırıldı. | yazılabilir |
gadget.link |
string |
Aygıtın URL'si. URL şeması HTTPS olmalıdır. Kullanımdan kaldırıldı. | yazılabilir |
gadget.preferences |
object |
Tercihler'i tıklayın. | yazılabilir |
gadget.preferences.(key) |
string |
Tercih adı ve karşılık gelen değer. | |
gadget.title |
string |
Aygıtın başlığı. Kullanımdan kaldırıldı. | yazılabilir |
gadget.type |
string |
Aygıtın türü. Kullanımdan kaldırıldı. | yazılabilir |
gadget.width |
integer |
Aygıtı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, Doğru'dur. | yazılabilir |
guestsCanModify |
boolean |
Düzenleyen dışındaki katılımcıların etkinliği değiştirip değiştiremeyeceğini belirtir. İsteğe bağlı. Varsayılan değer, Yanlış'tır. | yazılabilir |
guestsCanSeeOtherGuests |
boolean |
Düzenleyen dışındaki katılımcıların etkinlik katılımcılarının kimler olduğunu görüp göremeyeceğini belirler. İsteğe bağlı. Varsayılan değer, Doğru'dur. | yazılabilir |
hangoutLink |
string |
Bu etkinlikle ilişkili Google Hangout'un mutlak bağlantısı. Salt okunur. | |
htmlLink |
string |
Google Takvim web kullanıcı arayüzünde bu etkinliğin mutlak bağlantısı. Salt okunur. | |
iCalUID |
string |
RFC5545'te tanımlandığı şekliyle benzersiz etkinlik tanımlayıcısı. Takvim sistemlerinde etkinlikleri benzersiz şekilde tanımlamak için kullanılır ve etkinlikler içe aktarma 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 bunların kimliklerini belirtebilirsiniz. Sağlanan kimlikler şu kurallara uygun olmalıdır:
Bir kimlik belirtmezseniz sunucu tarafından otomatik olarak oluşturulur.
|
yazılabilir |
kind |
string |
Kaynak 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 "summary", "description", "location", "start", "end" ana etkinlik alanlarında hiçbir değişiklik yapılamayan kilitli bir etkinlik kopyası olup olmadığı veya "yinelenme" olarak adlandırılır. Varsayılan değer, Yanlış'tır. Salt Okunur. | |
organizer |
object |
Etkinliği düzenleyen kullanıcı. Düzenleyen kişi aynı zamanda bir katılımcıysa bu durum attendees alanında organizer alanı Doğru değerine ayarlanmış ayrı bir girişle belirtilir. Düzenleyiciyi değiştirmek için taşıma işlemini kullanın. Bir etkinliği içe aktarma işlemi hariç, salt okunurdur. |
yazılabilir |
organizer.displayName |
string |
Varsa düzenleyen kişinin adı. | yazılabilir |
organizer.email |
string |
Varsa, düzenleyen kişinin e-posta adresi. Bu, RFC5322'ye göre geçerli bir e-posta adresi olmalıdır. | yazılabilir |
organizer.id |
string |
Varsa düzenleyen kullanıcının profil kimliği. | |
organizer.self |
boolean |
Düzenleyen kullanıcının, etkinliğin bu kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunur. Varsayılan değer, Yanlış'tır. | |
originalStartTime |
nested object |
Düzenli bir etkinlik örneği için bu etkinliğin, yinelenen etkinlik kimliği tarafından tanımlanan yinelenen etkinlikteki yineleme verilerine göre başlayacağı zamandır. Örnek farklı bir zamana taşınmış olsa bile yinelenen etkinlik serisindeki ö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ştirilmiş tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone içinde bir 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çimlendirilmiştir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan gereklidir ve yinelenmenin genişletildiği saat dilimini belirtir. Tek bir etkinlik için bu alan isteğe bağlıdır ve etkinliğin başlangıcı/bitişi için özel bir saat dilimi belirtir. | yazılabilir |
outOfOfficeProperties |
nested object |
Ofis dışında etkinlik verileri. eventType değeri outOfOffice ise kullanılır. |
yazılabilir |
outOfOfficeProperties.autoDeclineMode |
string |
"Ofis dışında" etkinlikleriyle çakışan toplantı davetiyelerinin reddedilip reddedilmeyeceğini belirler. Geçerli değerler declineNone şeklindedir. Diğer bir deyişle hiçbir toplantı davetiyesi reddedilmez; declineAllConflictingInvitations : Etkinlikle çakışan tüm çakışan toplantı davetiyeleri reddedilir; ve declineOnlyNewConflictingInvitations (yani yalnızca Ofis dışında etkinliği varken gelen yeni çakışan toplantı davetiyeleri reddedilecek). |
|
outOfOfficeProperties.declineMessage |
string |
Mevcut bir etkinlik veya yeni davetiye Takvim tarafından otomatik olarak reddedilirse ayarlanacak yanıt iletisi. | |
privateCopy |
boolean |
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 değer, Yanlış'tır. | |
recurrence[] |
list |
RFC5545'te belirtilen, 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 çıkarılır. |
yazılabilir |
recurringEventId |
string |
Düzenli bir etkinliğin örneği için bu, söz konusu örneğin ait olduğu yinelenen etkinliğin id değeridir. Sabit. |
|
reminders |
object |
Kimliği doğrulanmış kullanıcı için etkinlik hatırlatıcılarıyla ilgili bilgiler. Hatırlatıcıları değiştirmenin, ilgili etkinliğin updated özelliğini de değiştirmediğini unutmayın. |
|
reminders.overrides[] |
list |
Etkinlikte varsayılan hatırlatıcılar kullanılmıyorsa etkinliğe özel hatırlatıcılar listelenir. Ayarlanmamışsa etkinlik için hiçbir hatırlatıcı ayarlanmadığı gösterilir. Geçersiz kılma hatırlatıcıları maksimum 5 tanedir. | yazılabilir |
reminders.overrides[].method |
string |
Bu hatırlatıcının kullandığı yöntem. Olası değerler:
Hatırlatıcı eklerken zorunludur. |
yazılabilir |
reminders.overrides[].minutes |
integer |
Etkinlik başlamadan önce hatırlatıcının tetiklenmesi gereken dakika sayısı. Geçerli değerler 0 ile 40.320 (dakika cinsinden 4 hafta) arasındadır. Hatırlatıcı eklerken zorunludur. |
yazılabilir |
reminders.useDefault |
boolean |
Takvimdeki varsayılan hatırlatıcıların etkinliğe uygulanıp uygulanmayacağı. | yazılabilir |
sequence |
integer |
iCalendar'a göre sıra numarası. | yazılabilir |
source |
object |
Etkinliğin oluşturulduğu kaynak. Örneğin, bir web sayfası, e-posta iletisi veya HTTP ya da HTTPS şemasına sahip URL ile tanımlanabilir herhangi bir doküman. Yalnızca etkinliği oluşturan kişi tarafından görülebilir 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ıç saati. 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ştirilmiş tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone içinde bir 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çimlendirilmiştir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan gereklidir ve yinelenmenin genişletildiği saat dilimini belirtir. Tek bir etkinlik için bu alan isteğe bağlıdır ve etkinliğin başlangıcı/bitişi için özel bir saat dilimi 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 |
Ana etkinlik verilerinin son değiştirme zamanı (RFC3339 zaman damgası olarak). Etkinlik hatırlatıcılarının güncellenmesi bu durumu değiştirmez. Salt okunur. | |
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 |
Daha fazla bilgi için isteğe bağlı ekstra bir 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 bir ofisten çalıştığını belirtir. | yazılabilir |
workingLocationProperties.officeLocation.buildingId |
string |
İsteğe bağlı bir bina tanımlayıcısı. Bu, kuruluşun Kaynaklar veritabanındaki bir bina kimliğine başvuruda bulunmalıdır. | yazılabilir |
workingLocationProperties.officeLocation.deskId |
string |
İsteğe bağlı bir 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 web ve mobil istemcilerinde gösterilen ofis adı. Kuruluşun Kaynaklar veritabanındaki bir bina adına referans vermenizi öneririz. | yazılabilir |
workingLocationProperties.type |
string |
Çalışma yerinin türü. Olası değerler:
Çalışma yeri özellikleri eklenirken gereklidir. |
yazılabilir |
Yöntemler
- sil
- Bir etkinliği siler.
- al
- Google Takvim Kimliğine göre bir etkinliği döndürür. Bir etkinliği iCalendar kimliğini kullanarak almak için
iCalUID
parametresini kullanarak events.list yöntemini çağırın. - içe aktarma
- Bir etkinliği içe aktarır. Bu işlem, mevcut bir etkinliğin özel bir kopyasını takvime eklemek için kullanılır. Yalnızca
eventType
/default
değerine sahip etkinlikler içe aktarılabilir.Kullanımdan kaldırılmış davranış:
default
olmayan bir etkinlik içe aktarılırsa türüdefault
olarak değiştirilir ve etkinlik türüne özgü tüm özellikler atlanır. - ekle
- Etkinlik oluşturur.
- örnek
- 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üzenleyicisi değiştirilir). Yalnızca
default
etkinliğin taşınabileceğini unutmayın;outOfOffice
,focusTime
,workingLocation
vefromGmail
etkinlikleri taşınamaz. - yama
- Bir etkinliği günceller. Bu yöntem yama anlamını destekler. Her yama isteğinin üç kota birimi tükettiğini unutmayın;
get
ve ardındanupdate
kullanmayı tercih edersiniz. Belirttiğiniz alan değerleri, mevcut değerlerin yerine geçer. İstekte belirtmediğiniz alanlar değiştirilmeden kalır. Dizi alanları, belirtilirse 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 etkinlik kaynağının tamamını her zaman günceller. Kısmi güncelleme yapmak için etag'leri kullanarak atom ya da kademelendirmeden emin olmak amacıyla
get
ve ardındanupdate
işlemi gerçekleştirin. - saat
- Etkinlikler kaynaklarında yapılan değişiklikleri takip edin.