Events

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

Bu kaynağa yönelik yöntem 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 (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 etkinlik güncellenirken 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 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ıyla ilgili yorum. İ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ı eklenirken bu alan bulunmalı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, Yanlış'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 vermedi (yeni etkinlikler için önerilir).
  • "declined" - Katılımcı davetiyeyi reddetti.
  • "tentative" - Katılımcı davetiyeyi belirsiz olarak kabul etti.
  • "accepted" - Katılımcı davetiyeyi kabul etti.
 yazılabilir
attendees[].self boolean Bu girişin, etkinliğin bu kopyasının göründüğü takvimi temsil edip etmediği. Salt okunur. Varsayılan değer, 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 Bir 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ın ayarını kaldırın.

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 için "eventHangout" (desteği sonlandırılmış. 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 için "eventHangout" (desteği sonlandırılmış. 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 müşteri 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. 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[].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 2048 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, Yanlış'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 etkinliğ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ş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. yazılabilir
endTimeUnspecified boolean Bitiş zamanının gerçekten belirtilmemiş olup olmadığı. Bu özellik Doğru değerine 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:
  • "default": Normal bir etkinlik veya daha fazla belirtilmemiş.
  • "outOfOffice": Ofis dışında etkinlik.
  • "focusTime" - Odaklanma zamanı etkinliği.
  • "workingLocation": Çalışma yeri etkinliği.
  • "fromGmail": Gmail'den bir etkinlik. Bu tür bir etkinlik oluşturulamaz.
 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 takvimlerindeki etkinlik kopyaları arasında paylaşılan özellikler. 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, yani hiçbir toplantı davetiyesi reddedilmez; declineAllConflictingInvitations, etkinlikle çakışan tüm çakışan toplantı davetleri reddedilir. declineOnlyNewConflictingInvitations anlamına gelir. Diğer bir deyişle, yalnızca Odaklanma Zamanı etkinliği varken gelen çakışan yeni toplantı davetiyeleri reddedilecektir.
focusTimeProperties.chatStatus string Kullanıcıyı Chat'te ve ilgili ürünlerde işaretleme durumu. 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ılmaktadır.
gadget.display string Aygıtın görüntü modu. Kullanımdan kaldırıldı. Olası değerler:
  • "icon" - Gadget, takvim görünümünde etkinlik başlığının yanında görüntülenir.
  • "chip" - 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'e dokunun. yazılabilir
gadget.preferences.(key) string Tercih adı ve karşılık gelen değer.
gadget.title string Aygıtı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, Yanlış'tır. yazılabilir
guestsCanSeeOtherGuests boolean Düzenleyen dışındaki katılımcıların etkinlik katılımcılarının kimler olduğunu görüp göremeyeceğini belirler. İsteğe bağlı. Varsayılan değer, Doğru'dur. yazılabilir
iCalUID string RFC5545'te tanımlandığı şekliyle benzersiz etkinlik tanımlayıcısı. Bu etkinlik, 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 bu etkinliklerin 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 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 kodlamada kullanılan karakterlerdir (ör. küçük harfler a-v ve rakamlar 0-9). RFC2938'deki bölüm 3.1.2'ye 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 bu etkinliklerin 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ı. yazılabilir
locked boolean Bunun "summary", "description", "location", "start", "end" veya "recurrence" ana etkinlik alanlarında hiçbir değişiklik yapılamayan kilitli bir etkinlik kopyası olup olmadığı. Varsayılan değer, 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. yazılabilir
organizer.displayName string Varsa düzenleyen kişinin adı. yazılabilir
organizer.email string Varsa, düzenleyen kişinin e-posta adresi. 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, Yanlış'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ğini belirler. Geçerli değerler: declineNone, yani hiçbir toplantı daveti reddedilmez; declineAllConflictingInvitations, etkinlikle çakışan tüm çakışan toplantı davetleri reddedilir. declineOnlyNewConflictingInvitations anlamına gelir. Diğer bir deyişle, yalnızca Ofis dışında etkinliği varken gelen çakışan yeni toplantı davetiyeleri reddedilecektir.
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. Bunun Özel etkinlik özellikleri ile aynı şey olmadığını unutmayın. İsteğe bağlı. Sabit. 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 yinelenen 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 bir kullanıcı arayüzü pop-up'ı aracılığıyla gönderilir.

Hatırlatıcı eklerken zorunludur.

 yazılabilir
reminders.overrides[].minutes integer Etkinlik başlamadan önce hatırlatıcının tetiklenmesi gereken dakika sayısı. Geçerli değerler 0 ile 40.320 (dakika cinsinden 4 hafta) arasındadır.

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 Web sayfasının başlığı veya e-posta konusu gibi kaynağın başlığı. 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 onaylandı. Bu, varsayılan durumdur.
  • "tentative" - Etkinlik geçici olarak onaylandı.
  • "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ş bir yinelenen 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 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. İstemciler 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ştirilirse (ö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ündeki Beni şu şekilde göster'i Meşgul olarak ayarlamakla eşdeğerdir.
  • "transparent" - Etkinlik, takvimdeki zamanı engellemez. Bu, Takvim kullanıcı arayüzündeki Beni şu şekilde göster'i Müsait olarak ayarlamakla eşdeğerdir.
 yazılabilir
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 etkinlik ayrıntıları takvimin tüm okuyucuları tarafından görülebilir.
  • "private": Etkinlik gizlidir ve yalnızca etkinlik katılımcıları etkinlik ayrıntılarını görüntüleyebilir.
  • "confidential" - Etkinlik gizli. Bu değer uyumluluk nedeniyle sağlanmıştır.
 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 Daha fazla 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ındaki 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ışıyor.
  • "customLocation" - Kullanıcı, özel bir konumdan ç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 etkinliği 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.
örnek
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, outOfOffice, focusTime, workingLocation ve fromGmail etkinliklerinin taşınamayacağını unutmayın.
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 edin. 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 atom ya da kademesinden 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.