Google Workspace eklentileri için tetikleyiciler

Apps Script tetikleyicileri, belirtilen bir etkinlik her gerçekleştiğinde belirtilen bir komut dosyası işlevinin (tetikleyici işlevi) yürütülmesine neden olur. Yalnızca belirli etkinlikler tetikleyicilerin çalışmasına neden olabilir ve her Google Workspace uygulaması farklı bir etkinlik grubunu destekler.

Bir tetikleyici tetiklendiğinde etkinlik nesnesi oluşturulur. Bu JSON yapısı, meydana gelen etkinlik hakkında ayrıntılar içerir. Etkinlik nesnesi 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 gerçekleştirmek üzere kendiniz uygulamanız gereken bir geri çağırma işlevidir. Örneğin, Gmail'i genişleten bir Google Workspace eklentisinde, kullanıcı bir ileti dizisini açtığında yeni bir kart arayüzü oluşturan bir tetikleyici tanımlayabilirsiniz. Bu durumda, event object içinde 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 verilmektedir.

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ış tetikleyiciler olan manifest tetikleyicilerini kullanır.

Manifest tetikleyicileri tamamen Google Workspace eklentisinin manifestinde tanımlanır. Aşağıdakiler, belirgin tetikleyicilere örnek olarak verilebilir:

  • Eklenti ana sayfasını oluşturan ve görüntüleyen ana sayfa tetikleyicileri.
  • Takvim etkinliği: Bir Takvim etkinliği açıldığında yeni bir kart gösteren veya başka işlemler gerçekleştiren Açma tetikleyicileri.
  • 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.
  • Drive onItemsSelected tetikleyicileri, kullanıcı Drive'da bir veya daha fazla dosya ya da klasör seçtiğinde yeni bir kart gösteren veya başka işlemler gerçekleştiren tetikleyicilerdir.
  • Kullanıcı, Gmail'deki yazma penceresinde eklentiyi açtığında eklenti kartı gösteren Gmail yazma tetikleyicileri.
  • Kullanıcı bir Gmail iletisini açtığında yeni bir kart gösteren veya başka işlemler gerçekleştiren Gmail bağlamsal tetikleyicileri.
  • Kullanıcılar, mevcut Doküman Düzenleyici belgesinde drive.file OAuth kapsamı için yetkilendirme verdiğinde yeni bir kart gösteren Editor onFileScopeGranted tetikleyicileri.

Yukarıdaki listede yalnızca ana sayfa tetikleyicileri bağlamdan bağımsızdır. Diğerleri bağlamsal tetikleyicilerdir. Manifest tetikleyici tanımları hakkında daha fazla bilgi için Manifest başlıklı makaleyi inceleyin.

Google Workspace eklentileri, manifest tetikleyicilerine ek olarak Apps Komut Dosyası yüklenebilir tetikleyicilerini de kullanabilir.

Kısıtlamalar

Manifest tetikleyicilerinin kullanımında belirli kısıtlamalar vardır.

  • Bu tetikleyiciler yalnızca Google Workspace eklenti projelerinde kullanılır. Başka uygulamalarda herhangi bir amaçları yoktur.
  • Eklenti manifestinde tanımlandıkları ve kodunda tanımlanmadıkları için bu tetikleyicileri oluşturmak veya değiştirmek üzere Apps Komut Dosyası Script hizmetini kullanamazsınız.
  • Gmail bağlamsal tetikleyicileri şu anda yalnızca unconditional ölçütüne sahip olabilir. Bu, içerikten bağımsız olarak her e-posta iletisi için bağlamsal tetikleyicilerin etkinleştiği anlamına gelir.
  • Her eklenti, kullanıcı, doküman başına her türden yalnızca bir tetikleyiciye sahip olabilir.