Action

Działanie opisujące zachowanie po przesłaniu formularza. Możesz na przykład wywołać skrypt Apps Script, aby obsłużyć formularz. Jeśli działanie zostanie wywołane, wartości formularza zostaną wysłane na serwer.

Dostępne w przypadku aplikacji do Google Chat i dodatków do Google Workspace.

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

string

Funkcja niestandardowa, która zostanie wywołana po kliknięciu lub aktywowaniu elementu nadrzędnego.

Przykłady użycia znajdziesz w artykule Odczytywanie danych formularza.
parameters[]

object (ActionParameter)

Lista parametrów działania.
loadIndicator

enum (LoadIndicator)

Określa wskaźnik ładowania, który wyświetla działanie podczas wywoływania działania.
persistValues

boolean

Wskazuje, czy wartości formularza są zachowywane po wykonaniu działania. Wartością domyślną jest false.

Jeśli wartość to true, wartości formularza pozostają po wywołaniu działania. Aby umożliwić użytkownikowi wprowadzanie zmian podczas przetwarzania działania, ustaw właściwość LoadIndicator na NONE. W przypadku wiadomości z kartami w aplikacjach do Google Chat musisz też ustawić parametr ResponseType działania na UPDATE_MESSAGE i użyć tego samego parametru cardId z karty, która zawierała działanie.

Jeśli wartość to false, wartości formularza są czyszczone po wywołaniu działania. Aby uniemożliwić użytkownikowi wprowadzanie zmian podczas przetwarzania działania, ustaw LoadIndicator na SPINNER.
interaction

enum (Interaction)

Opcjonalnie. Wymagane podczas otwierania okna.

co zrobić w odpowiedzi na interakcję z użytkownikiem, np. kliknięcie przez użytkownika przycisku w wiadomości z kartą.

Jeśli nie zostanie określona, aplikacja odpowie, wykonując action – np. otwierając link lub uruchamiając funkcję – w normalny sposób.

Po określeniu interaction aplikacja może reagować w specjalny, interaktywny sposób. Jeśli na przykład ustawisz interaction na OPEN_DIALOG, aplikacja będzie mogła otworzyć okno. Jeśli jest określony, wskaźnik wczytywania nie jest wyświetlany. Jeśli jest określony dla dodatku, cała karta jest usuwana i nic nie jest wyświetlane w kliencie.

 Dostępne w przypadku aplikacji do Google Chat i niedostępne w przypadku dodatków do Google Workspace.
requiredWidgets[]

string

Opcjonalnie. Wypełnij tę listę nazwami widżetów, których to działanie wymaga do prawidłowego przesłania.

Jeśli widżety wymienione tutaj nie mają wartości, gdy ta akcja jest wywoływana, przesyłanie formularza zostanie przerwane.

Dostępne w przypadku aplikacji do Google Chat i dodatków do Google Workspace.
allWidgetsAreRequired

boolean

Opcjonalnie. Jeśli ma wartość „true”, wszystkie widżety są uznawane za wymagane przez to działanie.

Dostępne w przypadku aplikacji do Google Chat i dodatków do Google Workspace.

ActionParameter

Lista parametrów ciągu znaków, które mają być podawane podczas wywoływania metody działania. Możesz na przykład dodać 3 przyciski odłożenia: odłóż teraz, odłóż na 1 dzień lub odłóż na następny tydzień. Możesz użyć zdarzenia action method = snooze(), przekazując typ i czas drzemki na liście parametrów ciągu znaków.

Więcej informacji znajdziesz w artykule CommonEventObject.

Dostępne w przypadku aplikacji do Google Chat i dodatków do Google Workspace.

Zapis JSON 
{
  "key": string,
  "value": string
}
Pola
key

string

Nazwa parametru skryptu działania.
value

string

Wartość parametru.

LoadIndicator

Określa wskaźnik ładowania, który wyświetla działanie podczas wywoływania działania.

Dostępne w przypadku aplikacji do Google Chat i dodatków do Google Workspace.

Wartości w polu enum
SPINNER Wyświetla obracające się kółko, aby wskazać, że treść się ładuje.
NONE Nic się nie wyświetla.

Interakcja

Opcjonalnie. Wymagane podczas otwierania okna.

co zrobić w odpowiedzi na interakcję z użytkownikiem, np. kliknięcie przez użytkownika przycisku w wiadomości z kartą.

Jeśli nie zostanie określona, aplikacja odpowie, wykonując action – np. otwierając link lub uruchamiając funkcję – w normalny sposób.

Po określeniu interaction aplikacja może reagować w specjalny, interaktywny sposób. Jeśli na przykład ustawisz interaction na OPEN_DIALOG, aplikacja będzie mogła otworzyć okno.

Jeśli jest określony, wskaźnik wczytywania nie jest wyświetlany. Jeśli jest określony dla dodatku, cała karta jest usuwana i nic nie jest wyświetlane w kliencie.

 Dostępne w przypadku aplikacji do Google Chat i niedostępne w przypadku dodatków do Google Workspace.

Wartości w polu enum
INTERACTION_UNSPECIFIED Wartość domyślna. action jest wykonywany normalnie.
OPEN_DIALOG

Otwiera okno, czyli interfejs oparty na kartach, którego aplikacje do Google Chat używają do interakcji z użytkownikami.

Obsługiwane tylko przez aplikacje do Google Chat w odpowiedzi na kliknięcia przycisków w wiadomościach na kartach. Jeśli jest określony dla dodatku, cała karta jest usuwana i nic nie jest wyświetlane w kliencie.

 Dostępne w przypadku aplikacji do Google Chat i niedostępne w przypadku dodatków do Google Workspace.