Apps Komut Dosyası tetikleyicileri, belirli bir etkinlik gerçekleştiğinde belirli bir komut dosyası işlevinin (tetikleyici işlevi) yürütülmesine neden olur. Yalnızca belirli etkinlikler tetikleyicilerin etkinleşmesine neden olabilir ve her Google Workspace uygulaması farklı bir etkinlik grubunu destekler.
Bir tetikleyici etkinleştiğinde, bir etkinlik nesnesi oluşturulur. Bu JSON yapısı, gerçekleşen etkinlikle ilgili ayrıntıları içerir. Etkinlik nesne yapısındaki bilgiler tetikleyici türüne göre farklı şekilde düzenlenir.
Etkinlik nesnesi oluşturulduktan sonra Apps Komut Dosyası, bunu tetikleyici işlevine parametre olarak aktarır. Tetikleyici işlevi, etkinliğe yanıt vermek için uygun işlemleri yapmak üzere sizin uygulamanız gereken bir geri çağırma işlevidir. Örneğin, Gmail'i genişleten bir Google Workspace eklentisinde, kullanıcı bir ileti dizisi açtığında yeni bir kart arayüzü oluşturan bir tetikleyici tanımlayabilirsiniz. Bu durumda, etkinlik nesnesinde iletilen verileri kullanarak yeni kullanıcı arayüzünü oluşturan kartlar oluşturmak için bağlamsal bir geri çağırma işlevi uygularsınız.
Bu sayfada, Google Workspace eklenti projelerinde tetikleyicilerin kullanımıyla ilgili yönergeler sağlanmaktadır.
Manifest tetikleyicileri
Düzenleyici eklentilerinin aksine Google Workspace eklentileri şu anda Apps Komut Dosyası basit tetikleyicilerini kullanamaz. Bunun yerine Google Workspace Eklentileri için özel olarak tasarlanmış manifest tetikleyicileri kullanan tetikleyiciler kullanılır.
Manifest tetikleyicileri tümüyle Google Workspace Eklentisi'nin manifest'inde tanımlanmıştır. Manifest tetikleyicilerine örnek olarak aşağıdakiler verilebilir:
- Eklenti ana sayfasını oluşturan ve görüntüleyen ana sayfa tetikleyicileri.
- Bir Takvim etkinliği açıldığında yeni bir kart görüntüleyen veya başka işlemler gerçekleştiren Takvim etkinliği tetikleyicilerini açın.
- Bir kullanıcı bir Takvim etkinliğini düzenleyip kaydettiğinde yeni bir kart görüntüleyen veya başka işlemler gerçekleştiren Takvim etkinliği güncelleme tetikleyicileri.
- Kullanıcı, Drive'da bir veya daha fazla dosya ya da klasör seçtiğinde yeni bir kart görüntüleyen veya başka işlemler gerçekleştiren Drive onItemsSelected tetikleyicileri.
- Kullanıcı eklentiyi Gmail oluşturma penceresinde açtığında bir eklenti kartı görüntüleyen Gmail oluşturma tetikleyicileri.
- Kullanıcı bir Gmail iletisini açtığında yeni bir kart görüntüleyen veya başka işlemler gerçekleştiren Gmail içeriğe dayalı tetikleyicileri.
- Kullanıcılar mevcut Düzenleyici dokümanında
drive.fileOAuth kapsamı için yetkilendirme verdiğinde yeni bir kart gösteren düzenleyici onFileScopeGranted tetikleyicileri.
Yukarıdaki listede yalnızca ana sayfa tetikleyicileri bağlamsal değildir, geri kalanı ise içeriğe dayalı tetikleyicilerdir. Manifest tetikleyici tanımları hakkında daha fazla bilgi için Manifest sayfasını inceleyin.
Google Workspace eklentileri, manifest tetikleyicilerinin yanı sıra Apps Komut Dosyası yüklenebilir tetikleyicilerini de kullanabilir.
Kısıtlamalar
Manifest tetikleyicilerinin kullanımı için belirli kısıtlamalar vardır.
- Bu tetikleyiciler yalnızca Google Workspace eklentisi projelerinde kullanılır ve başka hiçbir uygulamada işe yaramaz.
- Bunlar eklentinin kodunda değil, eklenti manifest dosyasında tanımlandığından bu tetikleyicileri oluşturmak veya değiştirmek için Apps Komut Dosyası
Scripthizmetini kullanamazsınız. - Gmail içerik tetikleyicileri şu anda yalnızca
unconditionalölçütüne sahip olabilir. Bu, içeriğe dayalı tetikleyicilerin içeriğinden bağımsız olarak her e-posta iletisi için etkinleşeceği anlamına gelir. - Her eklentinin her türden (kullanıcı ve doküman başına) yalnızca bir tetikleyicisi olabilir.