Action nesneleri, Google Workspace eklentilerine etkileşimli davranışlar eklemenize olanak tanır. Bu işlevler, kullanıcı eklenti kullanıcı arayüzündeki bir widget'la (ör. düğme) etkileşimde bulunduğunda ne olacağını tanımlar.
İşlem, belirli bir widget'a widget işleyici işlevi kullanılarak eklenir. Bu işlev, işlemi tetikleyen koşulu da tanımlar. İşlem tetiklendiğinde, belirlenen bir geri çağırma işlevi yürütülür. Geri çağırma işlevine, kullanıcının istemci tarafındaki etkileşimleriyle ilgili bilgileri taşıyan 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 işlemini 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ülecek bir Apps Script geri çağırma işlevi belirtir. Bu durumda, istediğiniz kartı oluşturmak ve bir ActionResponse nesnesi döndürmek için geri çağırma işlevini uygularsınız. Yanıt nesnesi, eklentiye geri çağırma işlevinin oluşturduğu kartı göstermesini söyler.
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 iletiler oluşturmak için Gmail'e özel ek bir 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:
| İşlem deneniyor | Geri çağırma işlevi şunu döndürmelidir: |
|---|---|
| Taslak ileti oluşturma | ComposeActionResponse |
Bu widget işlemlerini ve yanıt nesnelerini kullanmak için eklentinin manifest dosyasına https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope eklemesi gerekir.
Mesaj yaz
Gmail'i genişleten bir Google Workspace eklentisi, etkileşimde bulunulduğunda Gmail'de taslak iletiler (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şkilendirmeniz gerekir. Geri çağırma işlevi yürütülmeyi tamamladığında Gmail, bir taslak oluşturma penceresi açıp doldurmak için bu yanıt nesnesini kullanır.
Daha fazla bilgi ve örnek için Taslak ileti oluşturma başlıklı makaleyi inceleyin.