Etkinlik nesneleri

Bu sayfada, Google Workspace Eklentileri etkinlik nesnelerinin yapısı özetlenmektedir.

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

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

  • Ana sayfa tetikleyicileri. Tanımladığınız her homepageTrigger işlevine, ana sayfa tetikleyici işlevi etkinleştiğinde 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 ana sayfa tetikleyici işlevinizde bu nesneyi kullanabilirsiniz.

    Ana sayfa tetikleyicileri etkinleştiğinde oluşturulan etkinlik nesneleri, diğer iki durumdaki tüm alanları içermez; widget'larla ve bağlamsal bilgilerle ilgili alanlar atlanı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ı, eklenti manifest'inde listelenen karşılık gelen runFunction öğesini çağırarak bunu bir etkinlik nesnesini parametre olarak iletir. Bağlamsal tetikleyiciler etkinleştiğinde oluşturulan etkinlik nesneleri, ana sayfa tetikleyici etkinlik nesnelerinde yer alan tüm alanların yanı sıra bağlamsal bilgileri içeren alanları da 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 Eklentilerinde, eylem etkinliği nesneleri bir geri çağırma işlevinin işlem yapabileceği daha fazla bilgi içerir.

    Widget işlemlerinin sonucu olarak oluşturulan etkinlik nesneleri, bağlamsal tetikleyici etkinlik nesnelerinde bulunan 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ıpla eşleşen 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 gösteren bir akıllı çip ve kart oluşturmak için bu etkinlik nesnesini kullanabilir. Kullanıcıların önizleme kartı ve içeriğiyle etkileşimde bulunmalarını sağlamak için widget işlemleri de oluşturabilirsiniz.

Etkinlik nesnesi yapısı

Aşağıdaki tabloda Google Workspace Eklentileri etkinlik nesnelerinin üst düzey yapısı açıklanmaktadır. Etkinlik nesne yapısında, ana makineden bağımsız bilgiler için üst düzey bir commonEventObject alanı bulunur. Her etkinlik nesnesi, etkin ana makine uygulaması tarafından belirlenen, ana makineye özel ş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 tabloda "Orijinal Gmail eklenti alanları" altında 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 çağrıyı düzenleyen kişi Google Takvim ise mevcut olmalıdır. Takvim ve etkinlik bilgilerini içeren bir nesnedir.
eventObject.drive Drive event object
Yalnızca çağrıyı düzenleyen kullanıcı Google Drive ise mevcut olmalıdır. Drive bilgilerini içeren bir nesne.
eventObject.gmail Gmail event object
Yalnızca çağrıyı gerçekleştiren Gmail ise mevcut olmalıdır. Gmail bilgilerini içeren bir nesne.
eventObject.docs Docs event object
Yalnızca çağrıyı düzenleyen kişi 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 kullanıcı Google E-Tablolar ise mevcut olmalıdır. E-Tablolar bilgilerini içeren bir nesne.
eventObject.slides Slides event object
Yalnızca çağrıyı düzenleyen kişi Google Slaytlar ise mevcut olmalıdır. Slaytlar bilgilerini içeren bir nesne.
Orijinal Gmail eklentisi alanları
eventObject.messageMetadata.accessToken string
Kullanımdan kaldırıldı. Erişim jetonu. Bu ayarı, geçici Gmail eklenti kapsamlarını kullanarak kullanıcı verilerine erişimi etkinleştirmek için kullanabilirsiniz.

Google Workspace eklentileriyle ilgili bilgileri eventObject.gmail.accessToken alanında 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 eklentileriyle ilgili bilgileri eventObject.gmail.messageId alanında bulabilirsiniz.

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

Google Workspace eklentileriyle ilgili bilgileri eventObject.commonEventObject.platform alanında bulabilirsiniz.

eventObject.formInput object
Kullanımdan kaldırıldı. Karttaki tüm form widget'larının geçerli değerlerinin haritası (her widget için bir değerle sınırlandırılmıştır). Anahtarlar, widget'larla ilişkilendirilmiş 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 sağlar. Onay kutuları gibi birden çok değerli widget'larda her bir değeri formInputs bölümünden okuyabilirsiniz.

Google Workspace eklentileri için eventObject.commonEventObject.formInputs alanında bu bilgileri bulabilirsiniz. Tek değerlere sahip 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 haritası. Anahtarlar, widget ile ilişkilendirilen dize kimlikleridir. Değer, tek değerli widget'lar için 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 eklentileriyle ilgili bilgileri eventObject.commonEventObject.formInputs alanında bulabilirsiniz.

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

Google Workspace eklentileriyle ilgili bilgileri eventObject.commonEventObject.parameters alanında bulabilirsiniz.

eventObject.userCountry string
Kullanımdan kaldırıldı ve varsayılan olarak 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 eklentileriyle ilgili bilgileri eventObject.commonEventObject.userLocale alanında bulabilirsiniz.

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

Google Workspace eklentileriyle ilgili bilgileri eventObject.commonEventObject.userLocale alanında bulabilirsiniz.

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

Google Workspace eklentileriyle ilgili bilgileri eventObject.commonEventObject.timeZone.id alanında bulabilirsiniz.

eventObject.userTimezone.offset string
Kullanımdan kaldırıldı ve varsayılan olarak 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 ayrıntı için Kullanıcı yerel ayarına ve saat dilimine erişme bölümüne bakın.

Google Workspace eklentileriyle ilgili bilgileri eventObject.commonEventObject.timeZone.offset alanında bulabilirsiniz.

Ortak etkinlik nesnesi

Ortak etkinlik nesnesi, genel etkinlik nesnesinin, kullanıcının istemcisinden eklentiye yönelik, ana makineden bağımsız genel bilgileri içeren 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 nesneleri oluşturur ve işlem geri çağırma işlevlerine 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 bir kullanıcının eventObject.commentEventObject.formInputs nesnesindeki TextInput widget'ına girdiği metni bulabilir.

Sık kullanılan etkinlik nesnesi alanları
commonEventObject.platform string
Etkinliğin nereden geldiğini gösterir ("WEB", "IOS" veya "ANDROID").
commonEventObject.formInputs object
Görüntülenen kartta widget'ların geçerli değerlerini içeren bir harita. Eşleme anahtarları, her widget'a atanan dize kimlikleridir.

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

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

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

  • Birden çok değerli widget'lar (ör. onay kutusu grupları): Dizelerden oluşan bir liste.

    Örnek: Kimliği participants olan birden çok değerli bir 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 DateTimeInput nesnesine e.commonEventObject.formInputs.myDTPicker.dateTimeInput kullanarak erişin.

  • A date-only picker: DateInput object.

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

  • A time-only picker: TimeInput object.

    Örnek: myTimePicker kimliğine sahip bir seçici için TimeInput nesnesine e.commonEventObject.formInputs.myTimePicker.timeInput kullanarak 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.setParameters() kullanarak Action öğesine sağladığınız tüm ek parametreler.
commonEventObject.userLocale string
Varsayılan olarak devre dışıdır. Kullanıcının ISO 639 dil kodu-ISO 3166 ülke/bölge kodu biçimindeki 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 değerini true olarak ayarlamanız gerekir. Eklentinizin kapsam listesi https://www.googleapis.com/auth/script.locale öğesini de içermelidir. Daha fazla ayrıntı için Kullanıcı 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 göreli konum. Bu alanı etkinleştirmek için eklentinizin manifest dosyasında addOns.common.useLocaleFromApp değerini true olarak ayarlamanız gerekir. Eklentinizin kapsam listesi ayrıca https://www.googleapis.com/auth/script.locale içermelidir. Daha fazla ayrıntı için Kullanıcı 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 listesi ayrıca https://www.googleapis.com/auth/script.locale içermelidir. Daha fazla ayrıntı için Kullanıcı 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 Saat (UTC) ile olan zaman farkı. Milisaniye cinsinden ölçülen, kullanıcının saat dilimi. Daha fazla ayrıntı için Kullanıcı 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 geçerli 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 zaman seçici olarak yapılandırılmış olmasına göre farklılık 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; false yalnızca bir saat eklenmişse.
dateTimeInput.hasTime Giriş tarihi/saati saat içeriyorsa boolean
true; false yalnızca tarih eklenmişse.
dateTimeInput.msSinceEpoch string
Dönemden bu yana kullanıcının seçtiği, milisaniye cinsinden zaman (1 Ocak 1970, 00:00:00 UTC).
DateInput nesnesi
dateInput.msSinceEpoch string
Dönemden bu yana kullanıcının seçtiği, milisaniye cinsinden zaman (1 Ocak 1970, 00:00:00 UTC).
TimeInput nesnesi
timeInput.hours number
Kullanıcı tarafından seçilen saat numarası.
timeInput.minutes number
Kullanıcı tarafından seçilen dakika sayısı.

Takvim etkinliği nesnesi

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

Aşağıdaki tabloda, bir etkinlik nesnesinin calendarEventObject alanında bulunan alanlar listelenmektedir. Kullanıcı tarafından oluşturulan veriler olarak işaretlenen alanlar, yalnızca veriler Takvim etkinliğinde mevcutsa ve eklenti addOns.calendar.currentEventAccess manifest alanını READ veya READ_WRITE olarak ayarlarsa etkinlik nesnesinde bulunur.

Takvim etkinliği nesnesi
calendar.attendees[] list of attendee objects
Kullanıcı tarafından oluşturulan veriler. Takvim etkinliğinin katılımcılarını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. true (eklenti, etkinlik katılımcı listesine yeni katılımcılar ekleyebiliyorsa ; 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. true, eklenti etkinlik konferans verilerini okuyabiliyorsa false; aksi takdirde.
calendar.capabilities.canSetConferenceData boolean
Kullanıcı tarafından oluşturulan veriler. true (Eklenti, etkinlik konferans verilerini güncelleyebiliyorsa false; aksi takdirde. )
calendar.capabilities.canAddAttachments boolean
Kullanıcı tarafından oluşturulan veriler. true (Eklenti etkinliğe yeni ekler ekleyebiliyorsa; aksi takdirde false).
calendar.conferenceData Conference data object
Kullanıcı tarafından oluşturulan veriler. Bu etkinlikle ilişkili herhangi bir konferans verilerini (ör. Google Meet konferans ayrıntıları) temsil eden bir nesne.
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 veriler Takvim etkinliğinde mevcutsa ve eklenti addOns.calendar.currentEventAccess manifest alanını READ veya READ_WRITE olarak ayarlarsa etkinlik nesnesinde yer alır.

Katılımcı nesnesi
attendee.additionalGuests number
Katılımcının getirdiğini belirttiği ilave konuk sayısı. Varsayılan olarak sıfır değerine ayarlanır.
attendee.comment string
Katılımcının yanıt yorumu (varsa).
attendee.displayName string
Gösterilen katılımcı 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şaretlenmişse boolean
true; aksi takdirde false.
attendee.organizer Katılımcı bu etkinliği düzenleyen kişiyse boolean
true.
attendee.resource Katılımcı, oda veya ekipman gibi bir kaynağı temsil ediyorsa boolean
true; aksi takdirde false.
attendee.responseStatus string
Katılımcının yanıt durumu. Olası değerler şunlardır:
  • accepted: Katılımcı etkinlik davetini kabul etti.
  • declined: Katılımcı, etkinlik davetiyesini reddetti.
  • needsAction: Katılımcı etkinlik davetiyesine yanıt vermedi.
  • tentative: Katılımcı etkinlik davetini geçici olarak kabul etti.
attendee.self boolean
true Bu katılımcı ilgili etkinliğin göründüğü takvimi temsil ediyorsa false aksi takdirde.

Konferans verileri

Konferans verisi 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 bilgi yalnızca veriler Takvim etkinliğinde mevcutsa ve eklenti, addOns.calendar.currentEventAccess manifest alanını READ veya READ_WRITE olarak ayarlarsa etkinlik nesnesinde yer alır.

Konferans verisi nesnesi
conferenceData.conferenceId string
Konferansın kimliği. Bu kimlik, uygulamaların konferansları takip etmesine izin vermek için kullanılır. Bu kimliği kullanıcılara göstermemelisiniz.
conferenceData.conferenceSolution object
Konferans çözümünü temsil eden, Hangouts veya Google Meet gibi bir nesne.
conferenceData.conferenceSolution.iconUri string
Bu konferans çözümünü temsil eden, kullanıcının görebildiği simgenin URI'sı.
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 şunlardır:
  • Tüketicilere yönelik Hangouts için eventHangout (http://hangouts.google.com).
  • Google Workspace kullanıcıları için klasik Hangouts'a yönelik 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 haritasını 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ımı için belirli bir konferansa bilgi eklemek amacıyla tanımlanır.

Giriş noktası

Giriş noktası nesneleri, belirli bir konferansa erişmek için kullanılan yöntemler (ör. telefon veya video) hakkında bilgi taşır. Bu bilgiler yalnızca veriler Takvim etkinliğinde mevcutsa ve eklenti, addOns.calendar.currentEventAccess manifest alanını READ veya READ_WRITE olarak ayarlarsa etkinlik nesnesinde yer alır.

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 yalnızca {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 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 telefon araması.
  • toll_free: Giriş noktası ücretsiz telefon aramasıdır.
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: Telefon numarasıyla konferansa katılın. Bir konferansta sıfır veya daha fazla phone giriş noktası olabilir. Google Takvim, biçimlendirip alfabetik olarak 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: HTTP üzerinden konferansa katılın. Bir konferansta en fazla bir video giriş noktası olabilir.
entryPoint.label string
Giriş noktası URI'sı için kullanıcının görebildiği 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 yalnızca {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 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 yalnızca {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 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 yalnızca {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 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 yalnızca {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 görüntüleyin.
entryPoint.regionCode string
Telefon numarasının bölge kodu. URI bir ülke kodu içermiyorsa 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'sı. 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 (örneğin, "tel:+12345678900,,,12345678;1234").
  • sip: sip: veya sips: şeması gereklidir. Örneğin, "sip:12345678@sirketim.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ğiyle ilgili bilgileri taşıyan bölümüdür. Etkinlik nesnesinde yalnızca ana makine uygulamasının Google Drive olması halinde 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 bilgiler taşır.

Drive öğesi nesnesi
item.addonHasFileScopePermission boolean
true ise eklenti, bu öğe için https://www.googleapis.com/auth/drive.file kapsam yetkilendirmesi istemiş ve almıştır. Aksi takdirde bu alan false olur.
item.id string
Seçilen öğenin kimliği.
item.iconUrl string
Seçilen öğ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 içeren kısmıdır. Etkinlik nesnesinde yalnızca ana makine uygulaması Gmail ise bulunur.

Gmail etkinlik nesnesi
gmail.accessToken string
Gmail'e özel erişim jetonu. Eklentinizin bir kullanıcının açık olan Gmail iletisine geçici olarak erişmesine izin 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şturduğu bir taslakta bulunan "BCC:" alıcı e-posta adresleri 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şturduğu taslakta hâlihazırda yer alan "CC:" alıcı e-posta adresleri 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şturduğu taslakta halihazırda yer alan "Kime:" alıcı e-posta adresleri 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

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

Dokümanlar etkinlik nesnesi
docs.id string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildiğinde mevcuttur.
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çıktır.
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 yetkilendirmesi 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 olur:
  • https://www.googleapis.com/auth/workspace.linkpreview için kullanıcı yetki verdi.
  • 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 bölümüne bakın.

Kullanıcı, https://www.example.com/12345 bağlantısını önizlediğinde kaydedilen ö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 içeren kısmıdır. Etkinlik nesnesinde mevcut olması için ana makine uygulamasının Google E-Tablolar olması gerekir.

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-Tablolar kullanıcı arayüzünde açılan e-tablonun başlığı.
sheets.addonHasFileScopePermission boolean
true ise eklenti, E-Tablolar kullanıcı arayüzünde açık e-tablo için https://www.googleapis.com/auth/drive.file kapsam yetkilendirmesi 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 olur:
  • https://www.googleapis.com/auth/workspace.linkpreview için kullanıcı yetki verdi.
  • 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 bölümüne bakın.

Kullanıcı, https://www.example.com/12345 bağlantısını önizlediğinde kaydedilen ö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 içeren kısmıdır. Etkinlik nesnesinde yalnızca ana makine uygulaması Google Slaytlar ise 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. Slaytlar kullanıcı arayüzünde açılan sununun başlığı.
slides.addonHasFileScopePermission boolean
true ise eklenti, Slaytlar kullanıcı arayüzünde açık olan sunu için https://www.googleapis.com/auth/drive.file kapsam yetkilendirmesi istemiş ve almıştır. Aksi takdirde bu alan false olur.
slides.matchedUrl.url string
Yalnızca aşağıdaki koşullar karşılandığında mevcut olur:
  • https://www.googleapis.com/auth/workspace.linkpreview için kullanıcı yetki verdi.
  • 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 bölümüne bakın.

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

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