Events

Calendar API, farklı türde etkinlik kaynakları sağlar. 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 göz atı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 Kimsenin kendisini etkinliğe davet edip edemeyeceği (desteği sonlandırıldı). İsteğe bağlı. Varsayılan, Yanlış değeridir. yazılabilir
attachments[] list Etkinlik için 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 okunur.

Google Drive dosyaları için, 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 eklerken gerekir.

yazılabilir
attachments[].mimeType string Ekin internet ortam türü (MIME türü).
attachments[].title string Ek başlığı.
attendeesOmitted boolean Katılımcıların etkinlik gösteriminden çıkarılıp çıkarılmayacağı. Bir etkinlik alınırken bu durum, maxAttendee sorgu parametresi tarafından belirtilen bir kısıtlamadan kaynaklanıyor olabilir. Bir etkinliği güncellerken, bu yalnızca katılımcının yanıtını güncellemek için kullanılabilir. İsteğe bağlı. Varsayılan, Yanlış değeridir. 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ılavuzunu inceleyin. Hizmet hesapları, katılımcı listesini doldurmak için alan genelinde yetki verme özelliğini kullanmalıdır. 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'ye göre 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 Bunun isteğe bağlı bir katılımcı olup olmadığı. İsteğe bağlı. Varsayılan, Yanlış değeridir. yazılabilir
attendees[].organizer boolean Katılımcının etkinliği düzenleyen kişi olup olmadığı. Salt okunur. Varsayılan, Yanlış değeridir.
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ış değeridir. 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.
yazılabilir
attendees[].self boolean Bu girişin, etkinlik kopyasının göründüğü takvimi temsil edip etmediği. Salt okunur. Varsayılan, Yanlış değeridir.
colorId string Etkinliğin rengi. Bu, renk tanımının event bölümündeki bir girişi gösteren 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ı 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 konferansları takip etmek için kullanılabilir ve kullanıcılara görüntülenmemelidir.

Kimlik değeri her konferans çözümü türü için farklı şekilde oluşturulur:

  • eventHangout: Kimlik ayarlanmamıştır. (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ı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ı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 bilinmeyen veya boş bir türle karşılaşırsa yine de giriş noktalarını görüntüleyebilir. Ancak değişikliklere izin vermemelidir.

Olası değerler şunlardır:

  • Tüketiciler için Hangouts için "eventHangout" (kullanımdan kaldırıldı; mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferanslar oluşturulamaz)
  • Google Workspace kullanıcıları için klasik Hangouts 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 konferans oluşturma ve etkinliğe ekleme isteği. Veriler eşzamansız olarak oluşturulur. Verilerin mevcut olup olmadığını görmek için status alanını kontrol edin.

conferenceSolution ve en az bir entryPoint veya createRequest gereklidir.

conferenceData.createRequest.conferenceSolutionKey nested object Hangouts veya Google Meet gibi bir konferans çözümü.
conferenceData.createRequest.conferenceSolutionKey.type string Konferans çözümü türü.

İstemci bilinmeyen veya boş bir türle karşılaşırsa yine de giriş noktalarını görüntüleyebilir. Ancak değişikliklere izin vermemelidir.

Olası değerler şunlardır:

  • Tüketiciler için Hangouts için "eventHangout" (kullanımdan kaldırıldı; mevcut etkinliklerde bu konferans çözümü türü gösterilebilir ancak yeni konferanslar oluşturulamaz)
  • Google Workspace kullanıcıları için klasik Hangouts 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 yok sayı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ı doldurulur.
  • "failure": Konferans oluşturma isteği başarısız oldu, giriş noktası yok.

conferenceData.entryPoints[] list Ayrı ayrı konferans giriş noktaları hakkında bilgiler (ö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 konferansın sıfır veya bir video giriş noktası olabilir.
  • "phone" - telefon numarasını arayarak bir konferansa katılıyor. 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. Giriş noktası yalnızca more 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: +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 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'si. 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:+12345678900,,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österilecek 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.

Oluşturma isteği başarısız olan bir 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 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 Varsa içerik üreticinin profil kimliği
creator.self boolean Oluşturan kişinin, etkinlik kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunur. Varsayılan, Yanlış değeridir.
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 tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone ürününde saat dilimi açıkça belirtilmedikçe 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 etkinliğin başlangıç/bitişi için özel bir saat dilimini 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 bir bitiş zamanı sağlanır. Varsayılan, Yanlış değeridir.
etag etag Kaynağın ETag.
eventType string Etkinliğin belirli türü. Etkinlik oluşturulduktan sonra bu ayar değiştirilemez. Olası değerler:
  • "default": Normal bir etkinlik veya başka bir yerde belirtilmemiş.
  • "outOfOffice": Ofis dışında etkinliği.
  • "focusTime": Odaklanma zamanı etkinliği.
  • "workingLocation" - Çalışma yeri etkinliği.
Şu anda API kullanılarak yalnızca "default " ve "workingLocation" etkinlikleri oluşturulabilmektedir. Diğer etkinlik türleri için genişletilmiş destek sonraki sürümlerde kullanıma sunulacaktır.
yazılabilir
extendedProperties object Etkinliğin genişletilmiş özellikleri.
extendedProperties.private object Etkinliğin bu takvimde görünen kopyasına özel olan ö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 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'dir; yani hiçbir toplantı davetiyesi reddedilir; declineAllConflictingInvitations, etkinlikle çakışan tüm çakışan toplantı davetiyeleri reddedilir ve declineOnlyNewConflictingInvitations, yalnızca Odaklanma Zamanı etkinliği mevcutken gelen yeni çakışan toplantı davetiyelerinin reddedileceği anlamına gelir.
focusTimeProperties.chatStatus string Chat'te ve ilgili ürünlerde kullanıcıyı işaretlenecek durum. Bu available veya doNotDisturb olabilir.
focusTimeProperties.declineMessage string Mevcut bir etkinliğin veya yeni bir davetiyenin Takvim tarafından otomatik olarak reddedilmesi durumunda kullanılacak yanıt iletisi.
gadget object Bu etkinliğin kapsamını genişleten bir aygıt. Gadget'ların desteği sonlandı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.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 Düzenleyen kişi 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 dışındaki katılımcıların etkinliği değiştirip değiştiremeyeceğini belirler. İsteğe bağlı. Varsayılan, Yanlış değeridir. 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ği. İsteğe bağlı. Varsayılan, Doğru değeridir. yazılabilir
iCalUID string RFC5545'te tanımlandığı şekliyle etkinlik benzersiz tanımlayıcısı. Bu kimlik, takvim sistemleri arasında etkinlikleri benzersiz olarak 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şturma sırasında bunlardan yalnızca birinin sağlanması gerektiğini unutmayın. Anlamları arasındaki farklardan biri, yinelenen etkinliklerde bir etkinliğin geçtiği tüm yerlerde farklı id değerleri olmasına rağmen hepsinin aynı iCalUID değerlerini paylaşmasıdır. iCalUID parametresini kullanarak bir etkinliği almak için events.list yöntemini iCalUID parametresini kullanarak ç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 şu 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 rakamları). 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ış olması nedeniyle, kimlik çakışmalarının etkinlik oluşturma sırasında tespit edileceğini garanti edemeyiz. Çakışma riskini en aza indirmek için RFC4122'de açıklanan gibi yerleşik bir UUID algoritması kullanmanızı öneririz.

Bir kimlik belirtmezseniz sunucu tarafından otomatik olarak oluşturulur.

icalUID ve id özelliklerinin aynı olmadığını ve etkinlik oluşturma sırasında bunlardan yalnızca birinin sağlanması gerektiğini unutmayın. Anlamları arasındaki farklardan biri, yinelenen etkinliklerde bir etkinliğin geçtiği tüm yerlerde farklı id değerleri olmasına rağmen hepsinin aynı icalUID değerlerini paylaşmasıdır.

yazılabilir
kind string Kaynağın türü ("calendar#event").
location string Etkinliğin serbest biçimli metin olarak 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ış değeridir. Salt okunur.
organizer object Etkinliği düzenleyen kullanıcı. Düzenleyen kullanıcı aynı zamanda bir katılımcıysa bu, attendees içinde organizer alanı Doğru değerine 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ılması hariç). yazılabilir
organizer.displayName string Varsa düzenleyenin adı. yazılabilir
organizer.email string Varsa düzenleyenin e-posta adresi. RFC5322'ye göre 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üğü takvimle ilişkili olup olmadığı. Salt okunur. Varsayılan, Yanlış değeridir.
originalStartTime nested object Yinelenen bir etkinliğin örneği için bu, bu etkinliğin, reportingEventId tarafından tanımlanan yinelenen etkinlikteki tekrarlama verilerine göre başlayacağı zamandır. Farklı bir zamana taşınmış bile olsa yinelenen etkinlik serisindeki örneği benzersiz bir ş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 tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone ürününde saat dilimi açıkça belirtilmedikçe 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 etkinliğin başlangıç/bitişi 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 Ofis dışında etkinlikleri çakışan toplantı davetiyelerinin reddedilip reddedilmeyeceğini belirler. Geçerli değerler declineNone'dir; 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 varken gelen yeni çakışan toplantı davetiyelerinin reddedileceği anlamına gelir.
outOfOfficeProperties.declineMessage string Mevcut bir etkinliğin veya yeni bir davetiyenin Takvim tarafından otomatik olarak reddedilmesi durumunda kullanılacak yanıt iletisi.
privateCopy boolean Doğru değerine ayarlanırsa Etkinlik yayılımı devre dışı bırakılır. Bunun Gizli etkinlik özellikleri ile aynı şey olmadığını unutmayın. İsteğe bağlı. Sabit. Varsayılan, Yanlış değeridir.
recurrence[] list RFC5545'te belirtildiği şekilde, düzenli bir etkinliğin 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 Yinelenen 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 etkinliğe özel hatırlatıcılar listelenir. Etkinlik ayarlanmazsa bu etkinlik için herhangi bir hatırlatıcı ayarlanmadı demektir. En fazla 5 geçersiz kılma hatırlatıcısı kullanılabilir. 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'ı yoluyla gönderilir.

Hatırlatıcı eklerken zorunludur.

yazılabilir
reminders.overrides[].minutes integer Etkinlik başlamadan kaç dakika önce hatırlatıcı tetikleneceğ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 mesajı veya HTTP ya da HTTPS şemasına sahip bir URL ile 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ğı 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 tarih-saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone ürününde saat dilimi açıkça belirtilmedikçe 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 etkinliğin başlangıç/bitişi 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 döndürür (syncToken veya updatedMin belirtildiğinde) ya da showDeleted işareti true olarak ayarlanmışsa. 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:

    1. İptal edilmeyen bir düzenli etkinliğe ilişkin iptal edilen istisnalar, bu örneğin artık kullanıcıya sunulmaması gerektiğini gösterir. Müşteriler bu etkinlikleri, yinelenen üst 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.

    2. İptal edilen diğer tüm etkinlikler, silinen etkinlikleri temsil eder. İstemciler, yerel olarak senkronize edilen kopyalarını kaldırmalıdır. Bu tür iptal edilen etkinlikler zaman içinde kaybolacaktır, bu nedenle bunların süresiz olarak kullanılabilir olacağına güvenmeyin.

      Silinen etkinliklerde yalnızca id alanının doldurulması garanti edilir.

    İptal edilen etkinlikler, geri yüklenebilmesi (silme işlemi geri alınabilmesi) için etkinlik ayrıntılarını (özet, konum vb.) düzenleyen kullanıcının takviminde göstermeye devam eder. Benzer şekilde, kullanıcının davet edildiği ve manuel olarak kaldırıldığı etkinliklerde de ayrıntılı bilgi gösterilmeye 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 (ör. taşıma işlemiyle) ve orijinal düzenleyen kullanıcı, katılımcı listesinde değilse yalnızca id alanının doldurulmasının garanti edildiği, iptal edilmiş bir etkinlik geride kalır.

yazılabilir
summary string Etkinliğin adı. yazılabilir
transparency string Etkinliğin takvimde zamanı engelleyip engellemeyeceğini belirtir. İsteğe bağlı. Olası değerler:
  • "opaque" - Varsayılan değer. Etkinlik takvimde zamanı engeller. Bu, Takvim kullanıcı arayüzündeki Beni ş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 ayarlamakla eşdeğerdir.
yazılabilir
updated datetime Etkinliğin son değiştirme zamanı (RFC3339 zaman damgası olarak). 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 özeldir ve etkinlik ayrıntılarını yalnızca etkinlik katılımcıları görebilir.
  • "confidential" - Etkinlik gizlidir. 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ı fazladan 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ı 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ısı. 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österilen ofis adı. Kuruluşun Kaynaklar veritabanında bir bina adına referans vermenizi ö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 konumdan çalışıyor.
Belirtilen adın bir alt alanında tüm ayrıntılar belirtilir ancak bu alan boşsa eksik olabilir. Diğer alanlar yoksayılır.

Çalışma yeri mülkleri eklerken zorunludur.

yazılabilir

Yöntemler

sil
Bir etkinliği siler.
al
Google Takvim Kimliğine dayalı olarak bir etkinlik döndürür. iCalendar kimliğini kullanarak bir etkinliği 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 özel kopyasını takvime eklemek için kullanı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. bir 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; 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ı belirtilirse, mevcut dizilerin üzerine yazılır. Bu işlem, önceki dizi öğelerini siler.
quickAdd
Basit bir metin dizesine dayalı etkinlik oluşturur.
güncelleme
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 atomiklik sağlamak için etag'leri kullanarak update işlemi gerçekleştirin.
saat
Etkinlik kaynaklarında yapılan değişiklikleri takip edin.