Apps Komut Dosyası tetikleyicileri belirtilen bir komut dosyasına neden olur işlevi (tetikleyici işlevi) gerçekleşir. Yalnızca belirli etkinlikler tetikleyicilerin etkinleşmesine neden olabilir ve bunların her biri 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. Etkinlikteki bilgiler nesne yapısı, tetikleyici türüne göre farklı şekilde düzenlenir.
Etkinlik nesnesi oluşturulduktan sonra, Apps Komut Dosyası bu nesneyi parametre olarak tetikleyici işlevi. Tetikleyici işlevi bir geri çağırma işlevidir. gerekli adımları atıp gerekli önlemleri almanız için unutmayın. Örneğin, Gmail'i geliştiren Google Workspace eklentisiyle Kullanıcı bir mesajı açtığında yeni kart arayüzü oluşturan bir tetikleyici tanımlayın ileti dizisi. Bu örnekte, yüksek performanslı olmak için aktarılan verilerle yeni kullanıcı arayüzünü oluşturan kartlar etkinlik nesnesini tanımlayın.
Bu sayfada, Google Workspace eklenti projeleri oluşturabilirsiniz.
Manifest tetikleyicileri
Düzenleyici eklentilerinin aksine, Google Workspace Eklentileri şu anda Apps Komut Dosyası basit tetikleyicilerini kullanamamaktadır Bunun yerine, bu işlem için özel olarak tasarlanmış tetikleyicileri kullanırlar. Google Workspace Eklentileri: manifest tetikleyicileri.
Manifest tetikleyicileri, Google Workspace Eklentisi manifest dosyası için de kullanılabilir. Manifest tetikleyicilerine örnek olarak şunlar verilebilir: takip etmek için:
- Eklenti ana sayfasını oluşturan ve görüntüleyen ana sayfa tetikleyicileri.
- Yeni bir kart görüntüleyen Calendar eventOpen tetikleyicileri Bir Takvim etkinliği açıldığında yapılabilecek diğer işlemler.
- Yeni bir kart gösteren veya yeni bir kart görüntüleyen Calendar eventUpdate tetikleyicileri Kullanıcı bir Takvim etkinliğini düzenleyip kaydettiğinde yapılabilecek diğer işlemler.
- Drive onItemsSelected tetikleyicisi Kullanıcı Drive'da bir veya daha fazla dosya ya da klasör seçtiğinde diğer işlemler.
- Gmail oluşturma tetikleyicileri Kullanıcı, eklentiyi Gmail ileti oluşturma penceresinde açar.
- Yeni bir kart görüntüleyen veya başka bir kartı görüntüleyen Gmail içerik tetikleyicileri Kullanıcı bir Gmail iletisi açtığında çeşitli işlemler.
- Kullanıcılar gerçekleştirdiğinde yeni bir kart gösteren Düzenleyici onFileScopeGranted tetikleyicileri
geçerli Düzenleyicide
drive.fileOAuth kapsamı için yetkilendirme ver uygulayacaksınız.
Yukarıdaki listede yalnızca ana sayfa tetikleyicileri bağlamsal değildir; geri kalanlar Bağlamsal tetikleyiciler bulunur. Manifest dosyasını inceleyin. manifesto tetikleyicisi tanımları hakkında daha fazla bilgi edinin.
Manifest tetikleyicilere ek olarak, Google Workspace Apps Komut Dosyası'nı da kullanabilir yüklenebilir tetikleyiciler.
Kısıtlamalar
Manifest tetikleyicilerinin kullanımıyla ilgili belirli kısıtlamalar vardır.
- Bu tetikleyiciler yalnızca Google Workspace Eklenti projelerinde kullanılır: başka hiçbir uygulamada bir anlamı yoktur.
- Bunlar eklenti manifest'inde tanımlanıp kodunda tanımlanmadığından
Apps Komut Dosyası'nı kullanın
Scripthizmeti kullanabilirsiniz. - Gmail içerik tetikleyicileri şu anda yalnızca
unconditionalölçütüne sahip olabilir. Bu, bağlamsal tetikleyicilerin etkinleştiğinden bağımsız olarak her e-posta iletisi için içerik. - Her eklentinin, kullanıcı ve doküman başına her türde yalnızca bir tetikleyicisi olabilir.