Gmail manifest kaynağı

Gmail'deki Google Workspace eklentisi içeriğini ve davranışını tanımlamak için kullanılan kaynak yapılandırması. Google Workspace eklenti manifestoları, Gmail'i genişletiyorsa Zorunlu olarak işaretlenen tüm bileşenleri içermelidir.

Gmail

Gmail uzantıları için Google Workspace eklenti manifest yapılandırması. Daha fazla bilgi için Google Workspace eklentileriyle Gmail'i genişletme başlıklı makaleyi inceleyin.

JSON gösterimi
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
Alanlar
authorizationCheckFunction

string

Kullanımdan kaldırıldı. Üçüncü taraf yetkilendirme şartı kontrollerini gerçekleştiren bir Apps Komut Dosyası işlevinin adı. Bu işlev, Google Workspace eklentisinin her çağrılmasından önce çağrılır.

Bu işlev, gereksiz yürütme gecikmesini önlemek için kullanımdan kaldırıldı. Bunun yerine, bu örnekte gösterildiği gibi, eklenti ana çağırmadan bir istisna oluşturmalıdır.

composeTrigger

object (ComposeTrigger)

E-posta oluşturma işlemleri için gereklidir. Kullanıcının e-posta oluştururken kullanabileceği kullanıcı arayüzlerini tanımlar.

Ayrıntılar için Yazma kullanıcı arayüzünü yazma işlemleriyle genişletme başlıklı makaleyi inceleyin.

contextualTriggers[]

object (ContextualTrigger)

Zorunludur. Gmail'de bir ileti açıldığında tetiklenen tetikleyicilerin listesi. Tetikleyici etkinleştiğinde belirli bir Apps Komut Dosyası işlevini yürütür. Bu işlev genellikle yeni kartlar oluşturmak ve kullanıcı arayüzünü güncellemek için kullanılır.
homepageTrigger

object (HomepageTrigger)

Eklenti oluşturmak için tetikleyici işlev spesifikasyonu Gmail ana makinesinde ana sayfa. Bu işlem, addOns.common.homepageTrigger seçeneğini geçersiz kılar.

ComposeTrigger

Bir oluşturma işleminin yapılandırması. Daha fazla bilgi için Compose kullanıcı arayüzünü genişletme başlıklı makaleyi inceleyin.

JSON gösterimi
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
Alanlar
draftAccess

string

Bir oluşturma tetikleyici işlevinin kullanabileceği veri erişim düzeyini tanımlar. Geçerli seçenekler şunlardır:

  • NONE (varsayılan ayar). Bu durum, compose tetikleyici işlevine iletilen event nesnesinin büyük ölçüde boş olmasına neden olur.
  • METADATA: Bu işlev, oluşturma tetikleyici işlevine iletilen etkinlik nesnesini, mesajın alıcılarının listeleriyle doldurur. Bu ayar, eklentinin gmail.addons.current.message.metadata kapsamını içermesini gerektirir.
selectActions[]

object (SelectAction)

E-posta oluşturma kullanıcı arayüzleri oluşturan e-posta oluşturma işlemlerinin listesi. Ancak bu liste, eklenti başına tek bir işlemle sınırlıdır. Yazma işleminin Gmail yazma penceresinde karşılık gelen bir simgesi vardır. Simge, gmail.logoUrl ile belirtilir.

ContextualTrigger

Kullanıcı bir Gmail iletisini açtığında ve bu ileti belirli ölçütleri karşıladığında tetiklenen bir tetikleyicinin yapılandırması. Daha fazla bilgi için İleti kullanıcı arayüzünü genişletme başlıklı makaleyi inceleyin.

JSON gösterimi
{
  "onTriggerFunction": string,
  "unconditional": {},
}
Alanlar
onTriggerFunction

string

Her bağlamsal tetikleyici için zorunludur. Tetikleyici etkinleştirildiğinde yürütülen Apps Komut Dosyası işlevinin adı.

Bu işlevin nasıl tanımlanacağıyla ilgili ayrıntılar için Bağlamsal tetikleyici işlevi bölümüne bakın.

unconditional

object

Her bağlamsal tetikleyici için zorunludur. Bağlamsal tetikleyicinin, açıldığında tüm Gmail iletileri için etkinleşeceğini belirtmek amacıyla kullanılır. Şu anda tek seçenek budur. Bu nedenle, her zaman boş bir nesne olmalıdır.

SelectAction

Kullanıcı, oluşturma eylemini seçtiğinde hangi işlevin çalıştırılacağını tanımlayan oluşturma eylemi yapılandırması.

JSON gösterimi
{
  "runFunction": string,
  "text": string
}
Alanlar
runFunction

string

E-posta oluşturma işlemleri için gereklidir. Bu oluşturma işlemi seçildiğinde yürütülen Apps Komut Dosyası işlevinin adı. Bu oluşturma tetikleyici işlevi, eklenti oluşturma kullanıcı arayüzünü oluşturur.

Ayrıntılar için Oluşturma tetikleyici işlevi konusuna bakın.

text

string

E-posta oluşturma işlemleri için gereklidir. Bu e-posta oluşturma işleminin kısa bir metin açıklaması.