Events

Calendar API, etkinlik kaynaklarının farklı çeşitlerini sağlar. Daha fazla bilgiyi Etkinlikler hakkında bölümünde bulabilirsiniz.

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

Kaynak temsilleri

{
  "kind": "calendar#event",
  "etag": etag,
  "id": string,
  "status": string,
  "htmlLink": string,
  "created": datetime,
  "updated": datetime,
  "summary": string,
  "description": string,
  "location": string,
  "colorId": string,
  "creator": {
    "id": string,
    "email": string,
    "displayName": string,
    "self": boolean
  },
  "organizer": {
    "id": string,
    "email": string,
    "displayName": string,
    "self": boolean
  },
  "start": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "end": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "endTimeUnspecified": boolean,
  "recurrence": [
    string
  ],
  "recurringEventId": string,
  "originalStartTime": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "transparency": string,
  "visibility": string,
  "iCalUID": string,
  "sequence": integer,
  "attendees": [
    {
      "id": string,
      "email": string,
      "displayName": string,
      "organizer": boolean,
      "self": boolean,
      "resource": boolean,
      "optional": boolean,
      "responseStatus": string,
      "comment": string,
      "additionalGuests": integer
    }
  ],
  "attendeesOmitted": boolean,
  "extendedProperties": {
    "private": {
      (key): string
    },
    "shared": {
      (key): string
    }
  },
  "hangoutLink": string,
  "conferenceData": {
    "createRequest": {
      "requestId": string,
      "conferenceSolutionKey": {
        "type": string
      },
      "status": {
        "statusCode": string
      }
    },
    "entryPoints": [
      {
        "entryPointType": string,
        "uri": string,
        "label": string,
        "pin": string,
        "accessCode": string,
        "meetingCode": string,
        "passcode": string,
        "password": string
      }
    ],
    "conferenceSolution": {
      "key": {
        "type": string
      },
      "name": string,
      "iconUri": string
    },
    "conferenceId": string,
    "signature": string,
    "notes": string,
  },
  "gadget": {
    "type": string,
    "title": string,
    "link": string,
    "iconLink": string,
    "width": integer,
    "height": integer,
    "display": string,
    "preferences": {
      (key): string
    }
  },
  "anyoneCanAddSelf": boolean,
  "guestsCanInviteOthers": boolean,
  "guestsCanModify": boolean,
  "guestsCanSeeOtherGuests": boolean,
  "privateCopy": boolean,
  "locked": boolean,
  "reminders": {
    "useDefault": boolean,
    "overrides": [
      {
        "method": string,
        "minutes": integer
      }
    ]
  },
  "source": {
    "url": string,
    "title": string
  },
  "workingLocationProperties": {
    "type": string,
    "homeOffice": (value),
    "customLocation": {
      "label": string
    },
    "officeLocation": {
      "buildingId": string,
      "floorId": string,
      "floorSectionId": string,
      "deskId": string,
      "label": string
    }
  },
  "attachments": [
    {
      "fileUrl": string,
      "title": string,
      "mimeType": string,
      "iconLink": string,
      "fileId": string
    }
  ],
  "eventType": string
}
Mülk adı Değer Açıklama Notlar
anyoneCanAddSelf boolean Katılımcıların kendilerini etkinliğe davet edip edemeyeceği (kullanımdan kaldırıldı). İsteğe bağlı. Varsayılan, False değeridir. yazılabilir
attachments[] list Etkinlik için dosya ekleri.

Eklerin değiştirilebilmesi için supportsAttachments istek parametresi true olarak ayarlanmalıdır.

Etkinlik başına en fazla 25 ek olabilir,

attachments[].fileId string Ekli dosyanın kimliği. Salt okunur.

Google Drive dosyaları için bu, Drive API'sindeki 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ğinde kullanılan biçimi kullanın.

Ek ekleyebilirsiniz.

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ığı. Bu durum bir etkinliği alırken maxAttendee sorgu parametresi tarafından belirtilen bir kısıtlamadan kaynaklanıyor olabilir. Bu özellik, bir etkinliği güncellerken yalnızca katılımcının yanıtını güncellemek için kullanılabilir. İsteğe bağlı. Varsayılan, False 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ılarla etkinlikler kılavuzunu inceleyin. Hizmet hesaplarının, katılımcı listesini doldurmak için alan genelinde yetki verme özelliğini kullanması gerekir. yazılabilir
attendees[].additionalGuests integer Ek konuk sayısı. İsteğe bağlı. Varsayılan değer 0'dır. yazılabilir
attendees[].comment string Katılımcının yanıt yorumu. İsteğe bağlı. yazılabilir
attendees[].displayName string Katılımcının adı (varsa). İsteğe bağlı. yazılabilir
attendees[].email string Katılımcının e-posta adresi (varsa). Bu alan, katılımcı eklerken bulunmalı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 Katılımcının profil kimliği (varsa).
attendees[].optional boolean İsteğe bağlı bir katılımcı olup olmadığınız. İsteğe bağlı. Varsayılan, False değeridir. yazılabilir
attendees[].organizer boolean Katılımcının etkinliği düzenleyen kişi olup olmadığı. Salt okunur. Varsayılan, False değeridir.
attendees[].resource boolean Katılımcının kaynak olup olmadığı. Yalnızca katılımcı etkinliğe ilk kez eklendiğinde ayarlanabilir. Sonraki değişiklikler yok sayılır. İsteğe bağlı. Varsayılan, False 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 etmiştir.
  • "accepted": Katılımcı davetiyeyi kabul etmiştir.
yazılabilir
attendees[].self boolean Etkinliğin bu kopyasının göründüğü takvimi temsil edip etmediği. Salt okunur. Varsayılan, False değeridir.
colorId string Etkinliğin rengi. Bu, renk tanımının event bölümündeki bir girişe referans veren bir kimliktir ( renk 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 korumak için tüm etkinlik değişikliği isteklerinde conferenceDataVersion istek parametresini 1 olarak ayarlamayı unutmayın. yazılabilir
conferenceData.conferenceId string Konferansın kimliği.

Konferansları takip etmek için geliştiriciler tarafından 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. Örneğin, 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 Google Meet gibi konferans çözümü.

Başarısız oluşturma isteği içeren bir konferansın 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ı tarafından görülebilen simge.
conferenceData.conferenceSolution.key nested object Bu etkinliğin konferans çözümünü benzersiz şekilde tanımlayabilen anahtar.
conferenceData.conferenceSolution.key.type string Konferans çözümü türü.

Bir müşteri, tanımadığı veya boş bir türle karşılaşırsa yine de giriş noktalarını gösterebilmelidir. Ancak, değişikliklere izin vermemelidir.

Olası değerler:

  • Tüketiciler için Hangouts "eventHangout" (kullanımdan kaldırıldı; mevcut etkinlikler bu konferans çözümü türünü gösterebilir ancak yeni konferanslar oluşturulamaz)
  • Google Workspace için klasik Hangouts kullanıcıları için "eventNamedHangout" (kullanımdan kaldırıldı; mevcut etkinlikler bu konferans çözümü türünü gösterebilir ancak yeni konferanslar oluşturulamaz)
  • Google Meet için "hangoutsMeet" (http://meet.google.com)
  • Üçüncü taraf konferans sağlayıcıları için "addOn"

conferenceData.conferenceSolution.name string Bu çözümün kullanıcı tarafından görülebilen adı. Yerelleştirilmemiş.
conferenceData.createRequest nested object Yeni bir konferans oluşturma ve bunu etkinliğe ekleme isteği. Veriler eşzamansız olarak oluşturulur. Verilerin mevcut olup olmadığını görmek için status alanını kontrol edin.

conferenceSolution ve en az bir entryPoint veya createRequest gereklidir.

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

Bir müşteri, tanımadığı veya boş bir türle karşılaşırsa yine de giriş noktalarını gösterebilmelidir. Ancak, değişikliklere izin vermemelidir.

Olası değerler:

  • Tüketiciler için Hangouts "eventHangout" (kullanımdan kaldırıldı; mevcut etkinlikler bu konferans çözümü türünü gösterebilir ancak yeni konferanslar oluşturulamaz)
  • Google Workspace için klasik Hangouts kullanıcıları için "eventNamedHangout" (kullanımdan kaldırıldı; mevcut etkinlikler bu konferans çözümü türünü gösterebilir 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.

Müşteriler, her yeni istek için bu kimliği yeniden oluşturmalıdır. Sağlanan kimlik önceki istekle aynıysa istek dikkate alınmaz.

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:

  • "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 URL'ler veya telefon numaraları gibi bağımsız konferans giriş noktaları hakkında bilgiler.

Hepsi aynı konferansta yer almalı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 konferans sağlayıcısının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının yalnızca bir alt kümesini doldurun. Yalnızca doldurulan alanlar gösterilmelidir.

İsteğe bağlı.

conferenceData.entryPoints[].entryPointType string Konferans giriş noktasının türü.

Olası değerler:

  • "video" - Konferansa HTTP üzerinden katılınıyor. Bir konferansta sıfır veya bir video giriş noktası olabilir.
  • "phone" - Telefon numarası çevirerek konferansa katılma. Bir konferansta sıfır veya daha fazla phone giriş noktası olabilir.
  • "sip" - SIP üzerinden konferansa katılma. Bir konferansta sıfır veya bir sip giriş noktası olabilir.
  • "more" - Diğer konferans birleştirme talimatları (ör. ek telefon numaraları). Bir konferansta sıfır veya bir more giriş noktası olabilir. Yalnızca more giriş noktasına sahip bir konferans, geçerli bir konferans değil.

conferenceData.entryPoints[].label string URI etiketi. Son kullanıcılara görünür. 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 kullanılan toplantı kodu. Maksimum uzunluk 128 karakterdir.

Yeni konferans verileri oluştururken konferans sağlayıcısının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının yalnızca bir alt kümesini doldurun. Yalnızca doldurulan alanlar gösterilmelidir.

İ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 konferans sağlayıcısının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının yalnızca bir alt kümesini doldurun. Yalnızca doldurulan alanlar gösterilmelidir.

conferenceData.entryPoints[].password string Konferansa erişim için şifre. Maksimum uzunluk 128 karakterdir.

Yeni konferans verileri oluştururken konferans sağlayıcısının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının yalnızca bir alt kümesini doldurun. Yalnızca doldurulan alanlar gösterilmelidir.

İ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 konferans sağlayıcısının kullandığı terminolojiyle eşleşen {meetingCode, accessCode, passcode, password, pin} alanlarının yalnızca bir alt kümesini doldurun. Yalnızca doldurulan alanlar gösterilmelidir.

İ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ı gerekir.
  • phone için tel: şeması gerekiyor. URI, arama dizisinin tamamını içermelidir (ör. tel:+12345678900,,123456789;1234).
  • sip için sip: şeması gereklidir, ör. sip:12345678@myprovider.com.
  • more, http: veya https: şeması gerekir.

conferenceData.notes string Kullanıcıya gösterilecek ek notlar (alan yöneticisinden talimatlar, yasal uyarılar gibi). HTML içerebilir. Maksimum uzunluk 2048 karakterdir. İsteğe bağlı.
conferenceData.signature string Konferans verilerinin imzası.

Sunucu tarafında oluşturulur.

Başarısız oluşturma isteği içeren bir konferansın ayarı kaldırılır.

Bekleyen oluşturma isteği içeren bir konferans 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 Etkinliği oluşturan kişinin, etkinliğin bu kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunur. Varsayılan, False değeridir.
description string Etkinliğin açıklaması. HTML içerebilir. İsteğe bağlı. yazılabilir
end nested object Etkinliğin (özel) bitiş zamanı. Yinelenen 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çimindeki tarih. yazılabilir
end.dateTime datetime Birleşik bir tarih/saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone içinde açıkça belirtilen bir saat dilimi olmadığı sürece saat dilimi farkı gereklidir. yazılabilir
end.timeZone string Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan gereklidir ve yinelenmenin genişletildiği saat dilimi belirtilir. Tekli etkinlikler için bu alan isteğe bağlıdır ve etkinlik 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 True olarak ayarlanmış olsa bile uyumluluk nedeniyle bitiş zamanı sağlanır. Varsayılan, False değeridir.
etag etag Kaynağın eTag'i.
eventType string Etkinliğin belirli bir türü. Etkinlik oluşturulduktan sonra bu alan adı değiştirilemez. Olası değerler:
  • "default": Normal bir etkinlik veya Belirtilmemiş.
  • "outOfOffice": Ofis dışında etkinliği.
  • "focusTime": Odaklanma zamanı etkinliği.
  • "workingLocation": Bir çalışma yeri etkinliği.
Şu anda API kullanılarak yalnızca "default " ve "workingLocation" etkinlikleri oluşturulabilir. Diğer etkinlikler 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 Bu takvimde görünen etkinliğin kopyasına özel özellikler. yazılabilir
extendedProperties.private.(key) string Özel mülkün adı ve buna karşılık gelen değer.
extendedProperties.shared object Diğer katılımcıların takvimlerinde etkinliğin kopyaları arasında paylaşılan özellikler. yazılabilir
extendedProperties.shared.(key) string Paylaşılan mülkün adı ve buna karşılık gelen değer.
gadget object Bu etkinliği uzatan bir gadget. Gadget'lar kullanımdan kaldırılmıştır. Bunun yerine bu yapı yalnızca doğum günü takvimi meta verilerini döndürmek için kullanılır.
gadget.display string Gadget'ın görüntüleme 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 cinsinde 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 cinsinde genişliği. Genişlik 0'dan büyük bir tam sayı olmalıdır. İsteğe bağlı. Kullanımdan kaldırıldı. yazılabilir
guestsCanInviteOthers boolean Etkinliği düzenleyenin dışındaki katılımcıların etkinliğe başkalarını davet edip edemeyeceği. İsteğe bağlı. Doğru, varsayılan değerdir. yazılabilir
guestsCanModify boolean Etkinliği düzenleyen kullanıcı dışındaki katılımcıların etkinliği değiştirip değiştiremeyeceği. İsteğe bağlı. Varsayılan, False değeridir. yazılabilir
guestsCanSeeOtherGuests boolean Etkinliği düzenleyenin dışındaki katılımcıların, etkinliğin katılımcılarının kim olduğunu görüp göremeyeceği. İsteğe bağlı. Doğru, varsayılan değerdir. yazılabilir
iCalUID string RFC5545'te tanımlanan, etkinlik benzersiz tanımlayıcısı. Takvim sistemleri genelinde etkinlikleri benzersiz şekilde tanımlamak için kullanılır ve içe aktarma yöntemi aracılığıyla etkinlikleri içe aktarırken sağlanmalıdır.

iCalUID ve id aynı değildir ve etkinlik oluşturma sırasında bunlardan yalnızca biri sağlanmalıdır. Anlamsal farklardan biri, düzenli etkinliklerde bir etkinliğin tüm tekrarlarının farklı id olmasıdır, ancak bunların tümü aynı iCalUIDs ile aynıdır. Bir etkinliği iCalUID kullanarak almak için events'i iCalUID parametresini kullanarak ç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 tek veya düzenli etkinlikler oluştururken bu kişilerin kimliklerini belirtebilirsiniz. Sağlanan kimlikler şu kurallara uymalıdır:
  • Kimlikte izin verilen karakterler Base32Onaltılık kodlamada kullanılan karakterlerdir (ör. küçük harfler a-v ve rakam 0-9). RFC2938'deki bölüm 3.1.2'ye bakın.
  • Kimliğin uzunluğu 5-1.024 karakter arasında olmalıdır
  • Kimlik her takvim için benzersiz olmalıdır
Sistemin küresel olarak dağıtılmış yapısı nedeniyle kimlik çakışmalarının etkinlik oluşturma sırasında tespit edileceğini garanti edemeyiz. Çarpışma riskini en aza indirmek için RFC4122'de açıklananya benzer bir UUID algoritması kullanmanızı öneririz.

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

icalUID ve id aynı değildir ve etkinlik oluşturma sırasında bunlardan yalnızca biri sağlanmalıdır. Anlamsal farklardan biri, düzenli etkinliklerde bir etkinliğin tüm tekrarlarının farklı id olmasıdır, ancak bunların tümü aynı icalUIDs ile aynıdır.

yazılabilir
kind string Kaynağın türü ("calendar#event").
location string Serbest biçimli metin olarak etkinliğin coğrafi konumu. İsteğe bağlı. yazılabilir
locked boolean Bu durumun "özet", "açıklama", "konum", "başlangıç", "bitiş" veya "yineleme" ana etkinlik alanlarında değişiklik yapılamayan kilitli bir etkinlik kopyası olup olmadığı. Varsayılan, False değeridir. Salt Okunur.
organizer object Etkinliği düzenleyen kullanıcı. Toplantıyı düzenleyen kişi de katılımcıysa bu durum attendees içinde, organizer alanı Doğru değerine ayarlanmış ayrı bir girişle gösterilir. Düzenleyeni değiştirmek için taşıma işlemini kullanın. Bir etkinliği içe aktarma hariç, salt okunur. yazılabilir
organizer.displayName string Düzenleyenin adı (varsa). yazılabilir
organizer.email string Düzenleyen kullanıcının e-posta adresi (varsa). RFC5322'ye göre geçerli bir e-posta adresi olmalıdır. yazılabilir
organizer.id string Düzenleyen kullanıcının profil kimliği (varsa).
organizer.self boolean Etkinliği düzenleyen kişinin, etkinliğin bu kopyasının göründüğü takvime karşılık gelip gelmediği. Salt okunur. Varsayılan, False değeridir.
originalStartTime nested object Yinelenen bir etkinlik örneği söz konusuysa 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çimindeki tarih. yazılabilir
originalStartTime.dateTime datetime Birleşik bir tarih/saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone içinde açıkça belirtilen bir saat dilimi olmadığı sürece saat dilimi farkı gereklidir. yazılabilir
originalStartTime.timeZone string Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan gereklidir ve yinelenmenin genişletildiği saat dilimi belirtilir. Tekli etkinlikler için bu alan isteğe bağlıdır ve etkinlik başlangıcı/bitişi için özel bir saat dilimi belirtir. yazılabilir
privateCopy boolean Politika, Doğru değerine ayarlanırsa Etkinlik yayılımı devre dışı bırakılır. Bunun Gizli etkinlik özellikleri ile aynı olmadığını unutmayın. İsteğe bağlı. Sabit. Varsayılan, False değeridir.
recurrence[] list RFC5545'te belirtildiği gibi, düzenli bir etkinliğe ait RCSR, EXCSR, 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 tek etkinlikler veya yinelenen etkinliklerin örnekleri için çıkarılır. yazılabilir
recurringEventId string Yinelenen bir etkinliğin örneği söz konusu olduğunda, bu etkinliğin ait olduğu yinelenen etkinliğin id oranıdır. Sabit.
reminders object Kimliği doğrulanmış kullanıcının etkinlik hatırlatıcılarıyla ilgili bilgiler.
reminders.overrides[] list Etkinlik varsayılan hatırlatıcıları kullanmıyorsa bu ayar, etkinliğe özel hatırlatıcıları listeler veya ayarlanmazsa bu etkinlik için hiçbir hatırlatıcının ayarlanmadığını gösterir. Geçersiz kılma hatırlatıcılarının maksimum sayısı 5'tir. yazılabilir
reminders.overrides[].method string Bu hatırlatıcının kullandığı yöntem. Olası değerler:
  • "email": Hatırlatıcılar e-postayla gönderilir.
  • "popup": Hatırlatıcılar, kullanıcı arayüzü pop-up'ı aracılığıyla gönderilir.

Hatırlatıcı eklerken gereklidir.

yazılabilir
reminders.overrides[].minutes integer Hatırlatıcının tetikleneceği etkinliğin başlangıcından önceki dakika sayısı. Geçerli değerler 0 ile 40320 arasındadır (dakika cinsinden 4 hafta).

Hatırlatıcı eklerken gereklidir.

yazılabilir
reminders.useDefault boolean Takvimin varsayılan hatırlatıcılarının etkinlik için geçerli olup olmadığı. yazılabilir
sequence integer iCalendar'a uygun 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ıyla bir URL'yle tanımlanabilen herhangi bir doküman. Yalnızca etkinliği oluşturan kullanıcı 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ğı gösteren kaynağın URL'si. URL şeması HTTP veya HTTPS olmalıdır. yazılabilir
start nested object Etkinliğin (dahil) başlangıç zamanı. Yinelenen 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çimindeki tarih. yazılabilir
start.dateTime datetime Birleşik bir tarih/saat değeri olarak saat (RFC3339'a göre biçimlendirilmiştir). timeZone içinde açıkça belirtilen bir saat dilimi olmadığı sürece saat dilimi farkı gereklidir. yazılabilir
start.timeZone string Saatin belirtildiği saat dilimi. (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Avrupa/Zürih".) Yinelenen etkinlikler için bu alan gereklidir ve yinelenmenin genişletildiği saat dilimi belirtilir. Tekli etkinlikler için bu alan isteğe bağlıdır ve etkinlik 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, iptal edilen etkinlikleri yalnızca artımlı senkronizasyonla (syncToken veya updatedMin belirtildiğinde) ya da showDeleted işareti true olarak ayarlanmışsa 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 düzenli etkinliğin iptal edilmiş istisnaları, bu örneğin artık kullanıcıya sunulmaması gerektiğini gösterir. Müşteriler, bu etkinlikleri düzenli olarak üst etkinliğin düzenlendiği süre boyunca saklamalıdır.

      İptal edilen istisnaların yalnızca id, recurringEventId ve originalStartTime alanlarının değerlerinin olacağı garanti edilir. Diğer alanlar boş olabilir.

    2. İptal edilen diğer tüm etkinlikler silinen etkinlikleri temsil eder. Müşteriler, yerel olarak senkronize edilmiş kopyalarını kaldırmalıdır. İptal edilen bu etkinlikler zaman içinde kaybolacaklarından, bunların süresiz olarak kullanılabilir olmasına güvenmeyin.

      Silinen etkinliklerin yalnızca id alanının doldurulacağı garanti edilir.

    Düzenleyen kişinin takviminde, iptal edilen etkinliklerin geri yüklenebilmesi (silinmesi) için etkinlik ayrıntıları (özet, konum vb.) gösterilir. Benzer şekilde, kullanıcının davet edildiği ve manuel olarak kaldırdığı etkinlikler de ayrıntı sağlamaya devam eder. Ancak, showDeleted yanlış değerine ayarlanmış artımlı senkronizasyon istekleri bu ayrıntıları döndürmez.

    Bir etkinliği düzenleyeni değiştirirse (örneğin, taşıma işlemiyle) ve orijinal düzenleyen, katılımcı listesinde değilse yalnızca id alanının doldurulmasının garanti edildiği iptal edilmiş bir etkinlik kalır.

yazılabilir
summary string Etkinliğin adı. yazılabilir
transparency string Etkinliğin takvimdeki zamanı engelleyip engellemediği. İsteğe bağlı. Olası değerler:
  • "opaque": Varsayılan değer. Etkinlik, takvimde zamanı engeller. Bu, Takvim kullanıcı arayüzünde Beni şu şekilde göster seçeneğinin Meşgul olarak ayarlanmasına eşdeğerdir.
  • "transparent": Etkinlik, takvimde zamanı engellemez. Bu, Takvim kullanıcı arayüzünde Beni şu şekilde göster seçeneğinin Kullanılabilir olarak ayarlanmasıyla eşdeğerdir.
yazılabilir
updated datetime Etkinliğin son değiştirilme zamanı (RFC3339 zaman damgası olarak). Salt okunur.
visibility string Etkinliğin görünürlüğü. İsteğe bağlı. Olası değerler:
  • "default": Takvimdeki etkinliklerin varsayılan görünürlüğünü 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 etkinlik ayrıntılarını yalnızca etkinlik katılımcıları görüntüleyebilir.
  • "confidential": Etkinlik gizli. 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 etikettir. 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 ofiste çalıştığını gösterir. yazılabilir
workingLocationProperties.officeLocation.buildingId string İsteğe bağlı bir bina tanımlayıcısı. Bu, kuruluşun Kaynaklar veritabanında bir bina kimliğine referans vermelidir. 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ı bir kat tanımlayıcı. yazılabilir
workingLocationProperties.officeLocation.floorSectionId string İsteğe bağlı kat bölümü tanımlayıcısı. yazılabilir
workingLocationProperties.officeLocation.label string Takvim Web ve Mobil istemcilerinde gösterilen ofis adı. Kuruluşun Kaynaklar veritabanındaki bir bina adına başvurmanızı ö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ışıyordur.
Tüm ayrıntılar, belirtilen adın bir alt alanında belirtilir ancak bu alan boşsa eksik olabilir. Diğer alanlar yok sayılır.

Çalışma yeri özellikleri eklenirken gerekir.

yazılabilir

Yöntemler

sil
Bir etkinliği siler.
al
Google Takvim kimliğini temel alarak bir etkinlik döndürür. Bir etkinliği iCalendar kimliğini kullanarak almak için iCalUID parametresini kullanarak event.list yöntemini çağırın.
içe aktar
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
Bir 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şırsa (ör. etkinliği düzenleyen kullanıcıyı değiştirdiyse).
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 birimleri kullanmanız önerilir. Belirttiğiniz alan değerleri mevcut değerlerin yerini alır. İstekte belirtmediğiniz alanlar değiştirilmez. Dizi alanları, belirtilirse mevcut dizilerin üzerine yazılır. Bu, önceki dizi öğelerini siler.
hızlı ekleme
Basit bir metin dizesine göre etkinlik oluşturur.
güncelle
Bir etkinliği günceller. Bu yöntem, yama semantiğini desteklemez ve her zaman etkinlik kaynağının tamamını günceller. Kısmi güncelleme yapmak için get etiketini ve ardından update etiketini kullanarak etkinlik olmadığından emin olun.
izleyin
Etkinlik kaynaklarında yapılan değişiklikleri takip edin.