Events

Calendar API, farklı türde etkinlik kaynakları sağlar. Daha fazla bilgiyi Etkinlikler hakkında başlıklı makalede bulabilirsiniz.

Bu kaynak için yöntemlerin listesi bu sayfanın sonuna verilmiştir.

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 kendilerini davet edip edemeyeceği (desteği sonlandırıldı). İsteğe bağlı. Varsayılan değer False'tır.	yazabilir
attachments[]	list	Etkinliğe ait 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 ekleri eklemek için Drive API'deki Files kaynağının alternateLink mülkünde kullanılan biçimi kullanın. Ek eklenirken gereklidir.	yazabilir
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 etkinlik temsilinden çıkarılmış olup olmadığı. Bir etkinlik alınırken bu durum, maxAttendee sorgu parametresi tarafından belirtilen bir kısıtlamadan kaynaklanabilir. Bir etkinliği güncellerken 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'tır.	yazabilir
attendees[]	list	Etkinliğin katılımcıları. Diğer takvim kullanıcılarıyla etkinlik planlama hakkında daha fazla bilgi için Katılımcı içeren etkinlikler kılavuzuna bakın. Hizmet hesaplarının katılımcı listesini doldurmak için alan genelinde yetki verme özelliğini kullanması gerekir.	yazabilir
attendees[].additionalGuests	integer	Ek konuk sayısı. İsteğe bağlı. Varsayılan değer 0'dır.	yazabilir
attendees[].comment	string	Katılımcının yanıt yorumu. İsteğe bağlı.	yazabilir
attendees[].displayName	string	Varsa katılımcının adı. İsteğe bağlı.	yazabilir
attendees[].email	string	Katılımcıya ait e-posta adresi (varsa). Katılımcı eklerken bu alan mevcut olmalıdır. Bu, RFC5322'ye göre geçerli bir e-posta adresi olmalıdır. Katılımcı eklerken gerekir.	yazabilir
attendees[].id	string	Katılımcıya ait 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'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 False'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 False'tır.	yazabilir
attendees[].responseStatus	string	Katılımcıya ait yanıt durumu. Olası değerler: "needsAction": Katılımcı davetiyeye yanıt vermedi (yeni etkinlikler için önerilir). "declined": Katılımcı davetiyeyi reddetmiştir. "tentative": Katılımcı, daveti geçici olarak kabul etti. "accepted" - Katılımcı davetiyeyi kabul etti. Uyarı: declined, tentative veya accepted değerlerini kullanarak etkinlik eklerseniz "Davetiyeleri takvimime ekle" ayarı "Davetiyeyi e-postada yanıtladığımda" veya "Yalnızca gönderen biliniyorsa" olarak ayarlanmış olan katılımcıların yanıtı needsAction olarak sıfırlanabilir ve etkinlik daveti e-postasındaki yanıtlarını değiştirmedikleri sürece takvimlerinde etkinlik görmezler. Ayrıca etkinliğe 200'den fazla davetli davet edilirse yanıt durumu davetlilere iletilmez.	yazabilir
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'tır.
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 iletişim bilgilerini almak için kullanılabilir. Biçim: "people/c12345". Salt okunur.
birthdayProperties.customTypeName	string	Bu etkinlik için belirtilen özel tür etiketi. 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ışında bir yıl dönümü. Her zaman bir contact içerir. "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 bir contact içerir. "other" - Diğer kategorilere girmeyen ve özel bir etikete sahip olmayan özel bir tarih. Her zaman bir contact içerir. "self": Takvim sahibinin doğum günü. contact sahibi olamaz. Calendar API yalnızca "birthday" türünde etkinlik oluşturmayı destekler. Tür, etkinlik oluşturulduktan sonra değiştirilemez.	yazabilir
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ı.	yazabilir
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şikliklerinizin kalıcı olması için tüm etkinlik değiştirme isteklerinde conferenceDataVersion istek parametresini 1 olarak ayarlamayı unutmayın.	yazabilir
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ıldı.) eventNamedHangout: Kimlik, Hangout'un adıdır. (Bu konferans türü için destek sonlandırılmıştır.) hangoutsMeet: Kimlik, 10 harfli toplantı kodudur (ör. aaa-bbbb-ccc). addOn: Kimlik, üçüncü taraf sağlayıcı tarafından tanımlanır. İsteğe bağlı.
conferenceData.conferenceSolution	nested object	Google Meet gibi konferans çözümü. Oluşturma isteği başarısız olan bir konferansın ayarını kaldırın. conferenceSolution ve en az bir entryPoint veya createRequest gereklidir.
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ü. Bir istemci, bilmediği 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'ta "eventHangout" (desteği sonlandırıldı; mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferanslar oluşturulamaz) 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ştirilmedi.
conferenceData.createRequest	nested object	Yeni bir 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. conferenceSolution ve en az bir entryPoint veya createRequest gereklidir.
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, bilmediği 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'ta "eventHangout" (desteği sonlandırıldı; mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferanslar oluşturulamaz) 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 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: "pending": Konferans oluşturma isteği işlenmeye devam ediyor. "success": Toplantı oluşturma isteği başarılı oldu, giriş noktaları dolduruldu. "failure": Konferans oluşturma isteği başarısız oldu, giriş noktası yok.
conferenceData.entryPoints[]	list	URL'ler veya telefon numaraları gibi tekil konferans giriş noktalarıyla ilgili bilgiler. Tüm kullanıcılar aynı konferansa üye olmalıdır. conferenceSolution ve en az bir entryPoint veya createRequest gereklidir.
conferenceData.entryPoints[].accessCode	string	Konferansa erişmek için kullanılacak erişim kodu. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca {meetingCode, accessCode, passcode, password, pin} alanlarının konferans sağlayıcının kullandığı terminolojiyle eşleşen alt kümesini doldurun. Yalnızca doldurulan alanlar gösterilmelidir. İsteğe bağlı.
conferenceData.entryPoints[].entryPointType	string	Konferans giriş noktasının türü. Olası değerler: "video": HTTP üzerinden bir 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 bir konferansa katılıyorsunuz. Bir konferansta sıfır veya bir sip giriş noktası olabilir. "more": Konferansa katılmayla ilgili diğer talimatlar (ör. ek telefon numaraları). Bir konferansta sıfır veya bir more giriş noktası olabilir. Yalnızca more giriş noktası olan konferanslar geçerli değildir.
conferenceData.entryPoints[].label	string	URI'nin etiketi. Son kullanıcılar tarafından görülebilir. Yerelleştirilmedi. Maksimum uzunluk 512 karakterdir. Örnekler: video için: meet.google.com/aaa-bbbb-ccc phone için: [phone] sip için: [e-mail] more için: doldurulmamalıdır İsteğe bağlı.
conferenceData.entryPoints[].meetingCode	string	Konferansa erişmek için gereken toplantı kodu. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca {meetingCode, accessCode, passcode, password, pin} alanlarının konferans sağlayıcının kullandığı terminolojiyle eşleşen alt kümesini doldurun. Yalnızca doldurulan 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 {meetingCode, accessCode, passcode, password, pin} alanlarının konferans sağlayıcının kullandığı terminolojiyle eşleşen alt kümesini doldurun. Yalnızca doldurulan alanlar gösterilmelidir.
conferenceData.entryPoints[].password	string	Konferansa erişmek için gereken şifre. En çok 128 karakter kullanılabilir. Yeni konferans verileri oluştururken yalnızca {meetingCode, accessCode, passcode, password, pin} alanlarının konferans sağlayıcının kullandığı terminolojiyle eşleşen alt kümesini doldurun. Yalnızca doldurulan alanlar gösterilmelidir. İ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 {meetingCode, accessCode, passcode, password, pin} alanlarının konferans sağlayıcının kullandığı terminolojiyle eşleşen alt kümesini doldurun. Yalnızca doldurulan alanlar gösterilmelidir. İsteğe bağlı.
conferenceData.entryPoints[].uri	string	Giriş noktasının URI'sı. Maksimum uzunluk 1.300 karakterdir. Biçim: video, http: veya https: için şema gereklidir. phone için tel: şeması gereklidir. URI, arama sırasının tamamını içermelidir (ör. tel:[phone],,,123456789;1234). sip için sip: şeması gerekiyor, ör. sip:12345678@sağlayıcım.com. more, http: veya https: için şema gereklidir.
conferenceData.notes	string	Kullanıcıya gösterilecek ek notlar (alan yöneticisinin talimatları, yasal uyarılar gibi). HTML içerebilir. Maksimum uzunluk 2.048 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ılır. Beklemedeki bir 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	İçerik üreticinin e-posta adresi (varsa).
creator.id	string	İçerik üreticinin profil kimliği (varsa).
creator.self	boolean	Oluşturucunun, etkinliğin bu kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunur. Varsayılan değer False'tır.
description	string	Etkinliğin açıklaması. HTML içerebilir. İsteğe bağlı.	yazabilir
end	nested object	Etkinliğin bitiş zamanı (hariç). Düzenli bir etkinlik için bu, ilk etkinliğin bitiş zamanıdır.
end.date	date	Tüm gün süren bir etkinlikse "yyyy-aa-gg" biçiminde tarih.	yazabilir
end.dateTime	datetime	Birleştirilmiş tarih ve saat değeri olarak zaman (RFC3339'a göre biçimlendirilir). timeZone içinde bir 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çimlendirilmiştir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek seferlik etkinlikler için isteğe bağlı olan bu alan, etkinliğin başlangıç/bitiş saati dilimiyle ilgili özel bir saat dilimi belirtir.	yazabilir
endTimeUnspecified	boolean	Bitiş zamanının gerçekten belirtilmemiş olup olmadığı. Bu özellik True olarak ayarlanmış olsa bile uyumluluk nedeniyle bir bitiş zamanı sağlanır. Varsayılan değer False'tır.
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 bir etkinlik. Bu tür bir etkinlik oluşturulamaz. "outOfOffice": Ofis dışında etkinliği. "workingLocation": Çalışma yeri etkinliği.	yazabilir
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 karşılık gelen değer.
extendedProperties.shared	object	Diğer katılımcıların takvimlerindeki etkinlik kopyaları arasında paylaşılan özellikler.	yazabilir
extendedProperties.shared.(key)	string	Paylaşılan özelliğin adı ve karşılık gelen değer.
focusTimeProperties	nested object	Odaklanma zamanı etkinliği 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 declineNone (toplantı davetiyelerinin hiçbiri reddedilmeyecek), declineAllConflictingInvitations (etkinlikle çakışan tüm toplantı davetiyeleri reddedilecek) ve declineOnlyNewConflictingInvitations (yalnızca odaklanma zamanı etkinliği mevcutken gelen yeni çakışan toplantı davetiyeleri reddedilecek) şeklindedir.
focusTimeProperties.chatStatus	string	Kullanıcının Chat'te ve ilgili ürünlerde işaretleneceği durum. Bu değer 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. Cihazların desteği sonlandırıldı. Bu yapı artık 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: "icon" - Gadget, takvim görünümünde etkinlik başlığının yanında görüntülenir. "chip": Cihaz, etkinlik tıklandığında gösterilir.	yazabilir
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	Aygıtın simge URL'si. URL şeması HTTPS olmalıdır. Kullanımdan kaldırıldı.	yazılabilir
gadget.link	string	Cihazın URL'si. URL şeması HTTPS olmalıdır. Kullanımdan kaldırıldı.	yazabilir
gadget.preferences	object	Tercihler'i tıklayın.	yazabilir
gadget.preferences.(key)	string	Tercih adı ve ilgili değer.
gadget.title	string	Gadget'ın başlığı. Kullanımdan kaldırıldı.	yazabilir
gadget.type	string	Cihazın türü. Kullanımdan kaldırıldı.	yazabilir
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ı.	yazabilir
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.	yazabilir
guestsCanModify	boolean	Düzenleyen 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'tır.	yazabilir
guestsCanSeeOtherGuests	boolean	Düzenleyen dışındaki katılımcıların, etkinliğin katılımcılarını görüp göremeyeceği. İsteğe bağlı. Varsayılan değer, Doğru'dur.	yazabilir
hangoutLink	string	Bu etkinlikle ilişkili Google Hangouts'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ığı şekilde etkinlik benzersiz tanımlayıcısı. Takvim sistemlerindeki etkinlikleri benzersiz bir ş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 değerlerinin aynı olmadığını ve etkinlik oluşturma sırasında bunlardan yalnızca birinin sağlanması gerektiğini unutmayın. Bu iki öğenin anlamındaki bir fark, yinelenen etkinliklerde bir etkinliğin tüm gerçekleşmelerinin farklı id değerlerine sahip olması, ancak aynı iCalUID değerlerini paylaşmasıdır. Bir etkinliği iCalUID parametresini kullanarak almak için iCalUID parametresini kullanarak events.list yöntemini ç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 tekli veya düzenli etkinlikler oluştururken bunların kimliklerini belirtebilirsiniz. Sağlanan kimlikler şu kurallara uygun olmalıdır: kimlikte izin verilen karakterler, base32hex kodlamasında kullanılan karakterlerdir (ör. a-v arasındaki küçük harfler ve 0-9 arasındaki rakamlar). RFC2938'deki 3.1.2 bölümüne bakın. Kimliğin uzunluğu 5 ile 1024 karakter arasında olmalıdır. Kimlik, her takvim için benzersiz olmalıdır. Sistemin dünya genelinde dağıtılmış yapısı nedeniyle, 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. Kimlik belirtmezseniz kimlik sunucu tarafından otomatik olarak oluşturulur. icalUID ve id değerlerinin aynı olmadığını ve etkinlik oluşturma sırasında bunlardan yalnızca birinin sağlanması gerektiğini unutmayın. Bu iki öğenin anlamındaki bir fark, yinelenen etkinliklerde bir etkinliğin tüm örneklerinin farklı id değerlerine sahip olması, ancak aynı icalUID değerlerini paylaşmasıdır.	yazabilir
kind	string	Kaynağın türü ("calendar#event").
location	string	Serbest biçimli metin olarak etkinliğin coğrafi konumu. İsteğe bağlı.	yazabilir
locked	boolean	Bunun "summary", "description", "location", "start", "end" veya "recurrence" ana etkinlik alanlarında hiçbir değişiklik yapılamayan kilitli bir etkinlik kopyası olup olmadığı. Varsayılan değer False'tır. Salt okunur.
organizer	object	Etkinliği düzenleyen kullanıcı. Düzenleyici aynı zamanda katılımcıysa bu durum, attendees alanında organizer alanının True olarak ayarlandığı ayrı bir girişle gösterilir. Düzenleyeni değiştirmek için taşıma işlemini kullanın. Bir etkinliği içe aktarma işlemi hariç, salt okunurdur.	yazabilir
organizer.displayName	string	Varsa düzenleyen kişinin adı.	yazabilir
organizer.email	string	Düzenleyen kullanıcının e-posta adresi (varsa). RFC5322 uyarınca geçerli bir e-posta adresi olmalıdır.	yazabilir
organizer.id	string	Düzenleyenin profil kimliği (varsa).
organizer.self	boolean	Düzenleyicinin, etkinliğin bu kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunur. Varsayılan değer False'tır.
originalStartTime	nested object	Düzenli etkinlik örneği için bu, recurringEventId ile tanımlanan düzenli etkinlikteki yinelenme verilerine göre bu etkinliğin başlayacağı saattir. Örnek farklı bir zamana taşınmış olsa bile yinelenen etkinlik serisindeki örneği benzersiz şekilde tanımlar. Sabit.
originalStartTime.date	date	Tüm gün süren bir etkinlikse "yyyy-aa-gg" biçiminde tarih.	yazabilir
originalStartTime.dateTime	datetime	Birleştirilmiş tarih ve saat değeri olarak zaman (RFC3339'a göre biçimlendirilir). timeZone içinde bir 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çimlendirilmiştir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek seferlik etkinlikler için isteğe bağlı olan bu alan, etkinliğin başlangıç/bitiş saati dilimiyle ilgili özel bir saat dilimi belirtir.	yazabilir
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ği. Geçerli değerler declineNone (Toplantı daveti reddedilmez), declineAllConflictingInvitations (Etkinlikle çakışan tüm toplantı davetleri reddedilir) ve declineOnlyNewConflictingInvitations (Yalnızca ofis dışında etkinliği mevcutken gelen yeni çakışan toplantı davetleri reddedilir) şeklindedir.
outOfOfficeProperties.declineMessage	string	Mevcut bir etkinlik veya yeni davet Takvim tarafından otomatik olarak reddedilirse ayarlanacak yanıt mesajı.
privateCopy	boolean	Doğru değerine ayarlanırsa Etkinlik yayma 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, 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. Etkinliğin başlangıç ve bitiş zamanları start ve end alanlarında belirtilir. Bu alan, tek etkinlikler veya yinelenen etkinlik örnekleri için çıkarılır.	yazabilir
recurringEventId	string	Düzenli bir etkinliğin örneği için bu, örneğin ait olduğu düzenli etkinliğin id değeridir. Değişmez.
reminders	object	Kimliği doğrulanmış kullanıcı için etkinliğin hatırlatıcıları hakkında bilgi. Hatırlatıcıların değiştirilmesinin, kapsayıcı 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 bu alan, etkinliğe özgü hatırlatıcıları listeler veya ayarlanmamışsa bu etkinlik için hatırlatıcı ayarlanmadığını gösterir. Geçersiz kılma hatırlatıcısı sayısı en fazla 5 olabilir.	yazabilir
reminders.overrides[].method	string	Bu hatırlatıcının kullandığı yöntem. Olası değerler: "email": Hatırlatmalar e-postayla gönderilir. "popup": Hatırlatıcılar, kullanıcı arayüzü pop-up'ı aracılığıyla gönderilir. Hatırlatıcı eklerken gereklidir.	yazabilir
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 (dakikada 4 hafta) arasındadır. Hatırlatıcı eklerken gereklidir.	yazabilir
reminders.useDefault	boolean	Takvimdeki varsayılan hatırlatıcıların etkinlik için geçerli olup olmadığı.	yazabilir
sequence	integer	iCalendar'a göre sıra numarası.	yazabilir
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ı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. bir web sayfasının başlığı veya e-posta konusu).	yazabilir
source.url	string	Bir kaynağı işaret eden kaynağın URL'si. URL şeması HTTP veya HTTPS olmalıdır.	yazabilir
start	nested object	Etkinliğin (dahil) başlangıç saati. 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 "yyyy-aa-gg" biçiminde tarih.	yazabilir
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	Zamanın belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilmiştir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek seferlik etkinlikler için isteğe bağlı olan bu alan, etkinliğin başlangıç/bitiş saati dilimiyle ilgili özel bir saat dilimi belirtir.	yazabilir
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şaretçisi true olarak ayarlandığında döndürür. get yöntemi her zaman bu değerleri döndürür. İptal edilmiş durum, etkinlik türüne bağlı olarak iki farklı durumu temsil eder: İptal edilmemiş yinelenen bir etkinliğin iptal edilen istisnaları, bu örneğin artık kullanıcıya sunulmaması gerektiğini gösterir. Müşteriler bu etkinlikleri, üst düzenli etkinliğin süresi boyunca depolamalıdır. İptal edilen istisnalarda yalnızca id, recurringEventId ve originalStartTime alanlarının doldurulduğu garanti edilir. Diğer alanlar boş olabilir. İptal edilen diğer tüm etkinlikler, silinen etkinlikleri temsil eder. Müşteriler yerel olarak senkronize edilmiş kopyalarını kaldırmalıdır. İptal edilen bu tür etkinlikler zaman içinde kaybolacağından süresiz olarak kullanılabilir olacaklarına güvenmeyin. Silinen etkinlikler için yalnızca id alanının doldurulacağı garanti edilir. Etkinliği düzenleyenin takviminde, iptal edilen etkinliklerin ayrıntıları (özet, konum vb.) gösterilmeye devam eder. Böylece bu ayrıntılar geri yüklenebilir. Benzer şekilde, kullanıcının davet edildiği ve manuel olarak kaldırdığı etkinliklerin ayrıntıları da gösterilmeye devam eder. Ancak showDeleted yanlış olarak ayarlanmış artımlı senkronizasyon istekleri bu ayrıntıları döndürmez. Bir etkinliğin düzenleyeni değişirse (ör. taşıma işlemiyle) ve orijinal düzenleyen katılımcı listesinde yoksa yalnızca id alanının doldurulacağı garanti edilen iptal edilmiş bir etkinlik bırakılır.	yazabilir
summary	string	Etkinliğin adı.	yazabilir
transparency	string	Etkinliğin takvimde zaman ayırıp ayırmadığını belirtir. İsteğe bağlı. Olası değerler: "opaque": Varsayılan değer. Etkinlik, takvimde zamanı engeller. Bu, Takvim kullanıcı arayüzünde Bana gösterilen durum'u Meşgul olarak ayarlamaya eşdeğerdir. "transparent": Etkinlik, takvimde zamanı engellemez. Bu, Takvim kullanıcı arayüzünde Beni şu şekilde göster'i Müsait olarak ayarlamaya eşdeğerdir.	yazabilir
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ı takvimi okuyan herkes tarafından görülebilir. "private": Etkinlik gizlidir ve yalnızca etkinlik katılımcıları etkinlik ayrıntılarını görüntüleyebilir. "confidential" - Etkinlik gizli. Bu değer, uyumluluk nedeniyle sağlanmıştır.	yazabilir
workingLocationProperties	nested object	Çalışma yeri etkinlik verileri.	yazabilir
workingLocationProperties.customLocation	object	Varsa kullanıcının özel bir konumdan çalıştığını belirtir.	yazabilir
workingLocationProperties.customLocation.label	string	Ek bilgi için isteğe bağlı ek etiket.	yazabilir
workingLocationProperties.homeOffice	any value	Varsa kullanıcının evde çalıştığını belirtir.	yazabilir
workingLocationProperties.officeLocation	object	Mevcut olduğunda, kullanıcının ofisten çalıştığını belirtir.	yazabilir
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 müşteri temsilcisi tanımlayıcısı.	yazabilir
workingLocationProperties.officeLocation.floorId	string	İsteğe bağlı kat tanımlayıcısı.	yazılabilir
workingLocationProperties.officeLocation.floorSectionId	string	İsteğe bağlı bir kat bölümü tanımlayıcısı.	yazabilir
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.	yazabilir
workingLocationProperties.type	string	Çalışma yerinin türü. Olası değerler: "homeOffice": Kullanıcı evde çalışıyor. "officeLocation" - Kullanıcı bir ofisten çalışıyor. "customLocation" - Kullanıcı, özel bir konumdan çalışıyor. Tüm ayrıntılar, belirtilen adın alt alanında belirtilir ancak boşsa bu alan eksik olabilir. Diğer alanlar yoksayılır. Çalışma yeri özellikleri eklenirken gereklidir.	yazabilir

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 iCalUID parametresini kullanarak events.list yöntemini çağırın.

import

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

Desteği sonlandırılan 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 kaldırılır.

ekle

Etkinlik oluşturur.

instances

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

list

Belirtilen takvimdeki etkinlikleri döndürür.

move

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, birthday, focusTime, fromGmail, outOfOffice ve workingLocation etkinliklerinin taşınamayacağını unutmayın.

yama

Bir etkinliği günceller. Bu yöntem, yama semantiklerini destekler. Her yama isteğinin üç kota birimi tükettiğini unutmayın; get ve ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri, mevcut değerlerin yerini alır. İstekte belirtmediğiniz alanlar aynı kalır. Dizi alanları, belirtilirse mevcut dizilerin üzerine yazılır. Bu işlem, önceki dizi öğelerini siler.

quickAdd

Basit bir metin dizesine dayalı bir etkinlik oluşturur.

update

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 atomikliği sağlamak amacıyla etags kullanarak get ve ardından update gerçekleştirin.

watch

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