Action

Un'azione che descrive il comportamento quando il modulo viene inviato. Ad esempio, puoi richiamare uno script Apps Script per gestire il modulo. Se l'azione viene attivata, i valori del modulo vengono inviati al server.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

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

string

Una funzione personalizzata da richiamare quando l'elemento contenitore viene selezionato o attivato in altro modo.

Per un esempio di utilizzo, consulta Leggi i dati del modulo.
parameters[]

object (ActionParameter)

Elenco dei parametri dell'azione.
loadIndicator

enum (LoadIndicator)

Specifica l'indicatore di caricamento visualizzato dall'azione durante la chiamata all'azione.
persistValues

boolean

Indica se i valori del modulo vengono mantenuti dopo l'azione. Il valore predefinito è false.

Se true, i valori del modulo rimangono dopo l'attivazione dell'azione. Per consentire all'utente di apportare modifiche durante l'elaborazione dell'azione, imposta LoadIndicator su NONE. Per i messaggi con schede nelle app di Chat, devi anche impostare l'azione ResponseType su UPDATE_MESSAGE e utilizzare lo stesso cardId della scheda che conteneva l'azione.

Se false, i valori del modulo vengono cancellati quando viene attivata l'azione. Per impedire all'utente di apportare modifiche durante l'elaborazione dell'azione, imposta LoadIndicator su SPINNER.
interaction

enum (Interaction)

Facoltativo. Obbligatorio quando si apre una finestra di dialogo.

Cosa fare in risposta a un'interazione con un utente, ad esempio quando un utente fa clic su un pulsante in un messaggio con scheda.

Se non viene specificato, l'app risponde eseguendo un'action, ad esempio aprendo un link o eseguendo una funzione, come di consueto.

Specificando un interaction, l'app può rispondere in modi interattivi speciali. Ad esempio, impostando interaction su OPEN_DIALOG, l'app può aprire una finestra di dialogo. Se specificato, non viene visualizzato un indicatore di caricamento. Se specificato per un componente aggiuntivo, l'intera scheda viene rimossa e non viene mostrato nulla nel client.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.
requiredWidgets[]

string

Facoltativo. Compila questo elenco con i nomi dei widget necessari per un invio valido di questa azione.

Se i widget elencati qui non hanno un valore quando viene richiamata questa azione, l'invio del modulo viene interrotto.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.
allWidgetsAreRequired

boolean

Facoltativo. Se il valore è true, tutti i widget sono considerati obbligatori per questa azione.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

ActionParameter

Elenco di parametri di stringa da fornire quando viene richiamato il metodo di azione. Ad esempio, considera tre pulsanti Posticipa: Posticipa ora, Posticipa di un giorno o Posticipa alla prossima settimana. Potresti utilizzare action method = snooze(), passando il tipo di posticipo e l'ora di posticipo nell'elenco dei parametri di stringa.

Per saperne di più, consulta CommonEventObject.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string

Il nome del parametro per lo script dell'azione.
value

string

Il valore del parametro.

LoadIndicator

Specifica l'indicatore di caricamento visualizzato dall'azione durante la chiamata all'azione.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Enum
SPINNER Mostra un'icona di selezione per indicare che i contenuti sono in fase di caricamento.
NONE Non viene visualizzato nulla.

Interazione

Facoltativo. Obbligatorio quando si apre una finestra di dialogo.

Cosa fare in risposta a un'interazione con un utente, ad esempio quando un utente fa clic su un pulsante in un messaggio con scheda.

Se non viene specificato, l'app risponde eseguendo un'action, ad esempio aprendo un link o eseguendo una funzione, come di consueto.

Specificando un interaction, l'app può rispondere in modi interattivi speciali. Ad esempio, impostando interaction su OPEN_DIALOG, l'app può aprire una finestra di dialogo.

Se specificato, non viene visualizzato un indicatore di caricamento. Se specificato per un componente aggiuntivo, l'intera scheda viene rimossa e non viene mostrato nulla nel client.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Enum
INTERACTION_UNSPECIFIED Valore predefinito. La action viene eseguita normalmente.
OPEN_DIALOG

Apre una finestra di dialogo, un'interfaccia basata su schede e finestre che le app di Chat utilizzano per interagire con gli utenti.

Supportato solo dalle app di Chat in risposta ai clic sui pulsanti nei messaggi con schede. Se specificato per un componente aggiuntivo, l'intera scheda viene rimossa e non viene mostrato nulla nel client.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.