Gmail manifest kaynağı

Gmail'deki Google Workspace Eklentisi içeriğini ve davranışını tanımlamak için kullanılan kaynak yapılandırması. Gmail'i genişleten Google Workspace eklentisi manifestlerinde tüm bileşenler Zorunlu olarak işaretlenmelidir.

Gmail

Gmail uzantıları için Google Workspace eklentisi manifest yapılandırması. Daha fazla bilgi için Gmail'i Google Workspace eklentileriyle 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 koşulu 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.

Gereksiz yürütme gecikmesini önlemek için bu işlevin desteği sonlandırıldı. Bunun yerine eklenti, bu örnekte gösterildiği gibi ana çağrıdan bir istisna atmalıdır.

composeTrigger

object (ComposeTrigger)

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

Ayrıntılar için Oluşturma kullanıcı arayüzünü oluşturma 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ştirildiğinde, genellikle yeni kart oluşturmak ve kullanıcı arayüzünü güncellemek için belirli bir Apps Script işlevi yürütür.
homepageTrigger

object (HomepageTrigger)

Gmail barındırıcısında eklenti ana sayfasını oluşturmak için tetikleyici işlevi spesifikasyonu. 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 Oluşturma 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 ayardır. Bu durum, oluşturma tetikleyici işlevine iletilen etkinlik nesnesinin çoğunlukla boş olmasına neden olur.
  • METADATA, 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)

Oluşturma kullanıcı arayüzleri oluşturan oluşturma işlemlerinin listesi. Ancak bu liste eklenti başına tek bir işlemle sınırlıdır. Oluşturma işleminin Gmail yazma penceresinde ilgili 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 tetikleyicinin yapılandırması. Daha fazla bilgi için Mesaj kullanıcı arayüzünü genişletme başlıklı makaleyi inceleyin.

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

string

Her bağlama dayalı tetikleyici için zorunludur. Tetikleyici etkinleştirildiğinde çalıştırılan 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ğlama dayalı tetikleyici için zorunludur. Bağlamsal tetikleyicinin, tüm Gmail iletileri açıldığında etkinleştirileceğini belirtmek için kullanılır. Şu anda tek seçenek bu olduğundan bu her zaman boş bir nesne olmalıdır.

SelectAction

Kullanıcı oluşturma işlemini seçtiğinde hangi işlevin çalışacağını tanımlayan oluşturma işlemi yapılandırması.

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

string

Oluşturma işlemleri için gereklidir. Bu oluşturma işlemi seçildiğinde çalıştırılan Apps Script işlevinin adı. Bu oluşturma tetikleyici işlevi, eklenti oluşturma kullanıcı arayüzünü oluşturur.

Ayrıntılar için Tetikleyici işlevi oluşturma başlıklı makaleyi inceleyin.

text

string

Oluşturma işlemleri için gereklidir. Bu oluşturma işleminin kısa bir metin açıklaması.