Apps Script tetikleyicileri, belirli bir etkinlik gerçekleştiğinde belirtilen bir komut dosyası işlevinin (tetikleyici işlevi) yürütülmesine neden olur. Yalnızca belirli etkinlikler tetikleyicilerin tetiklenmesine neden olabilir ve her Google Workspace uygulaması farklı bir etkinlik grubunu destekler.
Bir tetikleyici tetiklendiğinde bir etkinlik nesnesi oluşturulur. Bu JSON yapısı, gerçekleşen etkinlikle ilgili 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 Script, tetikleyici işlevine parametre olarak iletir. Tetikleyici işlevi, etkinliğe yanıt vermek için uygun işlemleri yapmak ü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, olay nesnesinde iletilen verileri kullanarak yeni kullanıcı arayüzünü oluşturan kartları oluşturmak için bağlama dayalı bir geri çağırma işlevi uygularsınız.
Bu sayfada, Google Workspace eklenti projelerinde tetikleyicilerin kullanımıyla ilgili kurallar 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ış tetikleyicileri kullanır: manifest tetikleyicileri.
Manifest tetikleyicileri, Google Workspace eklentisinin manifest dosyasında tamamen tanımlanı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 yapan Takvim etkinliği açıldı tetikleyicileri.
- Kullanıcı bir Takvim etkinliğini düzenleyip kaydettiğinde yeni bir kart görüntüleyen veya başka işlemler yapan Takvim eventUpdate 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 yapan Drive onItemsSelected tetikleyicileri.
- Kullanıcı Gmail 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örüntüleyen veya başka işlemler yapan Gmail içeriğe dayalı tetikleyiciler.
- Kullanıcılar geçerli Editor belgesinde
drive.fileOAuth kapsamı için yetki verdiğinde yeni bir kart görüntüleyen Editor onFileScopeGranted tetikleyicileri.
Yukarıdaki listede yalnızca ana sayfa tetikleyicileri bağlam dışıdır; geri kalanlar bağlama dayalı tetikleyicilerdir. Manifest tetikleyici tanımları hakkında daha fazla bilgi için Manifest bölümüne bakın.
Google Workspace eklentileri, manifest tetikleyicilerine ek olarak Apps Komut Dosyası yüklenebilir tetikleyicilerini de kullanabilir.
Kısıtlamalar
Manifest tetikleyicilerinin kullanımına belirli kısıtlamalar vardır.
- Bu tetikleyiciler yalnızca Google Workspace eklenti projelerinde kullanılır ve başka hiçbir uygulamada işe yaramaz.
- Bu tetikleyiciler, eklentinin kodunda değil, manifest dosyasında tanımlandığından bu tetikleyicileri oluşturmak veya değiştirmek için Apps Script
Scripthizmetini kullanamazsınız. - Gmail bağlama dayalı tetikleyicilerinde şu anda yalnızca
unconditionalölçütü kullanılabilir. Bu, içeriğe bakılmaksızın her e-posta iletisinde içeriğe dayalı tetikleyicilerin etkinleştirildiği anlamına gelir. - Her eklentide, kullanıcı başına ve belge başına her türden yalnızca bir tetikleyici olabilir.