Action nesneleri, Google Workspace eklentilerine etkileşimli davranışlar eklemenize olanak tanır. Eklenti kullanıcı arayüzünde bir kullanıcı bir widget'la (ör. düğme) etkileşimde bulunduğunda ne olacağını tanımlar.
Bir işlem, widget işleyici işlevi kullanılarak belirli bir widget'a eklenir. Bu işlev, işlemi tetikleyen koşulu da tanımlar. Tetiklendiğinde işlem, belirlenmiş bir geri çağırma işlevini yürütür. Geri çağırma işlevine, kullanıcının istemci tarafı etkileşimleriyle ilgili bilgileri içeren bir etkinlik nesnesi iletilir. Geri çağırma işlevini uygulamanız ve belirli bir yanıt nesnesi döndürmesini sağlamanız gerekir.
Örneğin, tıklandığında yeni bir kart oluşturan ve görüntüleyen bir düğme istediğinizi varsayalım. Bunun için yeni bir düğme widget'ı oluşturmanız ve kart oluşturma Action ayarlamak için düğme widget'ı işleyici işlevini setOnClickAction(action) kullanmanız gerekir. Tanımladığınız Action, düğme tıklandığında yürütülen bir Apps Komut Dosyası geri çağırma işlevini belirtir. Bu durumda, istediğiniz kartı oluşturmak için geri çağırma işlevini uygular ve bir ActionResponse nesnesi döndürürsünüz. Yanıt nesnesi, geri çağırma işlevinin oluşturduğu kartı göstermesi için eklentiye talimat verir.
Bu sayfada, eklentinize ekleyebileceğiniz Gmail'e özgü widget işlemleri açıklanmaktadır.
Gmail etkileşimleri
Gmail'i genişleten Google Workspace eklentileri, taslak ileti oluşturmak için ek bir Gmail'e özgü widget işlemi içerebilir. Bu işlem için ilişkili işlem geri çağırma işlevinin özel bir yanıt nesnesi döndürmesi gerekir:
| Denenen işlem | Geri çağırma işlevi döndürmelidir |
|---|---|
| Taslak ileti oluşturma | ComposeActionResponse |
Bu widget işlemlerini ve yanıt nesnelerini kullanmak için Google Workspace eklentisinin manifestinde https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope'un yer alması gerekir.
Mesaj yaz
Gmail'i genişleten eklentiler, etkileşimde bulunulduğunda Gmail'de ileti taslakları (yeni iletiler veya yanıtlar) oluşturan bir widget tanımlayabilir. Bunu yapmak için tetikleyici widget'ı ComposeActionResponse nesnesi döndüren bir geri çağırma işleviyle ilişkilendirin. Geri çağırma işlevi yürütmeyi tamamladığında Gmail, taslak oluşturma penceresini açmak ve doldurmak için bu yanıt nesnesini kullanır.
Daha fazla bilgi ve örnek için Taslak mesaj oluşturma başlıklı makaleyi inceleyin.