Events

Calendar API, farklı türde etkinlik kaynakları sağlar. Daha fazla bilgi için Etkinlikler hakkında başlıklı makaleyi inceleyin.

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
    }
  ],
  "eventType": string
}

Mülk adı	Değer	Açıklama	Notlar
anyoneCanAddSelf	boolean	Herkesin kendisini etkinliğe davet edip edemeyeceği (desteği sonlandırılmış). İsteğe bağlı. Varsayılan değer, Yanlış'tır.	yazılabilir
attachments[]	list	Etkinlikle ilgili dosya ekleri. Eklerde değişiklik yapabilmek için supportsAttachments istek parametresi true olarak ayarlanmalıdır. Etkinlik başına en fazla 25 ek olabilir.
attachments[].fileId	string	Eklenen dosyanın kimliği. Salt okunur. Google Drive dosyaları için bu, Drive API'deki karşılık gelen 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 özelliğinde belirtilen biçimi kullanın. Ek iliştirilirken gereklidir.	yazılabilir
attachments[].iconLink	string	Ekin simgesinin URL bağlantısı. Bu alan yalnızca özel üçüncü taraf ekleri için değiştirilebilir.
attachments[].mimeType	string	Ekin internet medya türü (MIME türü).
attachments[].title	string	Ek başlığı.
attendeesOmitted	boolean	Katılımcıların etkinliğin temsilinden çıkarılıp çıkarılmadığı. Bir etkinlik alınırken bunun nedeni maxAttendee sorgu parametresi tarafından belirtilen bir kısıtlama olabilir. Bir 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, Yanlış'tır.	yazılabilir
attendees[]	list	Etkinliğin katılımcıları. Diğer takvim kullanıcılarıyla etkinlik planlama hakkında daha fazla bilgi edinmek için Katılımcılı etkinlikler kılavuzuna göz atın. Katılımcı listesini doldurmak için hizmet hesaplarının alan genelinde yetki yetkisini kullanması gerekir.	yazılabilir
attendees[].additionalGuests	integer	Ek konuk sayısı. İsteğe bağlı. Varsayılan değer 0'dır.	yazılabilir
attendees[].comment	string	Katılımcının yanıt yorumu. İsteğe bağlı.	yazabilir
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. Bu, RFC5322'ye göre geçerli bir e-posta adresi olmalıdır. Katılımcı eklerken gerekir.	yazılabilir
attendees[].id	string	Varsa katılımcının profil kimliği.
attendees[].optional	boolean	Bunun isteğe bağlı bir katılımcı olup olmadığı bilgisi. İsteğe bağlı. Varsayılan değer, Yanlış'tır.	yazılabilir
attendees[].organizer	boolean	Katılımcının etkinliği düzenleyen kişi olup olmadığı. Salt okunur. Varsayılan değer 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, Yanlış'tır.	yazılabilir
attendees[].responseStatus	string	Katılımcının yanıt durumu. Olası değerler: "needsAction" - Katılımcı davetiyeye yanıt vermemiştir (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 etmiştir. Uyarı: declined, tentative veya accepted değerlerini kullanarak bir etkinlik eklerseniz "Davetiyeleri takvimime ekle" bilgisi olan katılımcılar ayar "E-postadaki davetiyeyi yanıtladığımda" olarak belirlendi veya "Yalnızca gönderen biliniyorsa" yanıtı needsAction olarak sıfırlanabilir ve etkinlik davetiyesi e-postasındaki yanıtını değiştirmediği sürece takvimlerinde herhangi bir etkinlik görmez. Ayrıca etkinliğe 200'den fazla kişi 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, Yanlış'tır.
colorId	string	Etkinliğin rengi. Bu, renk tanımının event bölümündeki bir girişi ifade eden bir kimliktir ( renkler uç noktasına bakın). İsteğe bağlı.	yazılabilir
conferenceData	nested object	Google Meet konferansının ayrıntıları gibi konferansla ilgili bilgiler. Yeni konferans ayrıntıları oluşturmak için createRequest alanını kullanın. Değişikliklerinizi sürdürmek istiyorsanız tüm etkinlik değiştirme isteklerinde conferenceDataVersion istek parametresini 1 olarak ayarlamayı unutmayın.	yazılabilir
conferenceData.conferenceId	string	Konferansın kimliği. Geliştiriciler tarafından konferansları takip etmek için kullanılabilir. Kullanıcılara gösterilmemelidir. Kimlik değeri, her konferans çözümü türü için farklı şekilde oluşturulur: eventHangout: Kimlik ayarlanmamış. (Bu konferans türü kullanımdan kaldırıldı.) eventNamedHangout: Kimlik, Hangout'un adıdır. (Bu konferans türü kullanımdan kaldırıldı.) 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ıdır.
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ılır. conferenceSolution ve en az bir entryPoint veya createRequest gereklidir.
conferenceData.conferenceSolution.iconUri	string	Bu çözüm için kullanıcıların görebileceği simge.
conferenceData.conferenceSolution.key	nested object	Bu etkinlik için konferans çözümünü benzersiz şekilde tanımlayabilecek anahtar.
conferenceData.conferenceSolution.key.type	string	Konferans çözümü türü. Bir istemci bilinmeyen veya boş türle karşılaşırsa yine de giriş noktalarını görüntüleyebilmelidir. Ancak, değişikliklere izin verilmemelidir. Olası değerler şunlardır: 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 için klasik Hangouts kullanıcıları için "eventNamedHangout" (desteği sonlandırılmış. Mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferans oluşturulamaz) Google Meet için "hangoutsMeet" (http://meet.google.com) Üçü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 bunu etkinliğe ekleme isteği. Veriler eşzamansız olarak oluşturulur. Verilerin mevcut olup olmadığını görmek için status alanını kontrol edin. 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 bilinmeyen veya boş türle karşılaşırsa yine de giriş noktalarını görüntüleyebilmelidir. Ancak, değişikliklere izin verilmemelidir. Olası değerler şunlardır: 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 için klasik Hangouts kullanıcıları için "eventNamedHangout" (desteği sonlandırılmış. Mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferans oluşturulamaz) Google Meet için "hangoutsMeet" (http://meet.google.com) Üçü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 şunlardır: "pending": Konferans oluşturma isteği işlenmeye devam ediyor. "success": Konferans 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	Bağımsız konferans giriş noktalarıyla ilgili bilgiler (ör. URL'ler veya telefon numaraları) Hepsi aynı konferansa ait 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 konferans sağlayıcısının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının alt kümesini doldurun. Yalnızca doldurulan alanlar görüntülenmelidir. İsteğe bağlı.
conferenceData.entryPoints[].entryPointType	string	Konferans giriş noktasının türü. Olası değerler: "video" - HTTP üzerinden bir konferansa katılıyorsunuz. Bir konferansın sıfır veya bir video giriş noktası olabilir. "phone" - telefon numarasını çevirerek konferansa katılıyorsunuz. Bir konferansta sıfır veya daha fazla phone giriş noktası olabilir. "sip" - SIP üzerinden bir konferansa katılıyorsunuz. Bir konferansın sıfır veya bir sip giriş noktası olabilir. "more": Diğer konferansa katılma talimatları, örneğin ek telefon numaraları. Bir konferansın 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'nın etiketi. Son kullanıcılar görebilir. Yerelleştirilmedi. En çok 512 karakter kullanılabilir. Ö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 kullanılacak toplantı kodu. En çok 128 karakter kullanılabilir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının alt kümesini doldurun. Yalnızca doldurulan alanlar görüntülenmelidir. İsteğe bağlı.
conferenceData.entryPoints[].passcode	string	Konferansa erişmek için kullanılan şifre kodu. En çok 128 karakter kullanılabilir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının alt kümesini doldurun. Yalnızca doldurulan alanlar görüntülenmelidir.
conferenceData.entryPoints[].password	string	Konferansa erişmek için kullanılan şifre. En çok 128 karakter kullanılabilir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının alt kümesini doldurun. Yalnızca doldurulan alanlar görüntülenmelidir. İsteğe bağlı.
conferenceData.entryPoints[].pin	string	Konferansa erişmek için kullanılacak PIN. En çok 128 karakter kullanılabilir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının alt kümesini doldurun. Yalnızca doldurulan alanlar görüntülenmelidir. İsteğe bağlı.
conferenceData.entryPoints[].uri	string	Giriş noktasının URI'sı. En çok 1.300 karakter kullanılabilir. Biçim: video, http: veya https: şeması için gereklidir. phone için tel: şeması gerekiyor. 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: şeması için gereklidir.
conferenceData.notes	string	Kullanıcıya gösterilecek ek notlar (alan yöneticisinin talimatları, yasal uyarılar gibi). HTML içerebilir. En çok 2.048 karakter kullanılabilir. İsteğe bağlı.
conferenceData.signature	string	Konferans verilerinin imzası. Sunucu tarafında oluşturulur. Oluşturma isteği başarısız olan bir konferansın ayarını kaldırın. Bekleyen oluşturma isteği olan konferanslarda isteğe bağlıdır.
created	datetime	Etkinliğin oluşturulma zamanı (RFC3339 zaman damgası olarak). Salt okunur.
creator	object	Etkinliği oluşturan kullanıcı. Salt okunur.
creator.displayName	string	Varsa içerik üreticinin adı.
creator.email	string	Varsa içerik üreticinin e-posta adresi
creator.id	string	Oluşturanın profil kimliği (varsa).
creator.self	boolean	İçerik üreticinin etkinlik kopyasının göründüğü takvimle uyumlu olup olmadığı. Salt okunur. Varsayılan değer False'tır.
description	string	Etkinliğin açıklaması. HTML içerebilir. İsteğe bağlı.	yazılabilir
end	nested object	Etkinliğin (özel) bitiş zamanı. Düzenli bir etkinlik için bu, ilk örneğin bitiş zamanıdır.
end.date	date	Tüm gün süren bir etkinlikse "yyyy-aa-gg" biçiminde tarih.	yazılabilir
end.dateTime	datetime	Birleştirilmiş tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone içinde bir saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir.	yazılabilir
end.timeZone	string	Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilmiştir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan gereklidir ve yinelenmenin genişletildiği saat dilimini belirtir. Tek bir etkinlik için bu alan isteğe bağlıdır ve etkinliğin başlangıcı/bitişi için özel bir saat dilimi belirtir.	yazabilir
endTimeUnspecified	boolean	Bitiş zamanının gerçekten belirtilmemiş olup olmadığı. Bu özellik Doğru olarak ayarlanmış olsa bile uyumluluk nedeniyle bitiş zamanı sağlanır. Varsayılan değer, Yanlış'tır.
etag	etag	Kaynağın eTag'i.
eventType	string	Etkinliğin türü. Etkinlik oluşturulduktan sonra bu ayar değiştirilemez. Olası değerler: "birthday" - Her yıl tekrarlanan, tüm gün süren özel bir etkinlik. "default" - Düzenli 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 gerçekleşen bir etkinlik. "workingLocation" - Çalışma yeri etkinliği.	yazılabilir
extendedProperties	object	Etkinliğin genişletilmiş özellikleri.
extendedProperties.private	object	Etkinliğin bu takvimde görünen kopyasına özel özellikler.	yazılabilir
extendedProperties.private.(key)	string	Özel mülkün adı ve ilgili değer.
extendedProperties.shared	object	Diğer katılımcıların cihazındaki etkinlik kopyaları arasında paylaşılan mülkler takvim.	yazılabilir
extendedProperties.shared.(key)	string	Paylaşılan mülkün adı ve ilgili değer.
focusTimeProperties	nested object	Odaklanma zamanı etkinlik verileri. eventType değeri focusTime ise kullanılır.	yazılabilir
focusTimeProperties.autoDeclineMode	string	Odaklanma Zamanı etkinlikleriyle çakışan toplantı davetiyelerinin reddedilip reddedilmeyeceğini belirler. Geçerli değerler declineNone şeklindedir. Diğer bir deyişle hiçbir toplantı davetiyesi reddedilmez; declineAllConflictingInvitations: Etkinlikle çakışan tüm çakışan toplantı davetiyeleri reddedilir; ve declineOnlyNewConflictingInvitations (yani yalnızca Odaklanma Zamanı etkinliği varken gelen yeni çakışan toplantı davetiyeleri reddedilecek).
focusTimeProperties.chatStatus	string	Kullanıcının Chat'te ve ilgili ürünlerde işaretleneceği durum. Bu, available veya doNotDisturb olabilir.
focusTimeProperties.declineMessage	string	Mevcut bir etkinlik veya yeni davetiye Takvim tarafından otomatik olarak reddedilirse ayarlanacak yanıt iletisi.
gadget	object	Bu etkinliğin süresini uzatan bir widget. Gadget'lar kullanımdan kaldırılmıştır; bu yapı yalnızca doğum günü takvimi meta verilerini döndürmek için kullanılır.
gadget.display	string	Aygıtın görüntü modu. Kullanımdan kaldırıldı. Olası değerler: "icon" - Aygıt, takvim görünümünde etkinlik başlığının yanında görüntülenir. "chip" - Etkinlik tıklandığında widget görüntülenir.	yazılabilir
gadget.height	integer	Aygıtın piksel cinsinden yüksekliği. Yükseklik 0'dan büyük bir tam sayı olmalıdır. İsteğe bağlı. Kullanımdan kaldırıldı.	yazılabilir
gadget.iconLink	string	Cihazı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ı.	yazabilir
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	Aygıtın türü. Kullanımdan kaldırıldı.	yazılabilir
gadget.width	integer	Aygıtın piksel cinsinden genişliği. Genişlik 0'dan büyük bir tam sayı olmalıdır. İsteğe bağlı. Kullanımdan kaldırıldı.	yazılabilir
guestsCanInviteOthers	boolean	Düzenleyen dışındaki katılımcıların etkinliğe başkalarını davet edip edemeyeceği İsteğe bağlı. Varsayılan değer, Doğru'dur.	yazılabilir
guestsCanModify	boolean	Düzenleyen dışındaki katılımcıların etkinliği değiştirip değiştiremeyeceğini belirtir. İsteğe bağlı. Varsayılan değer False'tır.	yazılabilir
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 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ğin mutlak bağlantısı. Salt okunur.
iCalUID	string	RFC5545'te tanımlandığı şekliyle benzersiz etkinlik tanımlayıcısı. Takvim sistemlerinde etkinlikleri benzersiz şekilde tanımlamak için kullanılır ve etkinlikler 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. Anlamsal açıdan tek fark, yinelenen etkinliklerde bir etkinliğin tüm tekrarlarının farklı id'lere sahip olmasıdır ancak hepsi aynı iCalUID öğelerini paylaşır. Bir etkinliği iCalUID kullanarak almak için iCalUID parametresini kullanarak events.list yöntemini çağırın. Bir etkinliği id değerini 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 1.024 karakter arasında olmalıdır kimlik her takvim için benzersiz olmalıdır Sistemin küresel olarak dağıtılmış yapısı nedeniyle, etkinlik oluşturma sırasında kimlik çakışmalarının algılanacağını garanti edemeyiz. Çarpış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 değerlerinin aynı olmadığını ve etkinlik oluşturma sırasında bunlardan yalnızca birinin sağlanması gerektiğini unutmayın. Anlamsal açıdan tek fark, yinelenen etkinliklerde bir etkinliğin tüm tekrarlarının farklı id'lere sahip olmasıdır ancak hepsi aynı icalUID öğelerini paylaşır.	yazılabilir
kind	string	Kaynak türü ("calendar#event").
location	string	Serbest biçimli metin olarak etkinliğin coğrafi konumu. İsteğe bağlı.	yazabilir
locked	boolean	Bunun "summary", "description", "location", "start", "end" ana etkinlik alanlarında hiçbir değişiklik yapılamayan kilitli bir etkinlik kopyası olup olmadığı veya "yinelenme" olarak adlandırılır. Varsayılan değer, Yanlış'tır. Salt Okunur.
organizer	object	Etkinliği düzenleyen kullanıcı. Düzenleyen kişi aynı zamanda bir katılımcıysa bu durum attendees alanında organizer alanı Doğru değerine ayarlanmış ayrı bir girişle belirtilir. Düzenleyiciyi değiştirmek için taşıma işlemini kullanın. Bir etkinliği içe aktarma işlemi hariç, salt okunurdur.	yazabilir
organizer.displayName	string	Varsa düzenleyen kişinin adı.	yazılabilir
organizer.email	string	Düzenleyen kullanıcının e-posta adresi (varsa). Bu, RFC5322'ye göre geçerli bir e-posta adresi olmalıdır.	yazılabilir
organizer.id	string	Varsa düzenleyen kullanıcının profil kimliği.
organizer.self	boolean	Düzenleyen kullanıcının, etkinliğin bu kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunur. Varsayılan değer False'tır.
originalStartTime	nested object	Düzenli bir etkinlik örneği için bu etkinliğin, yinelenen etkinlik kimliği tarafından tanımlanan yinelenen etkinlikteki yineleme verilerine göre başlayacağı zamandır. Örnek farklı bir zamana taşınmış olsa bile yinelenen etkinlik serisindeki örneği benzersiz şekilde tanımlar. Sabit.
originalStartTime.date	date	Bu tüm gün süren bir etkinlikse "yyyy-aa-gg" biçiminde tarih.	yazılabilir
originalStartTime.dateTime	datetime	Birleştirilmiş tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone içinde bir saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir.	yazılabilir
originalStartTime.timeZone	string	Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilmiştir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan gereklidir ve yinelenmenin genişletildiği saat dilimini belirtir. Tek bir etkinlik için bu alan isteğe bağlıdır ve etkinliğin başlangıcı/bitişi için özel bir saat dilimi belirtir.	yazılabilir
outOfOfficeProperties	nested object	Ofis dışında etkinlik verileri. eventType değeri outOfOffice ise kullanılır.	yazılabilir
outOfOfficeProperties.autoDeclineMode	string	Ofis dışında etkinlikleriyle çakışan toplantı davetiyelerinin reddedilip reddedilmeyeceği. Geçerli değerler declineNone şeklindedir. Diğer bir deyişle hiçbir toplantı davetiyesi reddedilmez; declineAllConflictingInvitations: Etkinlikle çakışan tüm çakışan toplantı davetiyeleri reddedilir; ve declineOnlyNewConflictingInvitations (yani yalnızca Ofis dışında etkinliği varken gelen yeni çakışan toplantı davetiyeleri reddedilecek).
outOfOfficeProperties.declineMessage	string	Mevcut bir etkinlik veya yeni davetiye Takvim tarafından otomatik olarak reddedilirse ayarlanacak yanıt iletisi.
privateCopy	boolean	Doğru değerine ayarlanırsa Etkinlik yayılımı devre dışı bırakılır. Bu özelliğin Gizli etkinlik mülkleri ile aynı 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; etkinlik başlangıç ve bitiş zamanları start ve end alanlarında belirtilir. Bu alan, tek etkinlikler veya yinelenen etkinlik örnekleri için çıkarılır.	yazılabilir
recurringEventId	string	Düzenli bir etkinliğin örneği için bu, söz konusu örneğin ait olduğu 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. Hatırlatıcıları değiştirmenin, ilgili etkinliğin updated özelliğini de değiştirmediğini unutmayın.
reminders.overrides[]	list	Etkinlikte varsayılan hatırlatıcılar kullanılmıyorsa etkinliğe özel hatırlatıcılar listelenir. Ayarlanmamışsa etkinlik için hiçbir hatırlatıcı ayarlanmadığı gösterilir. Geçersiz kılma hatırlatıcıları maksimum 5 tanedir.	yazılabilir
reminders.overrides[].method	string	Bu hatırlatıcının kullandığı yöntem. Olası değerler: "email" - Hatırlatıcılar e-postayla gönderilir. "popup" - Hatırlatıcılar, kullanıcı arayüzü pop-up'ı aracılığıyla gönderilir. Hatırlatıcı eklerken zorunludur.	yazılabilir
reminders.overrides[].minutes	integer	Hatırlatıcının etkinlikten kaç dakika önce tetiklenmesi gerektiğ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 iletisi veya HTTP ya da HTTPS şemasına sahip URL ile tanımlanabilir herhangi bir doküman. Yalnızca etkinliği oluşturan kişi tarafından görülebilir veya değiştirilebilir.
source.title	string	Kaynağın başlığı örneğin, bir web sayfasının başlığı veya e-posta konusu.	yazılabilir
source.url	string	Bir kaynağa işaret eden kaynağın URL'si. URL şeması HTTP veya HTTPS olmalıdır.	yazılabilir
start	nested object	Etkinliğin (dahil) başlangıç saati. Düzenli bir etkinlik için bu, ilk örneğin başlangıç zamanıdır.
start.date	date	Bu tüm gün süren bir etkinlikse "yyyy-aa-gg" biçiminde tarih.	yazılabilir
start.dateTime	datetime	Birleştirilmiş tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone içinde bir saat dilimi açıkça belirtilmediği sürece saat dilimi farkı gereklidir.	yazılabilir
start.timeZone	string	Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilmiştir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan gereklidir ve yinelenmenin genişletildiği saat dilimini belirtir. Tek bir etkinlik için bu alan isteğe bağlıdır ve etkinliğin başlangıcı/bitişi için özel bir saat dilimi belirtir.	yazılabilir
status	string	Etkinliğin durumu. İsteğe bağlı. Olası değerler: "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, yalnızca artımlı senkronizasyonda (syncToken veya updatedMin belirtildiğinde) veya showDeleted işareti true değerine ayarlandığında iptal edilen etkinlikleri 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 temsil eder: İptal edilmemiş yinelenen bir etkinliğin iptal edilen istisnaları, bu örneğin artık kullanıcıya gösterilmemesi 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 doldurulacağı garanti edilir. Diğer alanlar boş olabilir. İptal edilen diğer tüm etkinlikler silinmiş 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ığı etkinlikler de ayrıntıları sağlamaya devam eder. Ancak showDeleted yanlış değerine ayarlanmış artımlı senkronizasyon istekleri bu ayrıntıları döndürmez. Bir etkinliğin düzenleyicisi değişirse (örneğin, taşıma işlemiyle) ve asıl düzenleyen kişi katılımcı listesinde değilse bu etkinlik yalnızca id alanının doldurulmasının garanti edildiği iptal edilmiş bir etkinlik bırakır.	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 saati engellemektedir. 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ştirme zamanı (RFC3339 zaman damgası olarak). Etkinlik hatırlatıcılarının güncellenmesi bu durumu değiştirmez. Salt okunur.
visibility	string	Etkinliğin görünürlüğü. İsteğe bağlı. Olası değerler: "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 takvimin tüm okuyucuları etkinlik ayrıntılarını görebilir. "private" - Etkinlik gizlidir ve yalnızca etkinlik katılımcıları etkinlik ayrıntılarını görüntüleyebilir. "confidential" - Etkinlik gizliyse. Bu değer uyumluluk nedeniyle sağlanmıştı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.	yazabilir
workingLocationProperties.customLocation.label	string	Ek bilgi için isteğe bağlı ekstra bir etiket.	yazılabilir
workingLocationProperties.homeOffice	any value	Varsa kullanıcının evde çalıştığını belirtir.	yazılabilir
workingLocationProperties.officeLocation	object	Varsa kullanıcının bir ofisten çalıştığını belirtir.	yazılabilir
workingLocationProperties.officeLocation.buildingId	string	İsteğe bağlı bir bina tanımlayıcısı. Bu, kuruluşun Kaynaklar veritabanındaki bir bina kimliğine başvuruda bulunmalıdır.	yazılabilir
workingLocationProperties.officeLocation.deskId	string	İsteğe bağlı bir masa tanımlayıcısı.	yazılabilir
workingLocationProperties.officeLocation.floorId	string	İsteğe bağlı bir kat tanımlayıcısı.	yazılabilir
workingLocationProperties.officeLocation.floorSectionId	string	İsteğe bağlı bir kat bölümü tanımlayıcısı.	yazılabilir
workingLocationProperties.officeLocation.label	string	Takvim web ve mobil istemcilerinde gösterilen ofis adı. Kuruluşun Kaynaklar veritabanında bir bina adına referans vermenizi öneririz.	yazılabilir
workingLocationProperties.type	string	Çalışma yerinin türü. Olası değerler: "homeOffice" - Kullanıcı evde çalışıyor. "officeLocation" - Kullanıcı bir ofisten çalışıyordur. "customLocation" - Kullanıcı özel bir yerden çalışıyor. Tüm ayrıntılar, belirtilen adın bir alt alanında belirtilir ancak boşsa bu alan eksik olabilir. Diğer alanlar yoksayılır. Çalışma yeri özellikleri eklenirken gereklidir.	yazılabilir

Yöntemler

sil

Bir etkinliği siler.

al

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 bir kopyasını takvime eklemek için kullanılır. Yalnızca eventType/default değerine sahip etkinlikler içe aktarılabilir.

Kullanımdan kaldırılmış davranış: default olmayan bir etkinlik içe aktarılırsa türü default olarak değiştirilir ve etkinlik türüne özgü tüm özellikler atlanır.

ekle

Etkinlik oluşturur.

instances

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

list

Belirtilen takvimdeki etkinlikleri döndürür.

taşı

Bir etkinliği başka bir takvime taşır (ör. etkinliğin düzenleyicisi değiştirilir). Yalnızca default etkinliğin taşınabileceğini unutmayın; birthday, focusTime, fromGmail, outOfOffice ve workingLocation etkinlikleri taşınamaz.

yama

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

quickAdd

Basit bir metin dizesine göre etkinlik oluşturur.

güncelle

Bir etkinliği günceller. Bu yöntem, yama semantiğini desteklemez ve etkinlik kaynağının tamamını her zaman günceller. Kısmi güncelleme yapmak için etag'leri kullanarak atomikten emin olmak amacıyla get ve ardından update işlemi gerçekleştirin.

saat

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