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:
- Gmail, kullanıcı bir iletiyi açtığında ve ileti oluşturduğunda başka bir bağlamsal tetikleyici sağlar.
- Google Takvim, bir kullanıcı bir etkinliği açtığında için bağlamsal bir tetikleyici sağlar.
- Google Drive, kullanıcı Drive dosyalarını seçtiğinde bağlamsal bir tetikleyici sağlar.
İç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.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.clientPlatform |
string Kullanımdan kaldırıldı. Etkinliğin nereden geldiğini (web, iOS veya Android) belirtir.
Google Workspace eklentileri için |
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.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.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.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.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.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.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 |
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:
|
commonEventObject.hostApp |
string Etkinlik nesnesi oluşturulduğunda eklentinin etkin olduğu ana makine uygulamasını belirtir. Olası değerler şunları içerir:
|
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 |
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:
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:
|
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:
|
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:
|
entryPoint.entryPointType |
string Giriş noktasının türü. Olası değerler şunlardır:
|
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:
|
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:
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ı, "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:
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ı, "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:
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ı, "slides" : { "matchedUrl" : { "url" : "https://www.example.com/12345" } } |