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[].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.
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: +1 123 268 2601
  • sip için: 12345678@altostrat.com
  • 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:+12345678900,,,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.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
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:

    1. İ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.

    2. İ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.