Etkinlik nesneleri

Bu sayfada, Google Workspace Eklentileri etkinlik nesnelerinin yapısı ana hatlarıyla açıklanmaktadır.

Etkinlik nesneleri, kullanıcı bir eklentiyle etkileşimde bulunduğunda otomatik olarak oluşturulan ve tetiklemek veya geri çağırma işlevlerini tetiklemek için parametre olarak iletilen JSON yapılarıdır. Etkinlik nesneleri, ana makine uygulamasıyla ilgili istemci taraflı bilgileri ve geçerli bağlamı eklentinin sunucu tarafı geri çağırma işlevine taşır.

Google Workspace Eklentileri, aşağıdaki yerlerde etkinlik nesnelerini kullanır:

  • Ana sayfa tetikleyicileri. Ana sayfa tetikleyici işlevi etkinleştirildiğinde, tanımladığınız her homepageTrigger işlevine otomatik olarak bir etkinlik nesnesi iletilir. Etkin ana makine uygulamasını, istemcinin platformunu, kullanıcı yerel ayarını ve diğer bilgileri tanımlamak için bu nesneyi ana sayfa tetikleyici işlevinizde kullanabilirsiniz.

    Ana sayfa tetikleyicileri etkinleştiğinde oluşturulan etkinlik nesneleri, diğer iki durumdaki tüm alanları içermez; widget'lar ve bağlamsal bilgilerle ilgili alanlar çıkarılır.

  • Bağlamsal tetikleyiciler. Her ana makine uygulaması, kullanıcı belirli bir bağlam girdiğinde tetiklenen farklı bir bağlamsal tetikleyici grubu sağlar. Örneğin:

    İçeriğe dayalı bir tetikleyici etkinleştiğinde, ana makine uygulaması, eklentinin manifest dosyasında listelenen karşılık gelen runFunction öğesini çağırarak bunu parametre olarak bir etkinlik nesnesi iletir. Bağlamsal tetikleyiciler etkinleştiğinde oluşturulan etkinlik nesneleri, ana sayfa tetikleyici etkinlik nesnelerinde bulunan tüm alanların yanı sıra bağlamsal bilgiler içeren alanları içerir.

  • Widget işlemleri. Etkinlik nesneleri, Gmail eklentilerinin kullandığı eylem modelini kullanarak widget etkileşimi sağlamak için de kullanılır. Google Workspace Eklentileri, aynı widget işleyici işlevlerini, Action nesnelerini ve işlem yanıtlarını kullanır. Ancak Google Workspace eklentilerindeki işlem etkinliği nesneleri, bir geri çağırma işlevinin işlem yapabileceği daha fazla bilgi içerir.

    Widget işlemlerinin sonucunda oluşturulan etkinlik nesneleri, bağlamsal tetikleyici etkinlik nesnelerinde yer alan tüm alanların yanı sıra widget bilgilerini içeren alanları da içerir.

  • Bağlantı tetikleyicilerini önizleme. Google Dokümanlar, E-Tablolar ve Slaytlar'da, üçüncü taraf hizmetleri için bağlantı önizlemelerini belirli URL kalıplarına göre yapılandırabilirsiniz. Kullanıcılar kalıba uyan bir bağlantıyla etkileşimde bulunduğunda linkPreviewTriggers etkinleşir ve bağlantıyı içeren bir etkinlik nesnesi tetikleyicinin geri çağırma işlevine aktarılır. Eklentiniz, ana makine uygulamasında bağlantıyla ilgili bilgileri ortaya çıkaran akıllı bir çip ve kart oluşturmak için bu etkinlik nesnesini kullanabilir. Ayrıca, kullanıcıların önizleme kartı ve içeriğiyle etkileşim kurmalarına olanak tanımak için widget işlemleri de oluşturabilirsiniz.

Etkinlik nesne yapısı

Aşağıdaki tabloda Google Workspace Eklentileri etkinlik nesnelerinin üst düzey yapısı açıklanmaktadır. Etkinlik nesne yapısı, ana makineden bağımsız bilgiler için üst düzey bir commonEventObject alanı içerir. Her etkinlik nesnesi, etkin ana makine uygulaması tarafından belirlenen, ana makineye özgü şu üst düzey alanlardan birine de sahip olabilir: gmailEventObject, calendarEventObject veya driveEventObject.

Geriye dönük uyumluluk için Google Workspace Eklentileri etkinlik nesneleri, Gmail eklentisi işlem etkinliği nesnelerinde kullanılan tüm orijinal alanları da içerir. Bu alanlar, aşağıdaki "Orijinal Gmail eklenti alanları" altındaki tabloda listelenmiştir; bu alanlardaki bilgiler yeni nesne yapısında yeniden oluşturulur.

Etkinlik nesnesi
eventObject.commonEventObject Common fields object
Ana makine uygulamasından bağımsız olarak tüm etkinlik nesnelerinde ortak olan bilgileri içeren bir nesne.
eventObject.calendar Calendar event object
Yalnızca aramayı düzenleyen kişi Google Takvim ise mevcut olacak. Takvim ve etkinlik bilgilerini içeren bir nesne.
eventObject.drive Drive event object
Yalnızca aramayı düzenleyen kişi Google Drive ise mevcut olmalıdır. Drive bilgilerini içeren bir nesne.
eventObject.gmail Gmail event object
Yalnızca aramayı düzenleyen Gmail ise mevcut olmalıdır. Gmail bilgilerini içeren bir nesne.
eventObject.docs Docs event object
Yalnızca aramayı düzenleyen Google Dokümanlar ise mevcut olmalıdır. Dokümanlar bilgilerini içeren bir nesne.
eventObject.sheets Sheets event object
Yalnızca çağrıyı düzenleyen kişi Google E-Tablolar ise mevcut olmalıdır. E-Tablolar bilgilerini içeren bir nesne.
eventObject.slides Slides event object
Yalnızca toplantıyı düzenleyen kişi Google Slaytlar ise mevcut olmalıdır. Slaytlar bilgilerini içeren bir nesne.
Orijinal Gmail eklenti alanları
eventObject.messageMetadata.accessToken string
Kullanımdan kaldırıldı. Erişim jetonu. Geçici Gmail eklenti kapsamlarını kullanarak kullanıcı verilerine erişimi etkinleştirmek için bunu kullanabilirsiniz.

Google Workspace eklentileri için eventObject.gmail.accessToken alanında bu bilgileri bulabilirsiniz.

eventObject.messageMetadata.messageId string
Kullanımdan kaldırıldı. Gmail kullanıcı arayüzünde açık olan ileti dizisinin ileti kimliği.

Google Workspace eklentileri için eventObject.gmail.messageId alanında bu bilgileri bulabilirsiniz.

eventObject.clientPlatform string
Kullanımdan kaldırıldı. Etkinliğin nereden geldiğini (web, iOS veya Android) belirtir.

Google Workspace eklentileri için eventObject.commonEventObject.platform alanında bu bilgileri bulabilirsiniz.

eventObject.formInput object
Kullanımdan kaldırıldı. Karttaki tüm form widget'larının mevcut değerlerinin haritası (her widget için bir değerle sınırlandırılmıştır). Anahtarlar, widget'larla ilişkilendirilen dize kimlikleridir. Değerler ise dizedir. Etkinlik nesnesi, metin girişleri ve anahtarlar gibi beklenen tekil değerlere sahip birden fazla widget'tan veri okumanız gerektiğinde kolaylık sağlamak için formInput özelliğini sağlar. Onay kutuları gibi birden çok değerli widget'larda her bir değeri formInputs öğesinden okuyabilirsiniz.

Google Workspace eklentilerinde ise bu bilgiyi eventObject.commonEventObject.formInputs alanında bulabilirsiniz. Tek değerli widget'lar, tek bir öğe içeren diziler olarak temsil edilir.

eventObject.formInputs object
Kullanımdan kaldırıldı. Dize listeleri halinde sunulan, karttaki widget'ların mevcut değerlerinin eşlemesi. Anahtarlar, widget'la ilişkilendirilen dize kimlikleridir. Tek değerli widget'lar için değer, tek öğeli bir dizide sunulur. Onay kutusu grupları gibi birden çok değerli widget'lar için tüm değerler bir listede sunulur.

Google Workspace eklentileri için eventObject.commonEventObject.formInputs alanında bu bilgileri bulabilirsiniz.

eventObject.parameters object
Kullanımdan kaldırıldı. Action.setParameters() kullanarak Action öğesine sağladığınız ek parametrelerin eşlemesi. Eşleme anahtarları ve değerleri dizedir.

Google Workspace eklentileri için eventObject.commonEventObject.parameters alanında bu bilgileri bulabilirsiniz.

eventObject.userCountry string
Varsayılan olarak kullanımdan kaldırıldı ve devre dışı bırakıldı. Kullanıcının ülkesini veya bölgesini belirten iki harfli kod. Sayısal bir UN M49 ülke kodu da olabilir.

Google Workspace eklentileri için eventObject.commonEventObject.userLocale alanında bu bilgileri bulabilirsiniz.

eventObject.userLocale string
Varsayılan olarak kullanımdan kaldırıldı ve devre dışı bırakıldı. Kullanıcının dilini belirten iki harfli ISO 639 kodu. Daha fazla ayrıntı için Kullanıcının yerel ayarına ve saat dilimine erişme bölümüne bakın.

Google Workspace eklentileri için eventObject.commonEventObject.userLocale alanında bu bilgileri bulabilirsiniz.

eventObject.userTimezone.id string
Varsayılan olarak kullanımdan kaldırıldı ve devre dışı bırakıldı. Kullanıcının saat dilimi tanımlayıcısı. Örnekler: America/New_York, Europe/Vienna ve Asia/Seoul. Daha fazla bilgi için Kullanıcının yerel ayarına ve saat dilimine erişme bölümüne bakın.

Google Workspace eklentileri için eventObject.commonEventObject.timeZone.id alanında bu bilgileri bulabilirsiniz.

eventObject.userTimezone.offset string
Varsayılan olarak kullanımdan kaldırıldı ve devre dışı bırakıldı. Kullanıcının Eşgüdümlü Evrensel Zaman'dan (UTC) zaman farkı, milisaniye cinsinden ölçülür. Daha fazla bilgi için Kullanıcının yerel ayarına ve saat dilimine erişme bölümüne bakın.

Google Workspace eklentileri için eventObject.commonEventObject.timeZone.offset alanında bu bilgileri bulabilirsiniz.

Ortak etkinlik nesnesi

Ortak etkinlik nesnesi, kullanıcının istemcisinden eklentiye gönderilen genel, ana makineden bağımsız bilgileri taşıyan genel etkinlik nesnesinin kısmıdır. Bu bilgiler arasında kullanıcının yerel ayarı, ana makine uygulaması ve platformu gibi ayrıntılar yer alır.

Ana sayfa ve bağlamsal tetikleyicilere ek olarak eklentiler, kullanıcı widget'larla etkileşimde bulunduğunda etkinlik nesnelerini işlem geri çağırma işlevleri oluşturur ve bunlara iletir. Eklentinizin geri çağırma işlevi, kullanıcının istemcisindeki açık widget'ların içeriğini belirlemek için ortak etkinlik nesnesini sorgulayabilir. Örneğin, eklentiniz eventObject.commentEventObject.formInputs nesnesinde bir kullanıcının TextInput widget'ına girdiği metni bulabilir.

Ortak etkinlik nesnesi alanları
commonEventObject.platform string
Etkinliğin nereden geldiğini ("WEB", "IOS" veya "ANDROID") belirtir.
commonEventObject.formInputs object
Görüntülenen karttaki widget'ların mevcut değerlerini içeren bir harita. Eşleme anahtarları, her widget'la atanan dize kimlikleridir.

Harita değeri nesnesinin yapısı widget türüne bağlıdır:

  • Tek değerli widget'lar (örneğin, metin kutusu): dizelerin listesi (yalnızca bir öğe).

    Örnek: Kimliği employeeName olan bir metin girişi widget'ı için metin giriş değerine şununla erişin: e.commonEventObject.formInputs.employeeName.stringInputs.value[0]

  • Birden çok değerli widget'lar (örneğin, onay kutusu grupları): Dize listesi.

    Örnek: Kimliği participants olan birden çok değerli widget için değer dizisine e.commonEventObject.formInputs.participants.stringInputs.value ile erişin.

  • A date-time picker: DateTimeInput object.

    Örnek: myDTPicker kimliğine sahip bir seçici için e.commonEventObject.formInputs.myDTPicker.dateTimeInput kullanarak DateTimeInput nesnesine erişin.

  • A date-only picker: DateInput object.

    Örnek: myDatePicker kimliğine sahip bir seçici için e.commonEventObject.formInputs.myDatePicker.dateInput kullanarak DateInput nesnesine erişin.

  • A time-only picker: TimeInput object.

    Örnek: myTimePicker kimliğine sahip bir seçici için e.commonEventObject.formInputs.myTimePicker.timeInput kullanarak TimeInput nesnesine erişin.
commonEventObject.hostApp string
Etkinlik nesnesi oluşturulduğunda eklentinin etkin olduğu ana makine uygulamasını belirtir. Olası değerler şunları içerir:
  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
commonEventObject.parameters object
Action öğesine Action.setParameters() kullanarak sağladığınız ek parametreler.
commonEventObject.userLocale string
Varsayılan olarak devre dışıdır. ISO 639 dil kodu-ISO 3166 ülke/bölge kodu biçiminde, kullanıcının dil ve ülke/bölge tanımlayıcısı. Örneğin, en-US.

Bu alanı etkinleştirmek için eklentinizin manifest dosyasında addOns.common.useLocaleFromApp öğesini true olarak ayarlamanız gerekir. Eklentinizin kapsam listesinde https://www.googleapis.com/auth/script.locale bulunmalıdır. Daha fazla bilgi için Kullanıcının yerel ayarına ve saat dilimine erişme bölümüne bakın.

commonEventObject.timeZone string
Varsayılan olarak devre dışıdır. Saat dilimi kimliği ve ofset. Bu alanı etkinleştirmek için eklentinizin manifest dosyasında addOns.common.useLocaleFromApp değerini true olarak ayarlamanız gerekir. Eklentinizin kapsam listesinde https://www.googleapis.com/auth/script.locale bulunmalıdır. Daha fazla bilgi için Kullanıcının yerel ayarına ve saat dilimine erişme bölümüne bakın.
commonEventObject.timeZone.id string
Kullanıcının saat dilimi tanımlayıcısı. Örnekler: America/New_York, Europe/Vienna ve Asia/Seoul. Bu alanı etkinleştirmek için eklentinizin manifest dosyasında addOns.common.useLocaleFromApp değerini true olarak ayarlamanız gerekir. Eklentinizin kapsam listesinde https://www.googleapis.com/auth/script.locale bulunmalıdır. Daha fazla bilgi için Kullanıcının yerel ayarına ve saat dilimine erişme bölümüne bakın.
commonEventObject.timeZone.offset string
Kullanıcının Eşgüdümlü Evrensel Zaman'a (UTC) göre zaman farkı. Milisaniye cinsinden ölçülen Daha fazla bilgi için Kullanıcının yerel ayarına ve saat dilimine erişme bölümüne bakın.

Tarih/saat seçici form girişleri

İşlem geri çağırma işlevleri, commonEventObject.formInputs alanındaki mevcut widget değerlerini alabilir. Buna, tarih veya saat seçici widget'larında kullanıcının seçtiği tarih veya saat değerleri de dahildir. Bununla birlikte, bilgilerin yapısı, widget'ın tarih-saat seçici, yalnızca tarih seçici veya yalnızca saat seçici olarak yapılandırılmış olmasına göre değişiklik gösterir. Yapısal farklılıklar aşağıdaki tabloda açıklanmıştır:

DateTimeInput nesnesi
dateTimeInput.hasDate Giriş tarihi/saati tarih içeriyorsa boolean
true; yalnızca saat eklenmişse false.
dateTimeInput.hasTime Giriş tarihi/saati saat içeriyorsa boolean
true; false yalnızca bir tarih içeriyorsa.
dateTimeInput.msSinceEpoch string
Epoch'tan (1 Ocak 1970, 00:00:00 UTC) itibaren kullanıcı tarafından seçilen zaman (milisaniye cinsinden).
DateInput nesnesi
dateInput.msSinceEpoch string
Epoch'tan (1 Ocak 1970, 00:00:00 UTC) itibaren kullanıcı tarafından seçilen zaman (milisaniye cinsinden).
TimeInput nesnesi
timeInput.hours number
Kullanıcı tarafından seçilen saat numarası.
timeInput.minutes number
Kullanıcının seçtiği dakika sayısıdır.

Takvim etkinliği nesnesi

Takvim etkinliği nesnesi, genel etkinlik nesnesinin bir kullanıcının takvimi ve takvim etkinlikleri hakkında bilgi taşıyan kısmıdır. Etkinlik nesnesi yalnızca ana makine uygulaması Google Takvim ise bir etkinlik nesnesinde bulunur.

Aşağıdaki tabloda, bir etkinlik nesnesinin calendarEventObject alanında bulunan alanlar listelenmiştir. Kullanıcı tarafından oluşturulan veri olarak işaretlenmiş alanlar, yalnızca verilerin Takvim etkinliğinde bulunması ve eklentinin addOns.calendar.currentEventAccess manifest alanını READ veya READ_WRITE olarak ayarlaması durumunda etkinlik nesnesinde görünür.

Takvim etkinliği nesnesi
calendar.attendees[] list of attendee objects
Kullanıcı tarafından oluşturulan veriler. Takvim etkinliğine katılanların listesi.
calendar.calendarId string
Takvim kimliği.
calendar.capabilities object
Kullanıcı tarafından oluşturulan veriler. Eklentinin etkinlik bilgilerini görüntüleme veya güncelleme özelliklerini açıklayan bir nesne.
calendar.capabilities.canAddAttendees boolean
Kullanıcı tarafından oluşturulan veriler. Eklenti, etkinlik katılımcı listesine yeni katılımcılar ekleyebiliyorsa true; aksi takdirde false.
calendar.capabilities.canSeeAttendees boolean
Kullanıcı tarafından oluşturulan veriler. Eklenti, etkinlik katılımcı listesini okuyabiliyorsa true; aksi takdirde false.
calendar.capabilities.canSeeConferenceData boolean
Kullanıcı tarafından oluşturulan veriler. Eklenti, etkinlik konferans verilerini okuyabiliyorsa true; aksi takdirde false.
calendar.capabilities.canSetConferenceData boolean
Kullanıcı tarafından oluşturulan veriler. Eklenti, etkinlik konferans verilerini güncelleyebiliyorsa true; aksi takdirde false.
calendar.capabilities.canAddAttachments boolean
Kullanıcı tarafından oluşturulan veriler. true (Eklenti etkinliğe yeni ekler ekleyebiliyorsa; aksi halde false).
calendar.conferenceData Conference data object
Kullanıcı tarafından oluşturulan veriler. Bu etkinlikle ilişkili herhangi bir konferans verilerini temsil eden bir nesne (ör. Google Meet konferans ayrıntıları).
calendar.id string
Etkinlik kimliği.
calendar.organizer object
Etkinliği düzenleyeni temsil eden bir nesne.
calendar.organizer.email string
Etkinliği düzenleyenin e-posta adresi.
calendar.recurringEventId string
Düzenli bir etkinliğin kimliği.

Katılımcı

Katılımcı nesneleri, Google Takvim etkinliklerine katılan her bir katılımcıyla ilgili bilgileri taşır. Bu bilgi, yalnızca verilerin Takvim etkinliğinde mevcut olması ve eklentinin addOns.calendar.currentEventAccess manifest alanını READ veya READ_WRITE olarak ayarlaması durumunda etkinlik nesnesinde yer alır.

Katılımcı nesnesi
attendee.additionalGuests number
Katılımcının getirdiğini belirttiği ek konuk sayısı. Varsayılan değer sıfırdır.
attendee.comment string
Varsa katılımcının yanıtı yorumu.
attendee.displayName string
Katılımcının görünen adı.
attendee.email string
Katılımcının e-posta adresi.
attendee.optional Bu katılımcının katılımı isteğe bağlı olarak işaretlendiyse boolean
true; aksi takdirde false.
attendee.organizer boolean
true (katılımcı bu etkinliği düzenleyen kişiyse).
attendee.resource boolean
true (katılımcı oda veya ekipman gibi bir kaynağı temsil ediyorsa), false.
attendee.responseStatus string
Katılımcının yanıt durumu. Olası değerler şunları içerir:
  • accepted: Katılımcı etkinlik davetini kabul etti.
  • declined: Katılımcı etkinlik davetini reddetti.
  • needsAction: Katılımcı etkinlik davetiyesine yanıt vermedi.
  • tentative: Katılımcı etkinlik davetini geçici olarak kabul etti.
attendee.self Bu katılımcı bu etkinliğin göründüğü takvimi temsil ediyorsa boolean
true; aksi takdirde false.

Konferans verileri

Konferans veri nesneleri, Google Takvim etkinliklerine ekli konferanslar hakkında bilgi taşır. Bunlar Google Meet gibi Google konferans çözümleri veya üçüncü taraf konferansları olabilir. Bu bilgiler yalnızca ve sadece Takvim etkinliğinde veri varsa ve eklenti, addOns.calendar.currentEventAccess manifest alanını READ veya READ_WRITE olarak ayarlarsa etkinlik nesnesinde mevcut olur.

Konferans veri nesnesi
conferenceData.conferenceId string
Konferansın kimliği. Bu kimliğin amacı, uygulamaların konferansları takip etmesine izin vermektir. Bu kimliği kullanıcılara göstermemelisiniz.
conferenceData.conferenceSolution object
Hangouts veya Google Meet gibi konferans çözümünü temsil eden bir nesne.
conferenceData.conferenceSolution.iconUri string
Bu konferans çözümünü temsil eden, kullanıcının görebildiği simgenin URI'si.
conferenceData.conferenceSolution.key object
Bu etkinlik için konferans çözümünü benzersiz şekilde tanımlayan anahtardır.
conferenceData.conferenceSolution.key.type string
Konferans çözümü türü. Olası değerler şunları içerir:
  • Tüketiciler için Hangouts için eventHangout (http://hangouts.google.com).
  • Google Workspace kullanıcıları için klasik Hangouts'ta eventNamedHangout (http://hangouts.google.com).
  • Google Meet için hangoutsMeet (http://meet.google.com).
conferenceData.conferenceSolution.name string
Bu konferans çözümünün kullanıcı tarafından görülebilen adı (yerelleştirilmiş değil).
conferenceData.entryPoints[] list of entry point objects
Konferans giriş noktalarının listesi (ör. URL'ler veya telefon numaraları).
conferenceData.notes string
Konferansla ilgili olarak kullanıcıya gösterilecek ek notlar (ör. alan yöneticisinin talimatları veya yasal uyarılar). HTML içerebilir. Maksimum uzunluk 2.048 karakterdir.
conferenceData.parameters object
Eklenti tarafından kullanılmak üzere tanımlanmış parametre verilerinin eşlemesini içeren bir nesne.
conferenceData.parameters.addOnParameters object
Parametre dizesi anahtarlarının ve değerlerinin eşlemesi. Bu anahtarlar ve değerler, eklentinin geliştiricisi tarafından eklentinin kullanılabilmesi için belirli bir konferansa bilgi eklemek amacıyla tanımlanır.

Giriş noktası

Giriş noktası nesneleri, belirli bir konferansa erişim için yerleşik yöntemler (ör. telefon veya video) hakkında bilgi taşır. Bu bilgiler yalnızca ve sadece Takvim etkinliğinde veri varsa ve eklenti, addOns.calendar.currentEventAccess manifest alanını READ veya READ_WRITE olarak ayarlarsa etkinlik nesnesinde mevcut olur.

Giriş noktası nesnesi
entryPoint.accessCode string
Konferansa erişmek için kullanılan erişim kodu. Maksimum uzunluk 128 karakterdir. Konferans sağlayıcıları genellikle konferanslara erişim sağlamak için {accessCode, meetingCode, passcode, password, pin} alt kümelerini kullanır. Yalnızca konferans sağlayıcısının kullandığı alanları eşleştirin ve her zaman görüntüleyin.
entryPoint.entryPointFeatures list
Giriş noktasının özellikleri. Şu anda bu özellikler yalnızca phone giriş noktası için geçerlidir:
  • toll: Giriş noktası, ücretli bir telefon araması.
  • toll_free: Giriş noktası ücretsiz telefon araması.
entryPoint.entryPointType string
Giriş noktasının türü. Olası değerler şunlardır:
  • more: Alternatif telefon numaraları gibi, konferansa katılmayla ilgili ek talimatlar. Bir konferansın yalnızca bir more giriş noktası olabilir. Giriş noktası varsa en az bir başka giriş noktası da gerekir.
  • phone: Konferansa telefon numarasıyla katılın. Bir konferansta sıfır veya daha fazla phone giriş noktası olabilir. Google Takvim, alfabetik olarak biçimlendirip sıraladıktan sonra yalnızca ilk iki telefon giriş noktasını görüntüler.
  • sip: SIP üzerinden konferansa katılın. Bir konferansta en fazla bir sip giriş noktası olabilir.
  • video: Konferansa HTTP üzerinden katılın. Bir konferansta en fazla bir video giriş noktası olabilir.
entryPoint.label string
Giriş noktası URI'si için kullanıcı tarafından görülebilen etiket (yerelleştirilmiş değil).
entryPoint.meetingCode string
Konferansa erişmek için kullanılan toplantı kodu. Maksimum uzunluk 128 karakterdir. Konferans sağlayıcıları genellikle konferanslara erişim sağlamak için {accessCode, meetingCode, passcode, password, pin} alt kümelerini kullanır. Yalnızca konferans sağlayıcısının kullandığı alanları eşleştirin ve her zaman görüntüleyin.
entryPoint.passcode string
Konferansa erişmek için kullanılan şifre kodu. Maksimum uzunluk 128 karakterdir. Konferans sağlayıcıları genellikle konferanslara erişim sağlamak için {accessCode, meetingCode, passcode, password, pin} alt kümelerini kullanır. Yalnızca konferans sağlayıcısının kullandığı alanları eşleştirin ve her zaman görüntüleyin.
entryPoint.password string
Konferansa erişmek için kullanılan şifre. Maksimum uzunluk 128 karakterdir. Konferans sağlayıcıları genellikle konferanslara erişim sağlamak için {accessCode, meetingCode, passcode, password, pin} alt kümelerini kullanır. Yalnızca konferans sağlayıcısının kullandığı alanları eşleştirin ve her zaman görüntüleyin.
entryPoint.pin string
Konferansa erişmek için kullanılan PIN. Maksimum uzunluk 128 karakterdir. Konferans sağlayıcıları genellikle konferanslara erişim sağlamak için {accessCode, meetingCode, passcode, password, pin} alt kümelerini kullanır. Yalnızca konferans sağlayıcısının kullandığı alanları eşleştirin ve her zaman görüntüleyin.
entryPoint.regionCode string
Telefon numarasının bölge kodu. URI'da ülke kodu yoksa kullanıcılar tarafından gerekir. Değerler, herkese açık CLDR bölge kodları listesine dayanır.
entryPoint.uri string
Giriş noktasının URI'si. Maksimum uzunluk 1.300 karakterdir. Biçimlendirme, giriş noktası türüne bağlıdır:
  • more: http: veya https: şeması gereklidir.
  • phone: tel: şeması gereklidir. URI, arama sırasının tamamını içermelidir (ör. "tel:+12345678900,,12345678;1234").
  • sip: sip: veya sips: şeması gereklidir. Örneğin, "sip:12345678@sağlayıcım.com".
  • video: http: veya https: şeması gereklidir.

Drive etkinlik nesnesi

Drive etkinlik nesnesi, genel etkinlik nesnesinin bir kullanıcının Google Drive'ı ve içeriği hakkında bilgi taşıyan kısmıdır. Bu dosya yalnızca ana makine uygulaması Google Drive ise bir etkinlik nesnesinde bulunur.

Drive etkinlik nesnesi
drive.activeCursorItem Drive item object
Şu anda etkin olan Drive öğesi.
drive.selectedItems[] list of Drive item objects
Drive'da seçilen öğelerin (dosyalar veya klasörler) listesi.

Drive öğesi

Drive öğesi nesneleri, dosyalar veya klasörler gibi belirli Drive öğeleriyle ilgili bilgileri taşır.

Drive öğesi nesnesi
item.addonHasFileScopePermission boolean
true ise eklenti, bu öğe için https://www.googleapis.com/auth/drive.file kapsam yetkilendirme istedi ve aldı. Aksi takdirde bu alan false olur.
item.id string
Seçili öğenin kimliği.
item.iconUrl string
Seçili öğeyi temsil eden simgenin URL'si.
item.mimeType string
Seçilen öğenin MIME türü.
item.title string
Seçilen öğenin başlığı.

Gmail etkinlik nesnesi

Gmail etkinlik nesnesi, genel etkinlik nesnesinin bir kullanıcının Gmail iletileri hakkında bilgi taşıyan kısmıdır. Etkinlik nesnesi yalnızca ana makine uygulaması Gmail ise mevcut olur.

Gmail etkinlik nesnesi
gmail.accessToken string
Gmail'e özel erişim jetonu. Eklentinize bir kullanıcının şu anda açık olan Gmail iletisine geçici erişim izni vermek veya eklentinizin yeni taslaklar oluşturmasına izin vermek için bu jetonu GmailApp.setCurrentMessageAccessToken(accessToken) yöntemiyle kullanabilirsiniz.
gmail.bccRecipients[] list of strings
Varsayılan olarak devre dışıdır. Eklentinin oluşturmakta olduğu taslakta o anda yer alan "BCC:" alıcı e-posta adreslerinin listesi. Bu alanı etkinleştirmek için manifest dosyanızdaki addOns.gmail.composeTrigger.draftAccess alanını METADATA olarak ayarlamanız gerekir.
gmail.ccRecipients[] list of strings
Varsayılan olarak devre dışıdır. Eklentinin oluşturmakta olduğu taslakta o anda yer alan "CC:" alıcı e-posta adreslerinin listesi. Bu alanı etkinleştirmek için manifest dosyanızdaki addOns.gmail.composeTrigger.draftAccess alanını METADATA olarak ayarlamanız gerekir.
gmail.messageId string
Şu anda açık olan Gmail iletisinin kimliği.
gmail.threadId string
Şu anda açık olan Gmail ileti dizisi kimliği.
gmail.toRecipients[] list of strings
Varsayılan olarak devre dışıdır. Eklentinin oluşturmakta olduğu taslakta o anda yer alan "Alıcı:" alıcı e-posta adreslerinin listesi. Bu alanı etkinleştirmek için manifest dosyanızdaki addOns.gmail.composeTrigger.draftAccess alanını METADATA olarak ayarlamanız gerekir.

Dokümanlar etkinlik nesnesi

Docs etkinlik nesnesi, genel etkinlik nesnesinin bir kullanıcının dokümanı ve içeriği hakkında bilgi taşıyan kısmıdır. Etkinlik nesnesi yalnızca ana makine uygulaması Google Dokümanlar ise bir etkinlik nesnesinde bulunur.

Dokümanlar etkinlik nesnesi
docs.id string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildiyse mevcut.
Dokümanların kullanıcı arayüzünde açık olan dokümanın kimliği.
docs.title string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildiyse mevcut.
Dokümanın başlığı Dokümanlar kullanıcı arayüzünde açık.
docs.addonHasFileScopePermission boolean
true ise eklenti, Dokümanlar kullanıcı arayüzünde açık olan doküman için https://www.googleapis.com/auth/drive.file kapsam yetkilendirme istemiş ve almıştır. Aksi takdirde bu alan false olur.
docs.matchedUrl.url string
Yalnızca aşağıdaki koşullar karşılandığında mevcut:
  • https://www.googleapis.com/auth/workspace.linkpreview, kullanıcı tarafından yetkilendirildi.
  • URL, LinkPreviewTriggers tetikleyicisinde belirtilen ana makine kalıbıyla eşleşiyor.

Google Dokümanlar'da önizleme oluşturan bağlantının URL'si. Bu alanı kullanmak için eklentinizin manifest dosyasında LinkPreviewTriggers öğesini yapılandırmanız gerekir. Daha fazla bilgi için Bağlantıları akıllı çiplerle önizleme başlıklı makalede bulabilirsiniz.

Kullanıcı, https://www.example.com/12345 bağlantısını önizlediğinde örnek yük: 

"docs" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}

E-Tablolar etkinlik nesnesi

E-Tablolar etkinlik nesnesi, genel etkinlik nesnesinin bir kullanıcının dokümanı ve içeriği hakkında bilgi taşıyan kısmıdır. Etkinlik nesnesi yalnızca ana makine uygulaması Google E-Tablolar ise bir etkinlik nesnesinde bulunur.

E-Tablolar etkinlik nesnesi
sheets.id string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildiyse mevcut. E-Tablolar kullanıcı arayüzünde açık olan e-tablonun kimliği.
sheets.title string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildiyse mevcut. E-tablonun başlığı E-Tablolar kullanıcı arayüzünde açılır.
sheets.addonHasFileScopePermission boolean
true ise eklenti, E-Tablolar kullanıcı arayüzünde açık olan e-tablo için https://www.googleapis.com/auth/drive.file kapsam yetkilendirme istemiş ve almıştır. Aksi takdirde bu alan false olur.
sheets.matchedUrl.url string
Yalnızca aşağıdaki koşullar karşılandığında mevcut:
  • https://www.googleapis.com/auth/workspace.linkpreview, kullanıcı tarafından yetkilendirildi.
  • URL, LinkPreviewTriggers tetikleyicisinde belirtilen ana makine kalıbıyla eşleşiyor.

Google E-Tablolar'da önizleme oluşturan bağlantının URL'si. Bu alanı kullanmak için eklentinizin manifest dosyasında LinkPreviewTriggers öğesini yapılandırmanız gerekir. Daha fazla bilgi için Bağlantıları akıllı çiplerle önizleme başlıklı makalede bulabilirsiniz.

Bir kullanıcı, https://www.example.com/12345 bağlantısının önizlemesi için örnek yük:

"sheets" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}

Slaytlar etkinlik nesnesi

Slaytlar etkinlik nesnesi, genel etkinlik nesnesinin bir kullanıcının dokümanı ve içeriği hakkında bilgi taşıyan kısmıdır. Etkinlik nesnesi, yalnızca ana makine uygulaması Google Slaytlar ise bir etkinlik nesnesinde bulunur.

Slaytlar etkinlik nesnesi
slides.id string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildiyse mevcut. Slaytlar kullanıcı arayüzünde açık olan sununun kimliği.
slides.title string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildiyse mevcut. Sununun başlığı Slaytlar kullanıcı arayüzünde açılır.
slides.addonHasFileScopePermission boolean
true eklentisinde eklenti, Slaytlar kullanıcı arayüzünde açık sunu için https://www.googleapis.com/auth/drive.file kapsam yetkisi istedi ve aldı. Aksi takdirde bu alan false olacak.
slides.matchedUrl.url string
Yalnızca aşağıdaki koşullar karşılandığında mevcut:
  • https://www.googleapis.com/auth/workspace.linkpreview, kullanıcı tarafından yetkilendirildi.
  • URL, LinkPreviewTriggers tetikleyicisinde belirtilen ana makine kalıbıyla eşleşiyor.

Google Slaytlar'da önizleme oluşturan bağlantının URL'si. Bu alanı kullanmak için eklentinizin manifest dosyasında LinkPreviewTriggers öğesini yapılandırmanız gerekir. Daha fazla bilgi için Bağlantıları akıllı çiplerle önizleme başlıklı makalede bulabilirsiniz.

Bir kullanıcı, https://www.example.com/12345 bağlantısının önizlemesi için örnek yük:

"slides" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}