Calendar API, farklı türde etkinlik kaynakları sağlar. 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 göz atı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 |
Kimsenin kendisini etkinliğe davet edip edemeyeceği (desteği sonlandırıldı). İsteğe bağlı. Varsayılan, Yanlış değeridir. | yazılabilir |
attachments[] |
list |
Etkinlik için 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 okunur. Google Drive dosyaları için, Drive API'deki ilgili |
|
attachments[].fileUrl |
string |
Ekin URL bağlantısı. Google Drive dosya ekleri eklemek için, Drive API'deki Ek eklerken gerekir. |
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 ortam türü (MIME türü). | |
attachments[].title |
string |
Ek başlığı. | |
attendeesOmitted |
boolean |
Katılımcıların etkinlik gösteriminden çıkarılıp çıkarılmayacağı. Bir etkinlik alınırken bu durum, maxAttendee sorgu parametresi tarafından belirtilen bir kısıtlamadan kaynaklanıyor olabilir. Bir etkinliği güncellerken, bu yalnızca katılımcının yanıtını güncellemek için kullanılabilir. İsteğe bağlı. Varsayılan, Yanlış değeridir. |
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ılavuzunu inceleyin. Hizmet hesapları, katılımcı listesini doldurmak için alan genelinde yetki verme özelliğini kullanmalıdır. | 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'ye göre 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 |
Bunun isteğe bağlı bir katılımcı olup olmadığı. İsteğe bağlı. Varsayılan, Yanlış değeridir. | yazılabilir |
attendees[].organizer |
boolean |
Katılımcının etkinliği düzenleyen kişi olup olmadığı. Salt okunur. Varsayılan, Yanlış değeridir. | |
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ış değeridir. | yazılabilir |
attendees[].responseStatus |
string |
Katılımcının yanıt durumu. Olası değerler:
|
yazılabilir |
attendees[].self |
boolean |
Bu girişin, etkinlik kopyasının göründüğü takvimi temsil edip etmediği. Salt okunur. Varsayılan, Yanlış değeridir. | |
colorId |
string |
Etkinliğin rengi. Bu, renk tanımının event bölümündeki bir girişi gösteren 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ı 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 konferansları takip etmek için kullanılabilir ve kullanıcılara görüntülenmemelidir. 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 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 bilinmeyen veya boş bir türle karşılaşırsa yine de giriş noktalarını görüntüleyebilir. Ancak değişikliklere izin vermemelidir. 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 konferans oluşturma ve 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ü. İstemci bilinmeyen veya boş bir türle karşılaşırsa yine de giriş noktalarını görüntüleyebilir. Ancak değişikliklere izin vermemelidir. 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 yok sayı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 |
Ayrı ayrı konferans giriş noktaları hakkında bilgiler (ö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'si. Maksimum uzunluk 1.300 karakterdir. Biçim:
|
|
conferenceData.notes |
string |
Kullanıcıya gösterilecek 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. Oluşturma isteği başarısız olan bir 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 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 |
Varsa içerik üreticinin profil kimliği | |
creator.self |
boolean |
Oluşturan kişinin, etkinlik kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunur. Varsayılan, Yanlış değeridir. | |
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 tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone ürününde saat dilimi açıkça belirtilmedikçe 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 etkinliğin başlangıç/bitişi için özel bir saat dilimini 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 bir bitiş zamanı sağlanır. Varsayılan, Yanlış değeridir. | |
etag |
etag |
Kaynağın ETag. | |
eventType |
string |
Etkinliğin belirli türü. Etkinlik oluşturulduktan sonra bu ayar değiştirilemez. Olası değerler:
default " ve "workingLocation " etkinlikleri oluşturulabilmektedir. Diğer etkinlik türleri için genişletilmiş destek sonraki sürümlerde kullanıma sunulacaktır. |
yazılabilir |
extendedProperties |
object |
Etkinliğin genişletilmiş özellikleri. | |
extendedProperties.private |
object |
Etkinliğin bu takvimde görünen kopyasına özel olan ö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 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 'dir; yani hiçbir toplantı davetiyesi reddedilir; declineAllConflictingInvitations , etkinlikle çakışan tüm çakışan toplantı davetiyeleri reddedilir ve declineOnlyNewConflictingInvitations , yalnızca Odaklanma Zamanı etkinliği mevcutken gelen yeni çakışan toplantı davetiyelerinin reddedileceği anlamına gelir. |
|
focusTimeProperties.chatStatus |
string |
Chat'te ve ilgili ürünlerde kullanıcıyı işaretlenecek durum. Bu available veya doNotDisturb olabilir. |
|
focusTimeProperties.declineMessage |
string |
Mevcut bir etkinliğin veya yeni bir davetiyenin Takvim tarafından otomatik olarak reddedilmesi durumunda kullanılacak yanıt iletisi. | |
gadget |
object |
Bu etkinliğin kapsamını genişleten bir aygıt. Gadget'ların desteği sonlandı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 |
Aygıtı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 |
Düzenleyen kişi 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 dışındaki katılımcıların etkinliği değiştirip değiştiremeyeceğini belirler. İsteğe bağlı. Varsayılan, Yanlış değeridir. | 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ğ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 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 etkinlik benzersiz tanımlayıcısı. Bu kimlik, takvim sistemleri arasında etkinlikleri benzersiz olarak 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 şu kurallara uygun olmalıdır:
Bir kimlik belirtmezseniz sunucu tarafından otomatik olarak oluşturulur.
|
yazılabilir |
kind |
string |
Kaynağın türü ("calendar#event "). |
|
location |
string |
Etkinliğin serbest biçimli metin olarak 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ış değeridir. Salt okunur. | |
organizer |
object |
Etkinliği düzenleyen kullanıcı. Düzenleyen kullanıcı aynı zamanda bir katılımcıysa bu, attendees içinde organizer alanı Doğru değerine 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ılması hariç). |
yazılabilir |
organizer.displayName |
string |
Varsa düzenleyenin adı. | yazılabilir |
organizer.email |
string |
Varsa düzenleyenin e-posta adresi. RFC5322'ye göre 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üğü takvimle ilişkili olup olmadığı. Salt okunur. Varsayılan, Yanlış değeridir. | |
originalStartTime |
nested object |
Yinelenen bir etkinliğin örneği için bu, bu etkinliğin, reportingEventId tarafından tanımlanan yinelenen etkinlikteki tekrarlama verilerine göre başlayacağı zamandır. Farklı bir zamana taşınmış bile olsa yinelenen etkinlik serisindeki örneği benzersiz bir ş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 tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone ürününde saat dilimi açıkça belirtilmedikçe 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 etkinliğin başlangıç/bitişi 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 |
Ofis dışında etkinlikleri çakışan toplantı davetiyelerinin reddedilip reddedilmeyeceğini belirler. Geçerli değerler declineNone 'dir; 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 varken gelen yeni çakışan toplantı davetiyelerinin reddedileceği anlamına gelir. |
|
outOfOfficeProperties.declineMessage |
string |
Mevcut bir etkinliğin veya yeni bir davetiyenin Takvim tarafından otomatik olarak reddedilmesi durumunda kullanılacak yanıt iletisi. | |
privateCopy |
boolean |
Doğru değerine ayarlanırsa Etkinlik yayılımı devre dışı bırakılır. Bunun Gizli etkinlik özellikleri ile aynı şey olmadığını unutmayın. İsteğe bağlı. Sabit. Varsayılan, Yanlış değeridir. | |
recurrence[] |
list |
RFC5545'te belirtildiği şekilde, düzenli bir etkinliğin 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 |
Yinelenen 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 etkinliğe özel hatırlatıcılar listelenir. Etkinlik ayarlanmazsa bu etkinlik için herhangi bir hatırlatıcı ayarlanmadı demektir. En fazla 5 geçersiz kılma hatırlatıcısı kullanılabilir. | 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 kaç dakika önce hatırlatıcı tetikleneceğini belirtir. Geçerli değerler 0 ile 40.320 arasındadır (dakika cinsinden 4 hafta). 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 mesajı veya HTTP ya da HTTPS şemasına sahip bir URL ile 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ğı 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 tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone ürününde saat dilimi açıkça belirtilmedikçe 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 etkinliğin başlangıç/bitişi 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 engellemeyeceğini belirtir. İsteğe bağlı. Olası değerler:
|
yazılabilir |
updated |
datetime |
Etkinliğin son değiştirme zamanı (RFC3339 zaman damgası olarak). 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 |
Ek bilgi için isteğe bağlı fazladan 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ı 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ısı. | 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österilen ofis adı. Kuruluşun Kaynaklar veritabanında bir bina adına referans vermenizi öneririz. | yazılabilir |
workingLocationProperties.type |
string |
Çalışma yeri türü. Olası değerler:
Çalışma yeri mülkleri eklerken zorunludur. |
yazılabilir |
Yöntemler
- sil
- Bir etkinliği siler.
- al
- Google Takvim Kimliğine dayalı olarak bir etkinlik döndürür. iCalendar kimliğini kullanarak bir etkinliği 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 özel kopyasını takvime eklemek için kullanı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. bir 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;
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ı belirtilirse, mevcut dizilerin üzerine yazılır. Bu işlem, önceki dizi öğelerini siler. - quickAdd
- Basit bir metin dizesine dayalı etkinlik oluşturur.
- güncelleme
- 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 atomiklik sağlamak için etag'leri kullanarakupdate
işlemi gerçekleştirin. - saat
- Etkinlik kaynaklarında yapılan değişiklikleri takip edin.