Events

Calendar API, farklı türde etkinlik kaynakları sunar. Etkinlikler hakkında başlıklı makalede daha fazla bilgi bulabilirsiniz.

Bu kaynağa ilişkin yöntemlerin listesi için bu sayfanın sonuna bakın.

Kaynak temsilleri

{
  "kind": "calendar#event",
  "etag": etag,
  "id": string,
  "status": string,
  "htmlLink": string,
  "created": datetime,
  "updated": datetime,
  "summary": string,
  "description": string,
  "location": string,
  "colorId": string,
  "creator": {
    "id": string,
    "email": string,
    "displayName": string,
    "self": boolean
  },
  "organizer": {
    "id": string,
    "email": string,
    "displayName": string,
    "self": boolean
  },
  "start": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "end": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "endTimeUnspecified": boolean,
  "recurrence": [
    string
  ],
  "recurringEventId": string,
  "originalStartTime": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "transparency": string,
  "visibility": string,
  "iCalUID": string,
  "sequence": integer,
  "attendees": [
    {
      "id": string,
      "email": string,
      "displayName": string,
      "organizer": boolean,
      "self": boolean,
      "resource": boolean,
      "optional": boolean,
      "responseStatus": string,
      "comment": string,
      "additionalGuests": integer
    }
  ],
  "attendeesOmitted": boolean,
  "extendedProperties": {
    "private": {
      (key): string
    },
    "shared": {
      (key): string
    }
  },
  "hangoutLink": string,
  "conferenceData": {
    "createRequest": {
      "requestId": string,
      "conferenceSolutionKey": {
        "type": string
      },
      "status": {
        "statusCode": string
      }
    },
    "entryPoints": [
      {
        "entryPointType": string,
        "uri": string,
        "label": string,
        "pin": string,
        "accessCode": string,
        "meetingCode": string,
        "passcode": string,
        "password": string
      }
    ],
    "conferenceSolution": {
      "key": {
        "type": string
      },
      "name": string,
      "iconUri": string
    },
    "conferenceId": string,
    "signature": string,
    "notes": string,
  },
  "gadget": {
    "type": string,
    "title": string,
    "link": string,
    "iconLink": string,
    "width": integer,
    "height": integer,
    "display": string,
    "preferences": {
      (key): string
    }
  },
  "anyoneCanAddSelf": boolean,
  "guestsCanInviteOthers": boolean,
  "guestsCanModify": boolean,
  "guestsCanSeeOtherGuests": boolean,
  "privateCopy": boolean,
  "locked": boolean,
  "reminders": {
    "useDefault": boolean,
    "overrides": [
      {
        "method": string,
        "minutes": integer
      }
    ]
  },
  "source": {
    "url": string,
    "title": string
  },
  "workingLocationProperties": {
    "type": string,
    "homeOffice": (value),
    "customLocation": {
      "label": string
    },
    "officeLocation": {
      "buildingId": string,
      "floorId": string,
      "floorSectionId": string,
      "deskId": string,
      "label": string
    }
  },
  "outOfOfficeProperties": {
    "autoDeclineMode": string,
    "declineMessage": string
  },
  "focusTimeProperties": {
    "autoDeclineMode": string,
    "declineMessage": string,
    "chatStatus": string
  },
  "attachments": [
    {
      "fileUrl": string,
      "title": string,
      "mimeType": string,
      "iconLink": string,
      "fileId": string
    }
  ],
  "eventType": string
}

Mülk adı	Değer	Açıklama	Notlar
anyoneCanAddSelf	boolean	Herkesin kendisini etkinliğe davet edip edemeyeceği (kullanımdan kaldırıldı). İsteğe bağlı. Varsayılan, Yanlış'tır.	yazılabilir
attachments[]	list	Etkinlikle ilgili 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	Ekteki dosyanın kimliği. Salt okunurdur. 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 özelliğindeki biçimi kullanın. Ek iliştirirken gereklidir.	yazılabilir
attachments[].iconLink	string	Ekin simgesine 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ılıp çıkarılmayacağı. Bir etkinlik alınırken bunun nedeni, maxAttendee sorgu parametresi tarafından belirtilen bir kısıtlama olabilir. Bir etkinliği güncellerken, bu seçenek yalnızca katılımcının yanıtını güncellemek için kullanılabilir. İsteğe bağlı. Varsayılan, 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ıları olan etkinlikler rehberine göz atın. Hizmet hesaplarının katılımcı listesini doldurmak için alan genelinde yetki verme özelliğini 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	Varsa katılımcının e-posta adresi. Katılımcı eklerken bu alan mevcut olmalıdır. RFC5322 uyarınca geçerli bir e-posta adresi olmalıdır. Katılımcı eklerken gereklidir.	yazılabilir
attendees[].id	string	Varsa katılımcının Profil Kimliği.
attendees[].optional	boolean	Bu katılımcının isteğe bağlı olup olmadığı. İsteğe bağlı. Varsayılan, Yanlış'tır.	yazılabilir
attendees[].organizer	boolean	Katılımcının etkinliği düzenleyen kişi olup olmadığı. Salt okunurdur. Varsayılan, Yanlış'tır.
attendees[].resource	boolean	Katılımcının bir kaynak olup olmadığı. Yalnızca katılımcı etkinliğe ilk kez eklendiğinde ayarlanabilir. Daha sonraki değişiklikler yoksayılır. İsteğe bağlı. Varsayılan, Yanlış'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 vermedi (yeni etkinlikler için önerilir). "declined" - Katılımcı davetiyeyi reddetti. "tentative" - Katılımcı davetiyeyi geçici olarak kabul etti. "accepted" - Katılımcı davetiyeyi kabul etti. Uyarı: declined, tentative veya accepted değerlerini kullanarak bir etkinlik eklerseniz "Davetiyeleri takvimime ekle" ayarı "E-postadaki davetiyeyi yanıtladığımda" olarak belirlenmiş katılımcılar, davetiye yanıtlarını etkinlik davetiyesi e-postasında değiştirmeyi seçmedikleri sürece takvimlerinde etkinlik görmez.	yazılabilir
attendees[].self	boolean	Bu girişin, etkinliğin bu kopyasının göründüğü takvimi temsil edip etmediği. Salt okunurdur. Varsayılan, Yanlış'tır.
colorId	string	Etkinliğin rengi. Bu kimlik, renk tanımının event bölümündeki bir girişi ifade eden bir kimliktir ( renk uç noktasına bakın). İsteğe bağlı.	yazılabilir
conferenceData	nested object	Konferansla ilgili bilgiler (ör. bir Google Meet konferansının ayrıntıları) Yeni konferans ayrıntılarını oluşturmak için createRequest alanını kullanın. Değişikliklerinizi kaybetmemek için tüm etkinlik değişiklik isteklerinde conferenceDataVersion istek parametresini 1 olarak ayarlamayı unutmayın.	yazılabilir
conferenceData.conferenceId	string	Konferansın kimliği. Geliştiriciler tarafından konferans takibi yapmak 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: Kimlik, Hangout'un adıdır. (Bu konferans türü kullanımdan kaldı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	Konferans çözümü (ör. Google Meet). Başarısız bir oluşturma isteği olan konferans için ayarı 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ü. İstemci alışılmadık veya boş bir türle karşılaşırsa giriş noktalarını görüntüleyebilir. Ancak, değişiklik yapılmasına izin verilmemelidir. Olası değerler şunlardır: Tüketiciler için Hangouts "eventHangout" (kullanımdan kaldı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" (kullanımdan kaldırıldı. Mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferanslar 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ştirilmemiş.
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	Konferans çözümü (ör. Hangouts veya Google Meet).
conferenceData.createRequest.conferenceSolutionKey.type	string	Konferans çözümü türü. İstemci alışılmadık veya boş bir türle karşılaşırsa giriş noktalarını görüntüleyebilir. Ancak, değişiklik yapılmasına izin verilmemelidir. Olası değerler şunlardır: Tüketiciler için Hangouts "eventHangout" (kullanımdan kaldı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" (kullanımdan kaldırıldı. Mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferanslar 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 okunurdur. Olası değerler şunlardır: "pending": Konferans oluşturma isteğinin işlenmesi devam ediyor. "success": Konferans oluşturma isteği başarılı oldu, giriş noktaları doldurulur. "failure": Konferans oluşturma isteği başarısız oldu. Giriş noktası yok.
conferenceData.entryPoints[]	list	Konferans giriş noktaları hakkında bilgi (ör. URL'ler veya telefon numaraları). Tüm katılımcılar aynı konferansa ait olmalıdır. conferenceSolution ve en az bir entryPoint veya createRequest gereklidir.
conferenceData.entryPoints[].accessCode	string	Konferansa erişmek için erişim kodu. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen {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 konferansta sıfır veya bir video giriş noktası olabilir. "phone" - telefon numarası çevirerek bir konferansa katılıyorsunuz. Bir konferansta sıfır veya daha fazla phone giriş noktası olabilir. "sip" - SIP üzerinden bir konferansa katılıyor. Bir konferansta sıfır veya bir sip giriş noktası olabilir. "more" - konferansa katılmayla ilgili diğer talimatlar (örneğin, ek telefon numaraları). 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'nın etiketi. Son kullanıcılar görebilir. Yerelleştirilmemiş. 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 toplantı kodu. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen {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. 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.
conferenceData.entryPoints[].password	string	Konferansa erişmek için kullanılacak şifre. Maksimum uzunluk 128 karakterdir. Yeni konferans verileri oluştururken yalnızca konferans sağlayıcısının kullandığı terminolojiyle eşleşen {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. 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[].uri	string	Giriş noktasının URI'sı. Maksimum uzunluk 1.300 karakterdir. 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ı gereklidir, ör. sip:12345678@sağlayıcım.com. more, http: veya https: şeması için gereklidir.
conferenceData.notes	string	Kullanıcıya görüntülenecek ek notlar (ör. alan yöneticisinin talimatları, yasal uyarılar). HTML içerebilir. Maksimum uzunluk 2048 karakterdir. İsteğe bağlı.
conferenceData.signature	string	Konferans verilerinin imzası. Sunucu tarafında oluşturulur. Başarısız bir oluşturma isteği olan konferans için ayarı kaldırın. Bekleyen oluşturma isteği olan konferanslar için isteğe bağlıdır.
created	datetime	Etkinliğin oluşturulma zamanı (RFC3339 zaman damgası olarak). Salt okunurdur.
creator	object	Etkinliği oluşturan kullanıcı. Salt okunurdur.
creator.displayName	string	Varsa içerik üreticinin adı.
creator.email	string	Varsa oluşturan kişinin e-posta adresi.
creator.id	string	Varsa içerik üreticinin profil kimliği
creator.self	boolean	Etkinliği oluşturan kullanıcının, etkinlik kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunurdur. Varsayılan, Yanlış'tır.
description	string	Etkinliğin açıklaması. HTML içerebilir. İsteğe bağlı.	yazılabilir
end	nested object	Etkinliğin (hariç) bitiş zamanı. Düzenli bir etkinlik için bu, ilk örneğin bitiş zamanıdır.
end.date	date	Bu tüm gün süren bir etkinlikse, "yyyy-aa-gg" biçiminde tarih.	yazılabilir
end.dateTime	datetime	Birleşik bir tarih-saat değeri (RFC3339'a göre biçimlendirilmiş) olarak saat. timeZone ürününde 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çimlendirilir, ör. "Avrupa/Zürih".) Düzenli etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek etkinlikler için bu alan isteğe bağlıdır ve etkinlik başlangıcı/sonu için özel bir saat dilimini belirtir.	yazılabilir
endTimeUnspecified	boolean	Bitiş zamanının belirtilmemiş olup olmadığı. Bu özellik Doğru değerine ayarlanmış olsa bile uyumluluk nedeniyle bitiş zamanı sağlanır. Varsayılan, Yanlış'tır.
etag	etag	Kaynağın ETag.
eventType	string	Etkinliğin belirli bir türü. Etkinlik oluşturulduktan sonra bu ayar değiştirilemez. Olası değerler: "default": Normal bir etkinlik veya daha başka bir belirtilmemiş. "outOfOffice" - Ofis dışında etkinliği. "focusTime": Odaklanma zamanı 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 etkinliğin kopyasına özel özellikler.	yazılabilir
extendedProperties.private.(key)	string	Özel mülkün adı ve ilgili değer.
extendedProperties.shared	object	Etkinliğin diğer katılımcıların takvimlerindeki kopyaları arasında paylaşılan özellikler.	yazılabilir
extendedProperties.shared.(key)	string	Paylaşılan mülkün adı ve karşılık gelen 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 belirtir. Geçerli değerler declineNone değerleridir. Yani hiçbir toplantı daveti reddedilir; declineAllConflictingInvitations, etkinlikle çakışan tüm çakışan toplantı davetiyeleri reddedilir ve declineOnlyNewConflictingInvitations, yani yalnızca Odaklanma Zamanı etkinliği mevcutken gelen yeni çakışan toplantı davetiyeleri reddedilir.
focusTimeProperties.chatStatus	string	Kullanıcıyı Chat'te ve ilgili ürünlerde işaretleme durumu. Bu değer, available veya doNotDisturb olabilir.
focusTimeProperties.declineMessage	string	Mevcut bir etkinliğin veya yeni bir davetiyenin Takvim tarafından otomatik olarak reddedilip reddedilmeyeceğini belirleyen yanıt iletisi.
gadget	object	Bu etkinliği genişleten bir gadget. 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ılmaktadır.
gadget.display	string	Gadget'ı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" - 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'e dokunun.	yazılabilir
gadget.preferences.(key)	string	Tercih adı ve ilgili değer.
gadget.title	string	Gadget'ın başlığı. Kullanımdan kaldırıldı.	yazılabilir
gadget.type	string	Gadget'ın türü. Kullanımdan kaldırıldı.	yazılabilir
gadget.width	integer	Gadget'ın piksel cinsinden genişliği. Genişlik 0'dan büyük bir tam sayı olmalıdır. İsteğe bağlı. Kullanımdan kaldırıldı.	yazılabilir
guestsCanInviteOthers	boolean	Etkinliği düzenleyen kullanıcı dışındaki katılımcıların etkinliğe başkalarını davet edip edemeyeceği. İsteğe bağlı. Varsayılan, Doğru değeridir.	yazılabilir
guestsCanModify	boolean	Düzenleyen kişi dışındaki katılımcıların etkinliği değiştirip değiştiremeyeceğini belirler. İsteğe bağlı. Varsayılan, Yanlış'tır.	yazılabilir
guestsCanSeeOtherGuests	boolean	Etkinliği düzenleyen kişi dışındaki katılımcıların, etkinlik katılımcılarının kimler olduğunu görüp göremeyeceği. İsteğe bağlı. Varsayılan, Doğru değeridir.	yazılabilir
hangoutLink	string	Bu etkinlikle ilişkili Google Hangout'un mutlak bağlantısı. Salt okunurdur.
htmlLink	string	Google Takvim web kullanıcı arayüzünde bu etkinliğin mutlak bağlantısı. Salt okunurdur.
iCalUID	string	RFC5545'te tanımlandığı şekliyle etkinlik benzersiz tanımlayıcısı. Bu kimlik, takvim sistemleri genelinde 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ştururken bunlardan yalnızca birinin sağlanması gerektiğini unutmayın. Anlamları arasındaki farklardan biri, yinelenen etkinliklerde bir etkinliğin geçtiği her yerde farklı id olmasına rağmen tümünün aynı iCalUID değerini paylaşmasıdır. Bir etkinliği iCalUID parametresini kullanarak almak için iCalUID parametresini kullanarakevents.list yöntemini çağırın. Bir etkinliği id özelliğini 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 bu etkinliklerin kimliklerini belirtebilirsiniz. Sağlanan kimlikler aşağıdaki kurallara uygun olmalıdır: Kimlikte izin verilen karakterler base32 onaltılık kodlamasında kullanılan karakterlerdir (ör. küçük harfler a-v ve 0-9 arası harfler). RFC2938'de bölüm 3.1.2'ye bakın. kimlik 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, kimlik çakışmalarının etkinlik oluşturma sırasında algılanacağını garanti edemeyiz. Çakışma riskini en aza indirmek için RFC4122'de açıklanana benzer yerleşik bir UUID algoritması kullanmanızı öneririz. Kimlik belirtmezseniz, sunucu tarafından otomatik olarak oluşturulur. icalUID ve id özelliklerinin aynı olmadığını ve etkinlik oluştururken bunlardan yalnızca birinin sağlanması gerektiğini unutmayın. Anlamları arasındaki farklardan biri, yinelenen etkinliklerde bir etkinliğin geçtiği her yerde farklı id olmasına rağmen tümünün aynı icalUID değerini paylaşmasıdır.	yazılabilir
kind	string	Kaynağın türü ("calendar#event").
location	string	Serbest biçimli metin olarak etkinliğin coğrafi konumu. İsteğe bağlı.	yazılabilir
locked	boolean	Bunun, "özet", "açıklama", "konum", "başlangıç", "bitiş" veya "tekrarlama" ana etkinlik alanlarında hiçbir değişiklik yapılamayan kilitli bir etkinlik kopyası olup olmadığı. Varsayılan, Yanlış'tır. Salt Okunur.
organizer	object	Etkinliği düzenleyen kullanıcı. Düzenleyen aynı zamanda bir katılımcıysa bu, attendees içinde organizer alanı True olarak ayarlanmış ayrı bir girişle belirtilir. Düzenleyeni değiştirmek için taşı işlemini kullanın. Salt okunur (bir etkinliğin içe aktarıldığı durumlar hariç).	yazılabilir
organizer.displayName	string	Varsa düzenleyenin adı.	yazılabilir
organizer.email	string	Varsa düzenleyen kişinin e-posta adresi. RFC5322 uyarınca 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üğü takvime karşılık gelip gelmediği. Salt okunurdur. Varsayılan, Yanlış'tır.
originalStartTime	nested object	Düzenli bir etkinliğin örneği için, bu etkinliğin, düzenli etkinlik kimliği tarafından tanımlanan yinelenme verilerine göre başlayacağı zamandır. Örnek farklı bir zamana taşınmış olsa bile düzenli etkinlik serisi içindeki ö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şik bir tarih-saat değeri (RFC3339'a göre biçimlendirilmiş) olarak saat. timeZone ürününde 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çimlendirilir, ör. "Avrupa/Zürih".) Düzenli etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek etkinlikler için bu alan isteğe bağlıdır ve etkinlik başlangıcı/sonu için özel bir saat dilimini belirtir.	yazılabilir
outOfOfficeProperties	nested object	Ofis dışında etkinlik verileri. eventType değeri outOfOffice ise kullanılır.	yazılabilir
outOfOfficeProperties.autoDeclineMode	string	Çakışan "Ofis dışında etkinlikleri" olan toplantı davetiyelerinin reddedilip reddedilmeyeceğini belirtir. Geçerli değerler declineNone değerleridir; yani hiçbir toplantı davetiyesi reddedilir; declineAllConflictingInvitations, etkinlikle çakışan tüm çakışan toplantı davetiyeleri reddedilir ve declineOnlyNewConflictingInvitations, yalnızca Ofis dışında etkinliği mevcutken gelen yeni çakışan toplantı davetiyeleri reddedilir.
outOfOfficeProperties.declineMessage	string	Mevcut bir etkinliğin veya yeni bir davetiyenin Takvim tarafından otomatik olarak reddedilip reddedilmeyeceğini belirleyen yanıt iletisi.
privateCopy	boolean	Politika, Doğru değerine ayarlanırsa Etkinlik yayılımı devre dışı bırakılır. Bunun Özel etkinlik özellikleri ile aynı şey olmadığını unutmayın. İsteğe bağlı. Sabit. Varsayılan, Yanlış'tır.
recurrence[]	list	RFC5545'te belirtildiği şekilde, 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 atlanır.	yazılabilir
recurringEventId	string	Düzenli bir etkinliğin örneği için bu, örneğin ait olduğu düzenli etkinliğin id değeridir. Sabit.
reminders	object	Kimliği doğrulanmış kullanıcı için etkinlik hatırlatıcılarıyla ilgili bilgiler.
reminders.overrides[]	list	Etkinlikte varsayılan hatırlatıcılar kullanılmıyorsa bu, etkinliğe özel hatırlatıcıları listeler. Ayarlanmamışsa bu etkinlik için hatırlatıcı ayarlanmadığını gösterir. Maksimum geçersiz kılma hatırlatıcısı sayısı 5'tir.	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 gerekir.	yazılabilir
reminders.overrides[].minutes	integer	Hatırlatıcının, etkinliğin başlamasından kaç dakika önce tetikleneceği. Geçerli değerler 0 ile 40320 arasındadır (dakika cinsinden 4 hafta). Hatırlatıcı eklerken gerekir.	yazılabilir
reminders.useDefault	boolean	Takvimdeki varsayılan hatırlatıcıların etkinliğe uygulanıp uygulanmayacağı.	yazılabilir
sequence	integer	iTakvim'e göre sıra numarası.	yazılabilir
source	object	Etkinliğin oluşturulduğu kaynak. Örneğin bir web sayfası, e-posta mesajı ya da HTTP veya HTTPS şemasına sahip bir URL tarafından tanımlanabilir herhangi bir doküman. Yalnızca etkinliği oluşturan kişi tarafından görüntülenebilir veya değiştirilebilir.
source.title	string	Kaynağın başlığı. Örneğin, bir web sayfasının başlığı veya e-posta konusu.	yazılabilir
source.url	string	Bir kaynağ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ıç zamanı. Düzenli bir etkinlik için bu, ilk örneğin başlangıç zamanıdır.
start.date	date	Bu tüm gün süren bir etkinlikse, "yyyy-aa-gg" biçiminde tarih.	yazılabilir
start.dateTime	datetime	Birleşik bir tarih-saat değeri (RFC3339'a göre biçimlendirilmiş) olarak saat. timeZone ürününde 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çimlendirilir, ör. "Avrupa/Zürih".) Düzenli etkinlikler için bu alan zorunludur ve yinelemenin genişletildiği saat dilimini belirtir. Tek etkinlikler için bu alan isteğe bağlıdır ve etkinlik başlangıcı/sonu için özel bir saat dilimini belirtir.	yazılabilir
status	string	Etkinliğin durumu. İsteğe bağlı. Olası değerler: "confirmed": Etkinlik onaylandı. Bu, varsayılan durumdur. "tentative": Etkinlik geçici olarak onaylandı. "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 ayarlandığında döndürür. get yöntemi bunları her zaman döndürür. İptal edildi durumu, etkinlik türüne bağlı olarak iki farklı durumu temsil eder: İptal edilmeyen bir düzenli etkinliğin iptal edilmiş istisnaları, bu örneğin artık kullanıcıya sunulmaması gerektiğini gösterir. Müşteriler, bu etkinlikleri üst düzenli etkinliğin ömrü boyunca depolamalıdır. İptal edilen istisnaların yalnızca id, recurringEventId ve originalStartTime alanlarının doldurulacağı garanti edilir. Diğer alanlar boş olabilir. İptal edilen diğer tüm etkinlikler, silinen etkinlikleri temsil eder. İstemciler, yerel olarak senkronize edilmiş kopyalarını kaldırmalıdır. Bu tür iptal edilen etkinlikler zamanla yok olacaktır. Bu nedenle, bu etkinliklerin süresiz olarak kullanılabilir olacağına güvenmeyin. Silinen etkinlikler için yalnızca id alanının doldurulması garanti edilir. İptal edilen etkinlikler, geri yüklenebilmesi (silme işlemi geri alınabilmesi) için etkinliği düzenleyenin takviminde 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ırıldığı etkinlikler de ayrıntıları sağlamaya devam eder. Ancak showDeleted politikasının yanlış değerine ayarlandığı 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 etkinliği düzenleyen kişi katılımcı listesinde yoksa, geride yalnızca id alanının doldurulmasının garanti edildiği, iptal edilmiş bir etkinlik kalı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 zamanı bloke eder. Bu, Takvim kullanıcı arayüzünde Durumumu şu şekilde göster'i Meşgul olarak ayarlamaya eşdeğerdir. "transparent" - Etkinlik, takvimde zamanı engellemez. Bu, Takvim kullanıcı arayüzünde Durumumu şu şekilde göster'i Kullanılabilir olarak ayarlamaya eşdeğerdir.	yazılabilir
updated	datetime	Etkinliğin son değiştirme zamanı (RFC3339 zaman damgası olarak). Salt okunurdur.
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ı tarafından görülebilir. "private": Etkinlik özeldir ve etkinlik ayrıntılarını yalnızca etkinlik katılımcıları görüntüleyebilir. "confidential": Etkinlik özeldir. 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 bilgi için isteğe bağlı ekstra 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 ofisten çalıştığını belirtir.	yazılabilir
workingLocationProperties.officeLocation.buildingId	string	İsteğe bağlı bina tanımlayıcısı. Bu ad, kuruluşun Kaynaklar veritabanındaki bir bina kimliğine referansta bulunmalıdır.	yazılabilir
workingLocationProperties.officeLocation.deskId	string	İsteğe bağlı masa tanımlayıcısı.	yazılabilir
workingLocationProperties.officeLocation.floorId	string	İsteğe bağlı kat tanımlayıcı.	yazılabilir
workingLocationProperties.officeLocation.floorSectionId	string	İsteğe bağlı kat bölümü tanımlayıcısı.	yazılabilir
workingLocationProperties.officeLocation.label	string	Takvim Web ve Mobil istemcilerinde görüntülenen ofis adı. Kuruluşun Kaynaklar veritabanında bulunan bir bina adına başvurmanızı öneririz.	yazılabilir
workingLocationProperties.type	string	Çalışma yeri türü. Olası değerler: "homeOffice": Kullanıcı evde çalışıyor. "officeLocation" - Kullanıcı bir ofisten çalışıyor. "customLocation": Kullanıcı özel bir yerden çalışıyor. Belirtilen adın bir alt alanında tüm ayrıntılar belirtilmiştir, ancak bu alan boşsa eksik olabilir. Diğer alanlar yok sayılır. Çalışma yeri özellikleri eklerken gerekir.	yazılabilir

Yöntemler

sil

Bir etkinliği siler.

al

Google Takvim kimliğine dayalı olarak bir etkinlik döndürür. Bir etkinliği iCalendar kimliğini kullanarak almak için iCalUID parametresini kullanarakevents.list yöntemini çağırın.

import

Bir etkinliği içe aktarır. Bu işlem, mevcut bir etkinliğin gizli kopyasını bir takvime eklemek için kullanılır. Yalnızca eventType/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 etkinlik türüne özgü tüm özellikler çıkarılır.

ekle

Etkinlik oluşturur.

örnekler

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

list

Belirtilen takvimdeki etkinlikleri döndürür.

taşı

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

yama

Bir etkinliği günceller. Bu yöntem yama semantiğini destekler. Her yama isteğinin üç kota birimi tükettiğini unutmayın; bir get ve ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri mevcut değerlerin yerine geçer. İstekte belirtmediğiniz alanlar değişmeden kalır. Dizi alanları (belirtilmişse) 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 her zaman tüm etkinlik kaynağını günceller. Kısmi güncelleme yapmak için get ve ardından, eşitsizlikten emin olmak için etag'leri kullanarak update işlemi gerçekleştirin.

saatinizi

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