Action

Form gönderildiğinde gerçekleşecek davranışı açıklayan bir işlem. Örneğin, formu işlemek için bir Apps Komut Dosyası çağırabilirsiniz. İşlem tetiklenirse form değerleri sunucuya gönderilir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

JSON gösterimi 
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction),
  "requiredWidgets": [
    string
  ],
  "allWidgetsAreRequired": boolean
}
Alanlar
function

string

İçeren öğe tıklandığında veya başka bir şekilde etkinleştirildiğinde çağrılacak özel bir işlev.

Örnek kullanım için Form verilerini okuma bölümüne bakın.
parameters[]

object (ActionParameter)

İşlem parametrelerinin listesi.
loadIndicator

enum (LoadIndicator)

İşlem çağrılırken işlemin gösterdiği yükleme göstergesini belirtir.
persistValues

boolean

Form değerlerinin işlemden sonra kalıcı olup olmadığını gösterir. Varsayılan değer: false.

true ise işlem tetiklendikten sonra form değerleri kalır. İşlem gerçekleştirilirken kullanıcının değişiklik yapmasına izin vermek için LoadIndicator değerini NONE olarak ayarlayın. Chat uygulamalarındaki kart mesajları için işlemin ResponseType değerini UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki cardId değerini kullanmanız gerekir.

false ise işlem tetiklendiğinde form değerleri temizlenir. İşlem gerçekleştirilirken kullanıcının değişiklik yapmasını önlemek için LoadIndicator değerini SPINNER olarak ayarlayın.
interaction

enum (Interaction)

İsteğe bağlı. İletişim kutusu açılırken gereklidir.

Kullanıcıyla etkileşime (ör. kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak ne yapılacağı.

Belirtilmezse uygulama, normal şekilde bir action (ör. bağlantı açma veya işlev çalıştırma) yürüterek yanıt verir.

Uygulama, interaction belirterek özel etkileşimli şekillerde yanıt verebilir. Örneğin, interaction değerini OPEN_DIALOG olarak ayarlayarak uygulama bir iletişim kutusu açabilir. Belirtildiğinde yükleme göstergesi gösterilmez. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz.
requiredWidgets[]

string

İsteğe bağlı. Bu listeyi, bu işlemin geçerli bir gönderim için ihtiyaç duyduğu widget'ların adlarıyla doldurun.

Bu işlem çağrıldığında burada listelenen widget'ların değeri yoksa form gönderimi iptal edilir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.
allWidgetsAreRequired

boolean

İsteğe bağlı. Bu değer doğru ise tüm widget'lar bu işlem için gerekli kabul edilir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

ActionParameter

İşlem yöntemi çağrıldığında sağlanacak dize parametrelerinin listesi. Örneğin, üç erteleme düğmesi olduğunu varsayalım: şimdi ertele, bir gün ertele veya gelecek hafta ertele. Dize parametreleri listesinde erteleme türünü ve erteleme süresini ileterek action method = snooze() parametresini kullanabilirsiniz.

Daha fazla bilgi için CommonEventObject başlıklı makaleyi inceleyin.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

JSON gösterimi 
{
  "key": string,
  "value": string
}
Alanlar
key

string

İşlem komut dosyasının parametre adı.
value

string

Parametrenin değeri.

LoadIndicator

İşlem çağrılırken işlemin gösterdiği yükleme göstergesini belirtir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
SPINNER İçeriğin yüklendiğini belirtmek için bir dönen simge gösterir.
NONE Hiçbir şey gösterilmez.

Etkileşim

İsteğe bağlı. İletişim kutusu açılırken gereklidir.

Kullanıcıyla etkileşime (ör. kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak ne yapılacağı.

Belirtilmezse uygulama, normal şekilde bir action (ör. bağlantı açma veya işlev çalıştırma) yürüterek yanıt verir.

Uygulama, interaction belirterek özel etkileşimli şekillerde yanıt verebilir. Örneğin, interaction değerini OPEN_DIALOG olarak ayarlayarak uygulama bir iletişim kutusu açabilir.

Belirtildiğinde yükleme göstergesi gösterilmez. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz.

Sıralamalar
INTERACTION_UNSPECIFIED Varsayılan değer. action normal şekilde yürütülür.
OPEN_DIALOG

Chat uygulamalarının kullanıcılarla etkileşim kurmak için kullandığı pencereli, kart tabanlı bir arayüz olan iletişim kutusunu açar.

Yalnızca kart mesajlarındaki düğme tıklamalarına yanıt olarak Chat uygulamaları tarafından desteklenir. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz.