Bu sayfada, Google Workspace eklentileri etkinlik nesnelerinin yapısı özetlenmiştir.
Etkinlik nesneleri, kullanıcı bir eklentiyle etkileşime geçtiğinde işlevleri tetiklemek veya geri çağırılmak üzere otomatik olarak oluşturulan ve parametre olarak iletilen JSON yapılardır. 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. Etkin ana makine uygulamasını, istemcinin platformunu, kullanıcı yerel ayarlarını ve diğer bilgileri tanımlamak için ana sayfa tetikleyici işlevinizde bu nesneyi kullanabilirsiniz.Ana sayfa tetiklendiğinde oluşturulan etkinlik nesneleri, diğer iki durumdaki tüm alanları içermez. Widget'larla ve bağlamsal bilgilerle ilgili alanlar atlanır.
İçeriğe dayalı tetikleyiciler. Her ana makine uygulaması, bir dizi bağlamsal tetikleyici sağlar. Kullanıcı belirli bir bağlam girdiğinde etkinleşir. Örneğin:
- Gmail, bir kullanıcı şu işlemleri gerçekleştirdiğinde bağlamsal bir tetikleyici sağlar: Bir iletiyi açtığında bir diğeri ise kullanıcının bir ileti oluşturduğunda.
- Google Takvim, bir kullanıcı şu işlemleri gerçekleştirdiğinde bağlamsal bir tetikleyici sağlar: Bir etkinliği açtığında.
- Google Drive, bir kullanıcı Drive dosyalarını seçer.
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, Gmail eklentilerinin kullandığı işlem modelini kullanarak widget etkileşimi sağlamak için de kullanılır. 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şlemleri sonucunda oluşturulan etkinlik nesneleri, bağlamsal tetikleyici etkinlik nesnelerine dahil edilen tüm alanları ve widget bilgilerini içeren alanları 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şime geçtiğinde
linkPreviewTriggers
tetiklenir ve bağlantıyı içeren bir etkinlik nesnesi tetikleyicinin geri çağırma işlevine iletilir. Eklentiniz, ana makinede bağlantıyla ilgili bilgileri gösteren akıllı çip ve kart kabul edersiniz. Ayrıca, kullanıcıların önizleme kartıyla ve içeriğiyle etkileşime geçmesine olanak tanımak için widget işlemleri de oluşturabilirsiniz.
Etkinlik nesnesi yapısı
Aşağıdaki tabloda, projenizin üst düzey yapısı
Google Workspace Eklentileri etkinlik nesneleri. Etkinlik nesnesi yapısı, ana makineye bağlı olmayan bilgiler için commonEventObject
üst düzey bir alan içerir. 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 eklentisi etkinlik nesneleri, Gmail eklentisi işlem etkinlik 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 .
Tüm etkinlik nesneleri için ortak bilgileri içeren nesne barındırma uygulamasıdır. |
eventObject.calendar |
Calendar event object
Yalnızca arayan düzenleyen Google Takvim ise mevcuttur. Takvim ve etkinlik bilgilerini içeren bir nesne. |
eventObject.drive |
Drive event object
Yalnızca görüşmeyi düzenleyen kişi Google Drive ise mevcut olmalıdır. Drive bilgilerini içeren bir nesne.
|
eventObject.gmail |
Gmail event object
Yalnızca arayan ana makine Gmail ise mevcuttur. Nesne Gmail bilgilerini içeren iletiler. |
eventObject.docs |
Docs event object
Yalnızca arayan ana makine Google Dokümanlar ise mevcuttur. Nesne bölümünü ziyaret edin. |
eventObject.sheets |
Sheets event object
Yalnızca arayan düzenleyen Google E-Tablolar ise mevcuttur. 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 eklentisi 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.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.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 bilgileri |
eventObject.formInput |
object Kullanımdan kaldırıldı. Karttaki tüm form widget'larının mevcut değerlerinin, widget başına bir değerle sınırlı olan bir haritası. Anahtarlar, widget'larla ilişkili dize kimlikleri, değerler ise dizelerdir. 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.formInputs |
object Kullanımdan kaldırıldı. Karttaki widget'ların mevcut değerlerinin dize listeleri olarak sunulan bir haritası. Anahtarlar dize kimliklerinin bir listesini temsil eder. Tek değerli widget'larda değeri, tek öğeli bir dizide sunulur. Onay kutusu grupları gibi çok değerli widget'lar için tüm değerler bir listede sunulur. .
Google Workspace Eklentileri için bu bilgilere
|
eventObject.parameters |
object Kullanımdan kaldırıldı. Action.setParameters() kullanarak
Action parametresine gönderdiğiniz ek parametrelerin haritası. Harita anahtarları ve değerleri dizedir.
Google Workspace eklentileri için bu bilgileri |
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. Sayısal bir UN M49 ülke kodu da olabilir.
Google Workspace eklentileri için bu bilgileri |
eventObject.userLocale |
string Varsayılan olarak desteği sonlandırıldı ve devre dışı. 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 başlıklı makaleyi inceleyin.
Google Workspace Eklentileri için bu bilgilere
|
eventObject.userTimezone.id |
string Desteği sonlandırıldı ve varsayılan olarak devre dışıdır. İ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 . Daha fazla bilgi için
Kullanıcı yerel ayarına ve saat dilimine erişme başlıklı makaleyi inceleyin.
Google Workspace eklentileri için bu bilgileri |
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 bilgileri |
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 bilgiler arasında kullanıcının yerel ayarı, barındırma uygulaması ve platformu gibi ayrıntılar yer alır.
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 istemcisinde açık widget'ların içeriğini belirlemek için ortak etkinlik nesnesini sorgulayabilir. Örneğin, eklentiniz kullanıcının eventObject.commentEventObject.formInputs
nesnesinde bir TextInput
widget'ına girdiği metni bulabilir.
Sık kullanılan 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:
|
commonEventObject.hostApp |
string Etkinlik nesnesi oluşturulduğunda eklentinin etkin olduğu ana uygulamayı gösterir. Olası değerler takip etmek için:
|
commonEventObject.parameters |
object
Action.setParameters() kullanarak
Action 'ye sağladığınız ek parametreler.
|
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 eklentinizin manifest dosyasında |
commonEventObject.timeZone |
string Varsayılan olarak devre dışıdır. Saat dilimi kimliği ve farkı. Bu alanı etkinleştirmek için şunları ayarlamanız gerekir: Eklentinizin manifest dosyasında addOns.common.useLocaleFromApp to true adresine gidin.
Eklentinizin kapsam listesi https://www.googleapis.com/auth/script.locale değerini de içermelidir.
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ı. Ö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. Daha fazla bilgi için Kullanıcı yerel ayarına ve saat dilimine erişme başlıklı makaleyi inceleyin. |
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 ya da saat değerleri de dahildir.
Ancak bilgilerin yapısı, widget'ın tarih ve saat seçici, yalnızca tarih seçici veya yalnızca saat seçici olarak yapılandırılmasına bağlı olarak farklılık gösterir. Yapısal farklılıklar aşağıdaki tabloda açıklanmıştı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. Yalnızca bir etkinlik nesnesinde bulunur.
Aşağıdaki tabloda, calendarEventObject
sütununda bulunan alanlar listelenmiştir.
alanı olacaktır. 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. 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
Eklenti, etkinlik katılımcı listesine yeni katılımcı ekleyebiliyorsa;
false aksi takdirde. |
calendar.capabilities.canSeeAttendees |
boolean Kullanıcı tarafından oluşturulan veriler. true
Eklenti etkinlik katılımcısı 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;
false aksi takdirde.
|
calendar.conferenceData |
Conference data object Kullanıcı tarafından oluşturulan veriler. Bu etkinlikle ilişkili tüm 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 unutmayın. |
calendar.organizer.email |
string Etkinliği düzenleyen kullanıcının e-posta adresi. |
calendar.recurringEventId |
string Düzenli bir etkinliğin kimliği. |
Katılımcı
Katılımcı nesneleri, Google Takvim etkinliklerindeki katılımcılarla ilgili bilgileri içerir. 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 bulunur.
Katılımcı nesnesi | |
---|---|
attendee.additionalGuests |
number Katılımcının getireceğini belirttiği ek konuk sayısı. Varsayılan değer sıfırdır. |
attendee.comment |
string Katılımcının yanıt yorumu (varsa). |
attendee.displayName |
string Katılımcıya gösterilen ad. |
attendee.email |
string Katılımcının 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. Olası değerler şunlardır:
|
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 verileri nesneleri, Google Takvim etkinliklerine ekli konferanslarla ilgili bilgileri içerir. Bu çözümler arasında yer alan Google konferans çözümleri
Google Meet veya üçüncü taraf konferanslar olabilir. Bu bilgiler, veriler Takvim etkinliğinde mevcutsa ve eklenti addOns.calendar.currentEventAccess
manifest alanını READ
veya READ_WRITE
olarak ayarlarsa etkinlik nesnesinde bulunur.
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östermemeniz gerekir. |
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 Bu etkinlik için konferans çözümünü benzersiz şekilde tanımlayan anahtar. |
conferenceData.conferenceSolution.key.type |
string Konferans çözümü türü. Olası değerler şunları içerir:
|
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 Kullanıcıya gösterilecek konferansla ilgili ek notlar (ör. alan yöneticisinden gelen talimatlar veya yasal uyarılar). HTML içerebilir. Maksimum uzunluk 2.048 karakterdir. karakteri ekleyin. |
conferenceData.parameters |
object Eklentinin kullanacağı tanımlanmış parametre verilerinin haritasını içeren bir nesne. |
conferenceData.parameters.addOnParameters |
object Parametre dize anahtarlarının ve değerlerinin haritası. Bu anahtarlar ve değerler, eklentinin kullanımı için belirli bir konferansa bilgi eklemek amacıyla eklenti geliştiricisi tarafından 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 içerir. 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. Maksimum uzunluk 128 karakterdir. Konferans sağlayıcılar genellikle { accessCode , meetingCode ,
passcode , password , pin } -
konferanslara erişim sağlar. Konferans sağlayıcının kullandığı alanları eşleştirip yalnızca bu alanları gösterin.
|
entryPoint.entryPointFeatures |
list Giriş noktasının özellikleri. Şu anda bu özellikler yalnızca phone giriş noktaları için geçerlidir:
|
entryPoint.entryPointType |
string Giriş noktasının türü. Olası değerler: şu:
|
entryPoint.label |
string Giriş noktası URI'si için kullanıcı tarafından görülebilen etiket (yerelleştirilmez). |
entryPoint.meetingCode |
string Konferansa erişmek için kullanılan toplantı kodu. Maksimum uzunluk 128 karakterdir. 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 konferanslara erişim sağlamak için genellikle { accessCode , meetingCode ,
passcode , password , pin } değerlerinin yalnızca bir alt kümesini kullanır. Eşleştir ve yalnızca alanları 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 konferanslara erişim sağlamak için genellikle { accessCode , meetingCode ,
passcode , password , pin } değerlerinin yalnızca bir alt kümesini kullanır. Konferans sağlayıcının kullandığı alanları eşleştirip yalnızca bu alanları gösterin.
|
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 genellikle { accessCode , meetingCode ,
passcode , password , pin } değerlerinin yalnızca bir alt kümesini kullanır. 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. URI'de ülke kodu yoksa kullanıcılar tarafından gereklidir. Değerler, genel Bölge kodlarının CLDR listesi |
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:
|
Drive etkinlik nesnesi
Drive etkinlik nesnesi, genel etkinlik nesnesinin kullanıcının Google Drive'ı ve içeriği hakkında bilgi taşıyan kısmıdır. Yalnızca ana uygulama 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, dosya veya klasör gibi belirli Drive öğeleriyle ilgili bilgileri içerir.
Drive öğesi nesnesi | |
---|---|
item.addonHasFileScopePermission |
boolean true ise eklenti bu öğe için https://www.googleapis.com/auth/drive.file kapsamlı yetkilendirme isteğinde bulunmuş ve bu yetkilendirmeyi almış demektir. Aksi takdirde bu alan false değerini alır.
|
item.id |
string Seçilen öğenin kimliği. |
item.iconUrl |
string öğe seçildi. |
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 kullanıcının Gmail iletileriyle ilgili bilgileri taşıyan kısmıdır. Yalnızca barındıran uygulama Gmail ise bir etkinlik nesnesinde bulunur.
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 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 bir taslağa şu anda dahil edilen "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. 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
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. 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:
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ı "docs" : { "matchedUrl" : { "url" : "https://www.example.com/12345" } } |
E-Tablolar etkinlik nesnesi
E-Tablolar etkinlik nesnesi, genel etkinlik nesnesinin kullanıcının dokümanı ve içeriği hakkında bilgi taşıyan kısmıdır. 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 kullanıcı arayüzünde açık olan e-tablonun başlığı.
|
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 yetkilendirmesi istemiş ve almış demektir. Aksi takdirde bu alan false olur.
|
sheets.matchedUrl.url |
string
Yalnızca aşağıdaki koşullar karşılanırsa gösterilir:
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ı "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. 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 yetkilendirilmişse bulunur. 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 yetkilendirilmişse bulunur. Slaytlar kullanıcı arayüzünde açık olan 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ış demektir. Aksi takdirde bu alan false olur.
|
slides.matchedUrl.url |
string
Yalnızca aşağıdaki koşullar karşılanırsa gösterilir:
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ı "slides" : { "matchedUrl" : { "url" : "https://www.example.com/12345" } } |