Etkinlik nesneleri

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

Etkinlik nesneleri, otomatik olarak oluşturulan ve iletilen JSON yapılarıdır. Kullanıcı bir kullanıcı belirli bir öğeyle etkileşime geçtiğinde ekleyebilirsiniz. Etkinlik nesneleri, ana makine uygulaması ve geçerli bağlamı, eklentinin sunucu tarafı geri çağırma işlevine ekleyebilirsiniz.

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

  • Ana sayfa tetikleyicileri. Tanımladığınız her homepageTrigger işlevine otomatik olarak bir etkinlik iletilir nesnesini tanımlayın. Bu nesneyi şurada kullanabilirsiniz: etkin ana makine uygulamasını, istemcinin veya üçüncü tarafın platform, kullanıcının yerel ayarı ve diğer bilgiler.

    Ana sayfa tetikleyicileri etkinleştiğinde oluşturulan etkinlik nesneleri, diğer iki örnekte yer alan alanlar; widget'larla ilgili farklı alanlar, bağlamsal bilgiler atlanır.

  • Bağlamsal tetikleyiciler. Her ana makine uygulaması, bir dizi bağlamsal tetikleyici sağlar. Kullanıcı belirli bir bağlam girdiğinde etkinleşir. Örneğin:

    Bağlamsal bir tetikleyici etkinleştiğinde ana makine uygulaması manifest'inde listelenen karşılık gelen runFunction öğesini iletir. etkinlik nesnesini tanımlayın. Bağlamsal olduğunda oluşturulan etkinlik nesneleri etkinleşen tetikleyiciler, ana sayfa tetikleyici etkinliğine dahil edilen tüm alanları içerir nesneler ve bağlamsal bilgiler içeren alanlar sunar.

  • Widget işlemleri. Etkinlik nesneleri Ayrıca, widget widget'ını sağlamak için de kullanılır. aynısını kullanarak Gmail eklentilerinin kullandığı eylem modeli pek de iyi olmadığını unutmayın. Google Workspace eklentilerinde, tüm widget'lar gibi Action nesne ve işlem tıklayın. Ancak Google Workspace Eklentilerinde işlem etkinliği nesneleri bir geri çağırma işlevinin çalışabileceği daha da fazla bilgi içerir.

    Widget işlemlerinin sonucunda oluşturulan etkinlik nesneleri, bağlamsal tetikleyici etkinlik nesnelerine dahil edilen alanlar ve şunları içeren alanlar: widget bilgileri.

  • Bağlantı tetikleyicilerini önizleyin. Google Dokümanlar, E-Tablolar ve Slaytlar'da şunları yapabilirsiniz: üçüncü taraf hizmetler için bağlantı önizlemelerini yapılandırma belirli URL kalıplarına göre düzenleyebilirsiniz. Kullanıcılar karşılayan bir bağlantıyla etkileşimde bulunduğunda desen, linkPreviewTriggers etkinleşir ve bağlantıyı içeren bir etkinlik nesnesi, tetikleyicinin geri çağırma işlevine örnektir. Eklentiniz, ana makinede bağlantıyla ilgili bilgileri gösteren akıllı çip ve kart bir uygulamadır. Kullanıcıların etkileşimde bulunabilmesi için widget işlemleri de oluşturabilirsiniz: önizleme kartını ve içeriğini kontrol edin.

Etkinlik nesnesi yapısı

Aşağıdaki tabloda, projenizin üst düzey yapısı Google Workspace Eklentileri etkinlik nesneleri. Etkinlik nesne yapısında commonEventObject bulunur ana makineden bağımsız bilgiler için en üst düzey alanı belirtir. Her etkinlik nesnesi ana makineye özel aşağıdaki üst düzey alanlardan birine sahip olduğundan emin olun. etkin ana makine uygulaması: gmailEventObject, calendarEventObject veya driveEventObject.

Geriye dönük uyumluluk için Google Workspace Eklentileri etkinlik nesneleri, Gmail eklentisi işlem etkinliği nesneleri. 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.
Tüm etkinlik nesneleri için ortak bilgileri içeren nesne barındırma uygulamasıdır.
eventObject.calendar
Calendar event object Yalnızca görüşmeyi düzenleyen kişi Google Takvim ise mevcut olur. Nesne içeren bir e-posta alırsınız.
eventObject.drive
Drive event object Yalnızca görüşmeyi düzenleyen kişi Google Drive ise mevcut olmalıdır. Nesne Drive bilgilerini içeren dosyalar.
eventObject.gmail
Gmail event object Yalnızca görüşmeyi düzenleyen kişi Gmail ise mevcut olur. Nesne Gmail bilgilerini içeren iletiler.
eventObject.docs
Docs event object Yalnızca görüşmeyi düzenleyen kişi Google Dokümanlar ise ekran gösterilir. Nesne bölümünü ziyaret edin.
eventObject.sheets
Sheets event object Yalnızca görüşmeyi düzenleyen kişi Google E-Tablolar ise mevcut olmalıdır. Nesne E-Tablolar'ı tıklayın.
eventObject.slides
Slides event object Yalnızca görüşmeyi düzenleyen kişi Google Slaytlar ise ekran gösterilir. Nesne bulun.
Orijinal Gmail eklenti alanları
eventObject.messageMetadata.accessToken string
Kullanımdan kaldırıldı. Erişim jetonu Tekliflerinizi otomatikleştirmek ve optimize etmek için Bu ayarı etkinleştirdiğinizde, geçici Gmail eklenti kapsamları kullanan kullanıcı verilerine erişim etkinleştirilir.

Google Workspace Eklentileri için bu bilgilere eventObject.gmail.accessToken girin.

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

Google Workspace Eklentileri için bu bilgilere eventObject.gmail.messageId girin.

eventObject.clientPlatform string
Kullanımdan kaldırıldı. Etkinliğin nerede olduğunu belirtir (web, iOS veya Android) tarafından kullanılmasına izin verilir.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.platform girin.

eventObject.formInput object
Kullanımdan kaldırıldı. Mevcut değerlerin haritası . İlgili içeriği oluşturmak için kullanılan anahtarları, widget'larla ilişkili dize kimlikleridir ve değerler, dizeler için geçerlidir. Etkinlik nesnesi, formInput öğesini kullanarak birden fazla widget'tan veri okumanız gerektiğinde metin girişleri ve anahtarlar gibi beklenen tekil değerler. Örneğin, birden çok değeri olan widget'lar (örneğin, onay kutuları gibi) olmadan her bir değeri Bunun yerine formInputs.
.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.formInputs alanını kullanabilirsiniz; tek değerlere sahip widget'lar, tek bir öğe.

eventObject.formInputs object
Kullanımdan kaldırıldı. Mevcut değerlerin haritası dizeler halinde sunulan widget'ları gösterir. Anahtarlar dize kimliklerinin bir listesini temsil eder. Tek değerli widget'larda değeri, tek öğeli bir dizide sunulur. Birden çok değerli widget'lar için tüm değerler bir liste halinde sunulur.
.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.formInputs girin.

eventObject.parameters object
Kullanımdan kaldırıldı. Ek bilgilerin bir haritası reklam öğesi için sağladığınız Action - Action.setParameters()) Eşleme anahtarları ve değerleri dizeler için geçerlidir.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.parameters girin.

eventObject.userCountry string
Varsayılan olarak desteği sonlandırıldı ve devre dışı. İlgili içeriği oluşturmak için kullanılan Kullanıcının ülke veya bölgesini belirten iki harfli kod. Ayrıca sayısal UN M49 ülke kodu.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.userLocale girin.

eventObject.userLocale string
Varsayılan olarak desteği sonlandırıldı ve devre dışı. İlgili içeriği oluşturmak için kullanılan iki harfli ISO 639 kullanıcının dilini gösteren kod. Görüntüleyin Kullanıcıya erişme yerel ayarı ve saat dilimini inceleyin.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.userLocale girin.

eventObject.userTimezone.id string
Varsayılan olarak desteği sonlandırıldı ve devre dışı. İlgili içeriği oluşturmak için kullanılan kullanıcının saat diliminin saat dilimi tanımlayıcısını içermelidir. Örnekler: America/New_York, Europe/Vienna ve Asia/Seoul. Görüntüleyin Daha fazla ayrıntı için kullanıcının yerel ayarına ve saat dilimine erişme.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.timeZone.id girin.

eventObject.userTimezone.offset string
Varsayılan olarak desteği sonlandırıldı ve devre dışı. İlgili içeriği oluşturmak için kullanılan kullanıcının Eşgüdümlü Evrensel Saati'nden (UTC) zaman farkı milisaniye cinsinden ölçülen saat dilimi. Görüntüleyin Daha fazla ayrıntı için kullanıcının yerel ayarına ve saat dilimine erişme.

Google Workspace Eklentileri için bu bilgilere eventObject.commonEventObject.timeZone.offset girin.

Ortak etkinlik nesnesi

Ortak etkinlik nesnesi, şunu içeren genel etkinlik nesnesinin kısmıdır: Kullanıcının istemcisindeki eklentiye ilişkin ana makineden bağımsız genel bilgilerdir. Bu Bu bilgiler arasında kullanıcının yerel ayarı, ana makine uygulaması ve platformu gibi ayrıntılar bulunur.

Eklentiler, ana sayfa tetikleyicileri ve bağlamsal tetikleyicilere ek olarak işlem geri çağırma işlevlerine etkinlik nesneleri Kullanıcı widget'larla etkileşimde bulunduğunda. Eklentinizin geri çağırma işlevi, kullanıcının cihazındaki açık widget'ların içeriğini belirlemek için ortak etkinlik nesnesini gerekir. Örneğin, eklentiniz bir kullanıcının TextInput widget'ı eventObject.commentEventObject.formInputs nesne.

Ortak etkinlik nesnesi alanları
commonEventObject.platform string
Etkinliğin nereden kaynaklandığını belirtir (`WEB`, "IOS" veya "ANDROID").
commonEventObject.formInputs object
widget'ları görebilirsiniz. Eşleme anahtarları dize kimlikleridir her bir widget'la atanır.

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

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

    Örnek: bir metin girişi widget'ı için employeeName kimliğine sahipseniz metne erişin şununla giriş değeri: e.commonEventObject.formInputs.employeeName.stringInputs.value[0]

  • Birden çok değerli widget'lar (örneğin, onay kutusu grupları): dizeler için geçerlidir.

    Örnek: participants ise değere erişin dizi: e.commonEventObject.formInputs.participants.stringInputs.value.

  • A date-time picker: öö DateTimeInput object

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

  • A date-only picker: öö DateInput object

    Örnek: myDatePicker kimliğine sahip bir seçici için şuna erişin: DateInput nesne kullanılıyor e.commonEventObject.formInputs.myDatePicker.dateInput.

  • A time-only picker: öö TimeInput object

    Örnek: myTimePicker kimliğine sahip bir seçici için şuna erişin: TimeInput nesne kullanılıyor e.commonEventObject.formInputs.myTimePicker.timeInput.
commonEventObject.hostApp string
Eklentinin etkin olduğu ana makine uygulamasını gösterir etkinlik nesnesi oluşturulduğunda. Olası değerler takip etmek için:
  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
commonEventObject.parameters object
Kullandığınız diğer parametreler Action için tedarik zincirini Action.setParameters().
commonEventObject.userLocale string
Varsayılan olarak devre dışıdır. Kullanıcının dili ve ülke/bölge tanımlayıcısını ISO 639 dil kodu-ISO 3166 ülke/bölge kodundan oluşur. Örneğin, en-US.

Bu alanı etkinleştirmek için addOns.common.useLocaleFromApp değerini şu şekilde ayarlamanız gerekir: Eklentinizin manifest dosyasında true. Eklentinizin kapsam listesi de https://www.googleapis.com/auth/script.locale dahildir. Bkz. Daha fazla ayrıntı için kullanıcının yerel ayarına ve saat dilimine erişme.

commonEventObject.timeZone string
Varsayılan olarak devre dışıdır. Saat dilimi kimliği ve ofset. Bu alanı etkinleştirmek için şunları ayarlamanız gerekir: Eklentinizin manifest dosyasında addOns.common.useLocaleFromApp to true adresine gidin. Eklentinizin kapsam listesinde de şunlar bulunmalıdır: https://www.googleapis.com/auth/script.locale Bkz. Daha fazla ayrıntı için kullanıcının yerel ayarına ve saat dilimine erişme.
commonEventObject.timeZone.id string
kullanıcının saat diliminin saat dilimi tanımlayıcısını içerir. Örnekler: America/New_York, Europe/Vienna ve Asia/Seoul. Bu alanı etkinleştirmek için şunları ayarlamanız gerekir: Eklentinizin manifest dosyasında addOns.common.useLocaleFromApp to true adresine gidin. Eklentinizin kapsam listesinde de şunlar bulunmalıdır: https://www.googleapis.com/auth/script.locale Görüntüleyin Daha fazla ayrıntı için kullanıcının yerel ayarına ve saat dilimine erişme.
commonEventObject.timeZone.offset string
kullanıcının Eşgüdümlü Evrensel Saati'nden (UTC) zaman farkı milisaniye cinsinden ölçülen saat dilimi. Görüntüleyin Daha fazla ayrıntı için kullanıcının yerel ayarına ve saat dilimine erişme.

Tarih ve saat seçici form girişleri

İşlem geri çağırma işlevleri commonEventObject.formInputs alanındaki geçerli widget değerlerini alabilir. Kullanıcının tarih veya saat seçicide seçtiği tarih veya saat değerleri de buna dahildir widget'lar. Ancak bilgilerin yapısı, bilginin mevcut olup olmadığına bağlı olarak widget; tarih ve saat seçici, yalnızca tarih seçici veya yalnızca saat olarak yapılandırıldı. kullanabilirsiniz. Yapısal farklılıklar aşağıdaki tabloda açıklanmıştır:

DateTimeInput nesnesi
dateTimeInput.hasDate Tarih saat girildiyse boolean
true Bir tarih içermelidir; (false yalnızca bir saat dahil edilirse)
dateTimeInput.hasTime Tarih saat girildiyse boolean
true bir zaman içerir; false yalnızca bir tarih eklenirse.
dateTimeInput.msSinceEpoch string
Kullanıcının seçtiği zaman (milisaniye cinsinden) Epoch'tan beri (1 Ocak 1970'te 00:00:00 UTC)
DateInput nesnesi
dateInput.msSinceEpoch string
Kullanıcının seçtiği zaman (milisaniye cinsinden) Epoch'tan beri (1 Ocak 1970'te 00:00:00 UTC)
Zaman Girişi nesnesi
timeInput.hours number
Kullanıcının seçtiği saat numarası.
timeInput.minutes number
Kullanıcının seçtiği dakika numarası.

Takvim etkinliği nesnesi

Takvim etkinliği nesnesi, genel etkinlik nesnesinin Kullanıcının takvimi ve takvim etkinlikleri hakkında bilgi içerir. Yalnızca bir etkinlik nesnesinde bulunur.

Aşağıdaki tabloda, calendarEventObject sütununda bulunan alanlar listelenmiştir. alanında görünür. Kullanıcı tarafından oluşturulan veriler olarak işaretlenmiş alanlar Etkinlik nesnesinde, yalnızca veriler Takvim'de mevcutsa ve bu veriler etkinlik ve eklenti, addOns.calendar.currentEventAccess manifest alanı READ veya READ_WRITE.

Takvim etkinliği nesnesi
calendar.attendees[]
list of attendee objects Kullanıcı tarafından oluşturulan veriler. Takvim katılımcılarının listesi unutmayın.
calendar.calendarId string
Takvim kimliği.
calendar.capabilities object
Kullanıcı tarafından oluşturulan veriler. Nesne Eklentinin etkinliği görüntüleme veya güncelleme özelliklerini açıklayan ekleyebilirsiniz.
calendar.capabilities.canAddAttendees boolean
Kullanıcı tarafından oluşturulan veriler. true. Eklentinin, etkinlik katılımcı listesine yeni katılımcılar ekleyip ekleyemediği; Aksi takdirde false.
calendar.capabilities.canSeeAttendees boolean
Kullanıcı tarafından oluşturulan veriler. true. Eklenti, etkinlik katılımcı listesini okuyabiliyorsa false aksi takdirde.
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üncelleyebiliyor mu? 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. Konferans verilerini temsil eden bir nesne (ör. Google Meet konferans ayrıntıları) bu etkinlikle ilişkilidir.
calendar.id string
Etkinlik kimliği.
calendar.organizer object
Etkinliği düzenleyeni temsil eden bir nesne unutmayın.
calendar.organizer.email string
Etkinliği düzenleyen kullanıcının e-posta adresi.
calendar.recurringEventId string
Düzenli etkinliğin kimliği.

Katılımcı

Katılımcı nesneleri, her bir katılımcıyla ilgili bilgileri Google Takvim'e taşır etkinlikler. Bu bilgi, yalnızca veri işlemenin gerçekleşmesi durumunda Takvim etkinliğinde mevcutsa eklenti, addOns.calendar.currentEventAccess. manifest alanı READ veya READ_WRITE.

Katılımcı nesnesi
attendee.additionalGuests number
Katılımcının ek davetlilerin sayısı getirdiklerini belirtmişti. 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ı e-posta adresi.
attendee.optional Bu etkinliğe katılım durumu boolean
true ise katılımcı isteğe bağlı olarak işaretlendi; Aksi takdirde false.
attendee.organizer boolean
true (katılımcı: bu etkinliğin düzenleyicisi.
attendee.resource Katılımcı bir kişiyi temsil ediyorsa boolean
true oda veya ekipman gibi bir kaynak; false aksi takdirde.
attendee.responseStatus string
Katılımcının yanıt durumu. Mümkün değerleri şunları içerir:
  • accepted: Katılımcı etkinliği kabul etti gönderin.
  • declined: Katılımcı, etkinliği reddetti gönderin.
  • needsAction: Katılımcı yanıt vermedi Etkinlik davetiyesi.
  • tentative: Katılımcı, yanıtı belirsiz olarak kabul etti. Etkinlik davetiyesi.
attendee.self Bu katılımcı şu kişiyi temsil ediyorsa boolean
true bu etkinliğin göründüğü takvim; Aksi takdirde false.

Konferans verileri

Konferans veri nesneleri, ekli konferanslarla ilgili bilgileri içerir Google Takvim etkinliklerine hoş geldiniz. Bu çözümler arasında yer alan Google konferans çözümleri Google Meet veya üçüncü taraf konferanslar olabilir. Bu bilgiler, etkinlik nesnesidir. Yalnızca, verilerin Takvim etkinliğinde ve eklenti, addOns.calendar.currentEventAccess özelliğini ayarlar manifest alanı READ veya READ_WRITE.

Konferans veri nesnesi
conferenceData.conferenceId string
Konferansın kimliği. Bu kimliğin amacı uygulamaların konferansları takip etmesine izin vermek; yapmamalısın bu kimliği kullanıcılara gösterir.
conferenceData.conferenceSolution object
Konferansı temsil eden bir nesne örneğin Hangouts veya Google Meet gibi
conferenceData.conferenceSolution.iconUri string
Kullanıcının görebileceği simgenin URI'sı konferans çözümü.
conferenceData.conferenceSolution.key object
Google Ads'i benzersiz bir şekilde tanımlayan anahtar konferans çözümünüz var.
conferenceData.conferenceSolution.key.type string
Konferans çözümü türü. Muhtemel değerler şunları içerir:
  • Tüketicilere yönelik Hangouts için eventHangout (http://hangouts.google.com).
  • Klasik Hangouts için eventNamedHangout Google Workspace kullanıcıları (http://hangouts.google.com).
  • Google Meet için hangoutsMeet (http://meet.google.com).
conferenceData.conferenceSolution.name string
Bu konferansın kullanıcılar tarafından görülebilen adı (yerelleştirilmiş değil).
conferenceData.entryPoints[] list of entry point objects.
URL'ler veya telefon numaraları gibi konferans giriş noktalarının listesi.
conferenceData.notes string
Ek notlar (ör. veya yasal uyarılar) e-posta adresinize kullanıcıya gösterilir. HTML içerebilir. Maksimum uzunluk 2.048 karakterdir. karakteri ekleyin.
conferenceData.parameters object
Tanımlanmış öğenin haritasını içeren bir nesne parametre verilerini kontrol edin.
conferenceData.parameters.addOnParameters object
Parametre dizesi anahtarlarının ve değerlerinin eşlemesi. Bu anahtarlar ve değerler, eklenecek eklenti geliştiricisi tarafından tanımlanır belirli bir konferansa gönderebilirsiniz.

Giriş noktası

Giriş noktası nesneleri, yaygın olarak kullanılan erişim yöntemleri hakkında bilgi taşır konferans üzerinden (ör. telefon veya video aracılığıyla) Bu bilgiler veri Takvim etkinliğinde mevcutsa etkinlik nesnesini ve yalnızca eklenti addOns.calendar.currentEventAccess özelliğini ayarlar manifest alanı READ veya READ_WRITE.

Giriş noktası nesnesi
entryPoint.accessCode string
Konferansa erişmek için kullanılan erişim kodu. En çok 128 karakter kullanılabilir. Konferans sağlayıcılar genellikle {accessCode, meetingCode, passcode, password, pin} - konferanslara erişim sağlar. Eşleştir ve yalnızca alanları her zaman göster konferans yöneticisi kullanılır.
entryPoint.entryPointFeatures list
Giriş noktasının özellikleri. Şu anda bu özellikler yalnızca phone giriş noktaları için geçerlidir:
  • toll: Giriş noktası ücretli bir telefon araması.
  • toll_free: Giriş noktası ücretsiz bir telefon aramasıdır.
entryPoint.entryPointType string
Giriş noktasının türü. Olası değerler: şu:
  • more: Konferansa katılım için ek talimatlar, telefon numaraları da kullanabilirsiniz. Bir konferansta yalnızca bir more giriş noktası; en az bir başka tür varsa bir giriş noktasının da sağlanması gerekir.
  • phone: Konferansa telefon numarasıyla katılabilirsiniz. CEVAP konferans sıfır veya daha fazla phone giriş noktasına sahip olabilir. Google Takvim yalnızca ilk iki telefon giriş noktasını gösterir. sıralayarak alfabetik olarak sıralayın.
  • sip: SIP üzerinden konferansa katılın. Konferanslar en fazla bir sip giriş noktası olmalıdır.
  • video: HTTP üzerinden konferansa katılın. CEVAP 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. En çok 128 karakter kullanılabilir. Konferans sağlayıcılar genellikle {accessCode, meetingCode, passcode, password, pin} - konferanslara erişim sağlar. Eşleştir ve yalnızca alanları her zaman göster konferans yöneticisi kullanılır.
entryPoint.passcode string
Konferansa erişmek için kullanılan şifre kodu. En çok 128 karakter kullanılabilir. Konferans sağlayıcılar genellikle {accessCode, meetingCode, passcode, password, pin} - konferanslara erişim sağlar. Eşleştir ve yalnızca alanları her zaman göster konferans yöneticisi kullanılır.
entryPoint.password string
Konferansa erişmek için kullanılan şifre. En çok 128 karakter kullanılabilir. Konferans sağlayıcılar genellikle {accessCode, meetingCode, passcode, password, pin} - konferanslara erişim sağlar. Eşleştir ve yalnızca alanları göster konferans yöneticisi kullanılır.
entryPoint.pin string
Konferansa erişmek için kullanılan PIN. En çok 128 karakter kullanılabilir. Konferans sağlayıcılar genellikle {accessCode, meetingCode, passcode, password, pin} - konferanslara erişim sağlar. Eşleştir ve yalnızca alanları her zaman göster konferans yöneticisi kullanılır.
entryPoint.regionCode string
Telefon numarasının bölge kodu. Gerekiyorsa kullanıcı değerini girin. Değerler, genel Bölge kodlarının CLDR listesi
entryPoint.uri string
Giriş noktasının URI'si. Maksimum uzunluk 1300 karakterdir. Biçimlendirme, giriş noktasına bağlıdır tür:
  • more: http: veya https: gerekir.
  • phone: tel: şeması gerekiyor. İlgili içeriği oluşturmak için kullanılan URI, arama sırasının tamamını içermelidir (örneğin, "tel:+12345678900,,,12345678;1234").
  • sip: sip: veya sips: gerekir. Örneğin, "sip:12345678@sağlayıcım.com".
  • video: http: veya https: gerekir.

Drive etkinlik nesnesi

Drive etkinlik nesnesi, genel etkinlik nesnesinin, Kullanıcının Google Drive'ı ve içeriği hakkında bilgi içerir. Yalnızca ana makine uygulaması Google Drive ise bir etkinlik nesnesinde bulunur.

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

Drive öğesi

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

Drive öğesi nesnesi
item.addonHasFileScopePermission boolean
true ise eklenti şu istekte bulundu: ve https://www.googleapis.com/auth/drive.file tarihinde alındı kapsam yetkilendirmesi; Aksi takdirde bu alan false.
item.id string
Seçilen öğenin kimliği.
item.iconUrl string
öğe seçildi.
item.mimeType string
Seçili öğenin MIME türü.
item.title string
Seçilen öğenin başlığı.

Gmail etkinlik nesnesi

Gmail etkinlik nesnesi, genel etkinlik nesnesinin Kullanıcının Gmail iletileriyle ilgili bilgiler. Yalnızca bir etkinlik nesnesinde var ana makine uygulaması Gmail ise.

Gmail etkinlik nesnesi
gmail.accessToken string
Gmail'e özel erişim jetonu. Tekliflerinizi otomatikleştirmek ve optimize etmek için bu jetonu GmailApp.setCurrentMessageAccessToken(accessToken) veya eklentinizin bir kullanıcının şu anda Gmail iletisini açabilir veya eklentinizin yeni taslaklar oluşturmasına izin verebilirsiniz.
gmail.bccRecipients[] list of strings
Varsayılan olarak devre dışıdır. Liste "BCC:" alıcı e-posta adresleri şu anda bir taslakta eklentisi oluşturulur. Bu alanı etkinleştirmek için addOns.gmail.composeTrigger.draftAccess alanını METADATA.
gmail.ccRecipients[] list of strings
Varsayılan olarak devre dışıdır. Liste "CC:" alıcı e-posta adresleri şu anda bir taslakta eklentisi oluşturulur. Bu alanı etkinleştirmek için addOns.gmail.composeTrigger.draftAccess alanını METADATA.
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. Liste "Kime:" alıcı e-posta adresleri şu anda bir taslakta eklentisi oluşturulur. Bu alanı etkinleştirmek için addOns.gmail.composeTrigger.draftAccess alanını METADATA.

Dokümanlar etkinlik nesnesi

Dokümanlar etkinlik nesnesi, genel etkinlik nesnesinin Kullanıcının dokümanı ve içeriği hakkındaki bilgiler. Yalnızca etkinlik nesnesini tanımlayın.

Dokümanlar etkinlik nesnesi
docs.id string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirilir.
Dokümanın kimliği Dokümanlar kullanıcı arayüzünde açılır.
docs.title string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildi.
Dokümanın başlığı Dokümanlar kullanıcı arayüzünde açılır.
docs.addonHasFileScopePermission boolean
true ise eklenti şu istekte bulundu: ve https://www.googleapis.com/auth/drive.file tarihinde alındı Dokümanlar kullanıcı arayüzünde açık doküman için kapsam yetkilendirmesi; Aksi takdirde bu alanı false.
docs.matchedUrl.url string.
Yalnızca aşağıdaki koşullar karşılandığında mevcuttur:
  • https://www.googleapis.com/auth/workspace.linkpreview, kullanıcı tarafından yetkilendirildi.
  • URL, LinkPreviewTriggers tetikleyicisinde belirtilen ana makine kalıbıyla eşleşiyor.
ziyaret edin.
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 Akıllı çiplerle bağlantıları önizleme bölümüne bakın.

Kullanıcının https://www.example.com/12345 bağlantısını önizlediği durumlar için örnek yük: 

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

E-Tablolar etkinlik nesnesi

E-Tablolar etkinlik nesnesi, Kullanıcının dokümanı ve içeriği hakkındaki bilgiler. Yalnızca etkinlik nesnesini tanımlayın.

E-Tablolar etkinlik nesnesi
sheets.id string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildi. E-tablonun kimliği, E-Tablolar kullanıcı arayüzünde açılır.
sheets.title string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildi. E-Tablolar'da açılan e-tablonun başlığı Kullanıcı arayüzü.
sheets.addonHasFileScopePermission boolean
true ise eklenti şu istekte bulundu: ve https://www.googleapis.com/auth/drive.file tarihinde alındı E-Tablolar kullanıcı arayüzünde açık olan e-tablo için kapsam yetkilendirmesi; aksi takdirde bu alan false.
sheets.matchedUrl.url string.
Yalnızca aşağıdaki koşullar karşılandığında mevcuttur:
  • https://www.googleapis.com/auth/workspace.linkpreview, kullanıcı tarafından yetkilendirildi.
  • URL, LinkPreviewTriggers tetikleyicisinde belirtilen ana makine kalıbıyla eşleşiyor.
ziyaret edin.
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 Akıllı çiplerle bağlantıları önizleme bölümüne bakın.

Kullanıcının https://www.example.com/12345 bağlantısını önizlediği durumlar için örnek yük:

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

Slaytlar etkinlik nesnesi

Slaytlar etkinlik nesnesi, genel etkinlik nesnesinin Kullanıcının dokümanı ve içeriği hakkındaki bilgiler. Yalnızca etkinlik nesnesini tanımlayın.

Slaytlar etkinlik nesnesi
slides.id string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildi. Slaytlar'da açılan sununun kimliği Kullanıcı arayüzü.
slides.title string
Yalnızca https://www.googleapis.com/auth/drive.file kapsamı kullanıcı tarafından yetkilendirildi. Sununun başlığı Slaytlar kullanıcı arayüzü.
slides.addonHasFileScopePermission boolean
true ise eklenti şu istekte bulundu: ve https://www.googleapis.com/auth/drive.file tarihinde alındı Slaytlar kullanıcı arayüzünde açık sunu için kapsam yetkilendirmesi; aksi takdirde bu alan false.
slides.matchedUrl.url string.
Yalnızca aşağıdaki koşullar karşılandığında mevcuttur:
  • https://www.googleapis.com/auth/workspace.linkpreview, kullanıcı tarafından yetkilendirildi.
  • URL, LinkPreviewTriggers tetikleyicisinde belirtilen ana makine kalıbıyla eşleşiyor.
ziyaret edin.
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 Akıllı çiplerle bağlantıları önizleme bölümüne bakın.

Kullanıcının https://www.example.com/12345 bağlantısını önizlediği durumlar için örnek yük:

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