Events

Calendar API, farklı etkinlik kaynağı türleri sunar. Daha fazla bilgiyi Etkinlikler hakkında bölümünde bulabilirsiniz.

Bu kaynakla ilgili 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
    }
  ],
  "birthdayProperties": {
    "contact": string,
    "type": string,
    "customTypeName": string
  },
  "eventType": string
}

Mülk adı	Değer	Açıklama	Notlar
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[]	list	Etkinliğin dosya ekleri Ekleri değiştirmek için supportsAttachments istek parametresi true olarak ayarlanmalıdır. Etkinlik başına en fazla 25 ek olabilir.
attachments[].fileId	string	Ekli dosyanın kimliği. Salt okunur. Google Drive dosyaları için bu, Drive API'deki ilgili Files kaynak girişinin kimliğidir.
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
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 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
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[].id	string	Katılımcının profil kimliği (varsa)
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[].organizer	boolean	Katılımcının etkinliğin düzenleyicisi olup olmadığı. Salt okunur. Varsayılan değer False'tur.
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. Uyarı: declined, tentative veya accepted değerlerini kullanarak etkinlik eklerseniz "Davetiyeleri takvimime ekle" ayarı "E-postadaki davetiyeyi yanıtladığımda" veya "Yalnızca gönderen biliniyorsa" olarak belirlenmiş katılımcıların yanıtı needsAction olarak sıfırlanabilir ve etkinlik davetiye e-postasındaki yanıtlarını değiştirmedikleri sürece takvimlerinde etkinlik görmezler. Ayrıca, etkinliğe 200'den fazla davetli gönderilirse yanıt durumu davetlilere iletilmez.	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 False'tur.
birthdayProperties	nested object	Doğum günü veya özel etkinlik verileri. eventType, "birthday" ise kullanılır. Değişmez.	yazılabilir
birthdayProperties.contact	string	Bu doğum günü etkinliğinin bağlı olduğu kişinin kaynak adı. Bu, People API'den kişi ayrıntılarını getirmek için kullanılabilir. Biçim: "people/c12345". Salt okunur.
birthdayProperties.customTypeName	string	Bu etkinlik için özel tür etiketi belirtildi. birthdayProperties.type, "custom" olarak ayarlanmışsa bu alan doldurulur. Salt okunur.
birthdayProperties.type	string	Doğum günü veya özel etkinlik türü. Olası değerler: "anniversary": Doğum günü dışındaki bir yıl dönümü. Her zaman contact vardır. "birthday": Doğum günü etkinliği. Bu, varsayılan değerdir. "custom" - Etiketi customTypeName alanında daha ayrıntılı olarak belirtilen özel bir tarih. Her zaman contact vardır. "other" - Diğer kategorilere uymayan ve özel etiketi olmayan özel bir tarih. Her zaman contact vardır. "self": Takvim sahibinin kendi doğum günü. contact olamaz. Calendar API yalnızca "birthday" türünde etkinlik oluşturmayı destekler. Etkinlik oluşturulduktan sonra türü değiştirilemez.	yazılabilir
colorId	string	Etkinliğin rengi. Bu, renk tanımının event bölümündeki bir girişi ifade eden kimliktir (bkz. renkler uç noktası). İsteğe bağlı.	yazılabilir
conferenceData	nested object	Konferansla ilgili bilgiler (ör. Google Meet konferansının ayrıntıları). Yeni konferans ayrıntıları oluşturmak için createRequest alanını kullanın. Değişikliklerinizin kalıcı olması için tüm etkinlik değişikliği isteklerinde conferenceDataVersion istek parametresini 1 olarak ayarlamayı unutmayın. Uyarı: Google Meet konferans verilerinin farklı etkinliklerde yeniden kullanılması, erişim sorunlarına neden olabilir ve toplantı ayrıntılarını istenmeyen kullanıcılara gösterebilir. Toplantı gizliliğini sağlamak için her etkinlikte createRequest alanını kullanarak her zaman benzersiz bir konferans oluşturun.	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: eventHangout: Kimlik ayarlanmamış. (Bu konferans türü kullanımdan kaldırılmıştır.) eventNamedHangout: ID, Hangout'un adıdır. (Bu konferans türü kullanımdan kaldırılmıştır.) hangoutsMeet: ID, 10 harfli toplantı kodudur (örneğin, aaa-bbbb-ccc). addOn: Kimlik, üçüncü taraf sağlayıcı tarafından tanımlanır. İsteğe bağlıdır.
conferenceData.conferenceSolution	nested object	Google Meet gibi konferans çözümü. Oluşturma isteği başarısız olan bir konferans için ayarlanmamış. conferenceSolution ve en az bir entryPoint ya da createRequest gereklidir.
conferenceData.conferenceSolution.iconUri	string	Bu çözüm için kullanıcı tarafından görülebilen simge.
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ü. Bir istemci, bilinmeyen veya boş bir türle karşılaşsa bile giriş noktalarını görüntüleyebilmelidir. Ancak değişikliklere izin verilmemelidir. Olası değerler: Tüketiciler için Hangouts (desteği sonlandırıldı; mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferanslar oluşturulamaz) için "eventHangout" Google Workspace kullanıcıları için klasik Hangouts'ta "eventNamedHangout" (desteği sonlandırıldı; mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferanslar oluşturulamaz) Google Meet (http://meet.google.com) için "hangoutsMeet" Üçüncü taraf konferans sağlayıcıları için "addOn"
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şturup 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. conferenceSolution ve en az bir entryPoint ya da createRequest gereklidir.
conferenceData.createRequest.conferenceSolutionKey	nested object	Konferans çözümü (ör. Hangouts veya Google Meet).
conferenceData.createRequest.conferenceSolutionKey.type	string	Konferans çözümü türü. Bir istemci, bilinmeyen veya boş bir türle karşılaşsa bile giriş noktalarını görüntüleyebilmelidir. Ancak değişikliklere izin verilmemelidir. Olası değerler: Tüketiciler için Hangouts (desteği sonlandırıldı; mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferanslar oluşturulamaz) için "eventHangout" Google Workspace kullanıcıları için klasik Hangouts'ta "eventNamedHangout" (desteği sonlandırıldı; mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferanslar oluşturulamaz) Google Meet (http://meet.google.com) için "hangoutsMeet" Üçüncü taraf konferans sağlayıcıları için "addOn"
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 istektekiyle 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: "pending": Konferans oluşturma isteği hâlâ işleniyor. "success": Konferans oluşturma isteği başarılı olduysa giriş noktaları doldurulur. "failure": Konferans oluşturma isteği başarısız oldu, giriş noktası yok.
conferenceData.entryPoints[]	list	URL'ler veya telefon numaraları gibi bireysel konferans giriş noktalarıyla ilgili bilgiler. Tümünün aynı konferansa ait olması gerekir. conferenceSolution ve en az bir entryPoint ya da createRequest gereklidir.
conferenceData.entryPoints[].accessCode	string	Konferansa erişmek için kullanılan erişim kodu. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının alt kümesini doldurun. Yalnızca doldurulmuş alanlar gösterilmelidir. İsteğe bağlı.
conferenceData.entryPoints[].entryPointType	string	Konferans giriş noktasının türü. Olası değerler: "video" - HTTP üzerinden konferansa katılma Bir konferansta sıfır veya bir video giriş noktası olabilir. "phone": Telefon numarası çevirerek konferansa katılma. Bir konferansta sıfır veya daha fazla phone giriş noktası olabilir. "sip" - SIP üzerinden konferansa katılma Bir konferansta sıfır veya bir sip giriş noktası olabilir. "more": Ek telefon numaraları gibi konferansa katılmayla ilgili diğer talimatlar. Bir konferansta sıfır veya bir more giriş noktası olabilir. Yalnızca more giriş noktası olan bir konferans geçerli bir konferans değildir.
conferenceData.entryPoints[].label	string	URI'nin etiketi. Son kullanıcılar tarafından görülebilir. Yerelleştirilmemiş. Maksimum uzunluk 512 karakterdir. Örnekler: için video: meet.google.com/aaa-bbbb-ccc phone için: [phone] for sip: [e-mail] more için: doldurulmamalıdır İ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ının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının alt kümesini doldurun. Yalnızca doldurulmuş alanlar gösterilmelidir. İ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ının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının alt kümesini doldurun. Yalnızca doldurulmuş alanlar gösterilmelidir.
conferenceData.entryPoints[].password	string	Konferansa erişmek için kullanılan şifre. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının alt kümesini doldurun. Yalnızca doldurulmuş alanlar gösterilmelidir. İsteğe bağlı.
conferenceData.entryPoints[].pin	string	Konferansa erişmek için PIN Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının alt kümesini doldurun. Yalnızca doldurulmuş alanlar gösterilmelidir. İsteğe bağlı.
conferenceData.entryPoints[].uri	string	Giriş noktasının URI'si. En çok 1.300 karakterden oluşabilir. Biçim: video, http: veya https: şeması gereklidir. phone için tel: şeması gereklidir. URI, tüm arama sırasını içermelidir (ör. tel:[phone],,,123456789;1234). için sip, sip: şeması gereklidir. Örneğin, sip:[e-mail]. more, http: veya https: şeması gereklidir.
conferenceData.notes	string	Kullanıcıya gösterilecek ek notlar (ör. alan yöneticisinin talimatları, yasal bildirimler). HTML içerebilir. En fazla 2.048 karakterden oluşabilir. İ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 ayarlanmamış. Oluşturma isteği bekleyen bir konferans 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 kişi. Salt okunur.
creator.displayName	string	Varsa içerik üreticinin adı.
creator.email	string	İçerik üreticinin e-posta adresi (varsa).
creator.id	string	İçerik üreticinin profil kimliği (varsa)
creator.self	boolean	Oluşturan kullanıcının, etkinliğin bu kopyasının göründüğü takvimle eşleşip eşleşmediği. Salt okunur. Varsayılan değer False'tur.
description	string	Etkinliğin açıklaması. HTML içerebilir. İsteğe bağlı.	yazılabilir
end	nested object	Etkinliğin bitiş zamanı (girilen tarihler dahil değil). Yinelenen etkinliklerde bu, ilk örneğin bitiş zamanıdır.
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
endTimeUnspecified	boolean	Bitiş zamanının gerçekten belirtilmemiş olup olmadığı. Bu öznitelik True olarak ayarlanmış olsa bile uyumluluk nedeniyle bir bitiş zamanı sağlanır. Varsayılan değer False'tur.
etag	etag	Kaynağın ETag'i.
eventType	string	Etkinliğin türü. Bu ayar, etkinlik oluşturulduktan sonra değiştirilemez. Olası değerler: "birthday": Yıllık olarak tekrarlanan, tüm gün süren özel bir etkinlik. "default": Normal bir etkinlik veya daha fazla belirtilmemiş. "focusTime": Odaklanma zamanı etkinliği. "fromGmail": Gmail'den alınan bir etkinlik. Bu tür etkinlikler oluşturulamaz. "outOfOffice": Ofis dışında etkinliği. "workingLocation": Çalışma yeri etkinliği.	yazılabilir
extendedProperties	object	Etkinliğin genişletilmiş özellikleri.
extendedProperties.private	object	Bu takvimde görünen etkinlik 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 özelliğin adı ve ilgili değer.
focusTimeProperties	nested object	Odaklanma zamanı etkinlik verileri. eventType, focusTime ise kullanılır.	yazılabilir
focusTimeProperties.autoDeclineMode	string	Odaklanma zamanı etkinlikleriyle çakışan toplantı davetiyelerinin reddedilip reddedilmeyeceği. Geçerli değerler şunlardır: declineNone (toplantı davetiyeleri reddedilmez), declineAllConflictingInvitations (etkinlikle çakışan tüm toplantı davetiyeleri reddedilir) ve declineOnlyNewConflictingInvitations (yalnızca odaklanma zamanı etkinliği sırasında gelen yeni ve çakışan toplantı davetiyeleri reddedilir).
focusTimeProperties.chatStatus	string	Kullanıcıyı Chat'te ve ilgili ürünlerde işaretlemek için kullanılan durum. Bu, available veya doNotDisturb olabilir.
focusTimeProperties.declineMessage	string	Mevcut bir etkinlik veya yeni davet Takvim tarafından otomatik olarak reddedilirse ayarlanacak yanıt mesajı.
gadget	object	Bu etkinliği genişleten bir gadget. Gadget'ler kullanımdan kaldırıldı. Bu yapı, bunun yerine yalnızca doğum günü takvimi meta verilerini döndürmek için kullanılır.
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.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'i tıklayın.	yazılabilir
gadget.preferences.(key)	string	Tercih adı ve karşılık gelen 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 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
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ğe giden mutlak bağlantı. Salt okunur.
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.
id	string	Etkinliğin opak tanımlayıcısı. Yeni tek seferlik veya yinelenen etkinlikler oluştururken bunların kimliklerini belirtebilirsiniz. Sağlanan kimlikler aşağıdaki kurallara uymalıdır: Kimlikte izin verilen karakterler, base32hex kodlamasında kullanılan karakterlerdir. Yani küçük harfler (a-v) ve rakamlar (0-9). RFC2938'deki 3.1.2 bölümüne bakın. Kimliğin uzunluğu 5 ile 1.024 karakter arasında olmalıdır. Kimlik, her takvim için benzersiz olmalıdır. Sistem, dünya genelinde dağıtılmış bir yapıya sahip olduğundan kimlik çakışmalarının etkinlik oluşturma sırasında tespit edileceğini garanti edemeyiz. Çakışma riskini en aza indirmek için RFC4122'de açıklanan gibi yerleşik bir UUID algoritması kullanmanızı öneririz. Bir kimlik belirtmezseniz sunucu tarafından otomatik olarak oluşturulur. icalUID ve id özelliklerinin aynı olmadığını ve etkinlik oluşturma sırasında yalnızca birinin sağlanması gerektiğini unutmayın. Semantiklerindeki bir fark, yinelenen etkinliklerde bir etkinliğin tüm oluşumlarının farklı id'lere sahip olması ancak hepsinin aynı icalUID'leri paylaşmasıdır.	yazılabilir
kind	string	Kaynağın türü ("calendar#event").
location	string	Etkinliğin coğrafi konumu (serbest biçimli metin olarak). İsteğe bağlı.	yazılabilir
locked	boolean	Bu, ana etkinlik alanları olan "özet", "açıklama", "konum", "başlangıç", "bitiş" veya "tekrarlama" üzerinde değişiklik yapılamayan kilitli bir etkinlik kopyası olup olmadığı. Varsayılan değer False'tur. Salt okunur.
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
organizer.id	string	Varsa düzenleyenin profil kimliği.
organizer.self	boolean	Düzenleyenin, etkinliğin bu kopyasının göründüğü takvimle eşleşip eşleşmediği. Salt okunur. Varsayılan değer False'tur.
originalStartTime	nested object	Yinelenen bir etkinliğin örneği için bu, recurringEventId ile tanımlanan yinelenen etkinlikteki yinelenme verilerine göre bu etkinliğin başlayacağı zamandır. Örnek farklı bir zamana taşınmış olsa bile, düzenli etkinlik serisindeki örneği benzersiz şekilde tanımlar. Değişmez.
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
outOfOfficeProperties.autoDeclineMode	string	Ofis dışında etkinlikleriyle çakışan toplantı davetiyelerinin reddedilip edilmeyeceği. Geçerli değerler şunlardır: declineNone (toplantı davetiyeleri reddedilmez), declineAllConflictingInvitations (etkinlikle çakışan tüm toplantı davetiyeleri reddedilir) ve declineOnlyNewConflictingInvitations (yalnızca ofis dışında etkinliği sırasında gelen yeni ve çakışan toplantı davetiyeleri reddedilir).
outOfOfficeProperties.declineMessage	string	Mevcut bir etkinlik veya yeni davet Takvim tarafından otomatik olarak reddedilirse ayarlanacak yanıt mesajı.
privateCopy	boolean	Doğru olarak 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ı. Değişmez. Varsayılan değer False'tur.
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
recurringEventId	string	Yinelenen bir etkinliğin örneği için bu, örneğin ait olduğu yinelenen etkinliğin id değeridir. Değişmez.
reminders	object	Kimliği doğrulanmış kullanıcı için etkinliğin hatırlatıcılarıyla ilgili bilgiler. Hatırlatıcıları değiştirmenin, kapsayan 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 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	object	Etkinliğin oluşturulduğu kaynak. Örneğin, bir web sayfası, bir e-posta mesajı veya HTTP ya da HTTPS şemasıyla URL'si tanımlanabilen herhangi bir doküman. Yalnızca etkinliği oluşturan kullanıcı tarafından görülebilir veya değiştirilebilir.
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	nested object	Etkinliğin başlangıç zamanı (girilen tarihler dahil). Yinelenen bir etkinlik için bu, ilk örneğin başlangıç zamanıdır.
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: İ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. 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
updated	datetime	Ana etkinlik verilerinin son değiştirilme zamanı (RFC3339 zaman damgası olarak). Etkinlik hatırlatıcılarını güncellemek bu durumu değiştirmez. Salt okunur.
visibility	string	Etkinliğin görünürlüğü. İsteğe bağlı. Olası değerler: "default": Takvimdeki etkinlikler için varsayılan görünürlüğü kullanır. Bu, varsayılan değerdir. "public": Etkinlik herkese açıktır ve etkinlik ayrıntıları takvimin tüm okuyucularına görünür. "private": Etkinlik özeldir ve etkinlik ayrıntılarını yalnızca etkinlik katılımcıları görüntüleyebilir. "confidential": Etkinlik gizlidir. Bu değer, uyumluluk nedeniyle sağlanır.	yazılabilir
workingLocationProperties	nested object	Çalışma yeri etkinlik verileri.	yazılabilir
workingLocationProperties.customLocation	object	Varsa kullanıcının özel bir konumdan çalıştığını belirtir.	yazılabilir
workingLocationProperties.customLocation.label	string	Ek bilgiler için isteğe bağlı bir ek etiket.	yazılabilir
workingLocationProperties.homeOffice	any value	Varsa kullanıcının evden çalıştığını belirtir.	yazılabilir
workingLocationProperties.officeLocation	object	Mevcutsa kullanıcının ofisten çalıştığını belirtir.	yazılabilir
workingLocationProperties.officeLocation.buildingId	string	İsteğe bağlı bina tanımlayıcısı. Bu, kuruluşun Kaynaklar veritabanındaki bir bina kimliğine referans vermelidir.	yazılabilir
workingLocationProperties.officeLocation.deskId	string	İsteğe bağlı masa tanımlayıcısı.	yazılabilir
workingLocationProperties.officeLocation.floorId	string	İsteğe bağlı bir kat tanımlayıcısı.	yazılabilir
workingLocationProperties.officeLocation.floorSectionId	string	İsteğe bağlı bir kat bölümü tanımlayıcısı.	yazılabilir
workingLocationProperties.officeLocation.label	string	Takvim'in web ve mobil istemcilerinde gösterilen ofis adı. Kuruluşun Kaynaklar veritabanında bir bina adına referans vermenizi öneririz.	yazılabilir
workingLocationProperties.type	string	Çalışma yerinin türü. Olası değerler: "homeOffice": Kullanıcı evden çalışıyor. "officeLocation": Kullanıcı ofisten çalışıyor. "customLocation": Kullanıcı özel bir konumdan çalışıyor. Ayrıntılar, belirtilen adın bir alt alanında belirtilir ancak boşsa bu alan eksik olabilir. Diğer tüm alanlar yoksayılır. Çalışma yeri özellikleri eklerken gereklidir.	yazılabilir

Yöntemler

sil

Bir etkinliği siler.

get

Google Takvim kimliğine göre bir etkinlik döndürür. Bir etkinliği iCalendar kimliğini kullanarak almak için events.list yöntemini iCalUID parametresiyle birlikte ç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. 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.

insert

Etkinlik oluşturur.

örnekler

Belirtilen düzenli etkinliğin örneklerini döndürür.

list

Belirtilen takvimdeki etkinlikleri döndürür.

move

Etkinliği başka bir takvime taşır (ör. etkinliğin düzenleyicisini değiştirir). Yalnızca default etkinliklerinin taşınabileceğini, birthday, focusTime, fromGmail, outOfOffice ve workingLocation etkinliklerinin taşınamayacağını unutmayın.

patch

Bir etkinliği günceller. Bu yöntem, yama semantiğini destekler. Her yama isteğinin üç kota birimi kullandığını unutmayın. get ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri, mevcut değerlerin yerini alır. İstek içinde belirtmediğiniz alanlar değişmeden kalır. Dizi alanları belirtilirse mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir.

quickAdd

Basit bir metin dizesine dayalı etkinlik oluşturur.

update

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 atomikliği sağlamak üzere etag'leri kullanarak get ve ardından update işlemi gerçekleştirin.

watch

Etkinlik kaynaklarında yapılan değişiklikleri izleyin.