Class Action

Adiciona os nomes dos widgets necessários para essa ação para um envio válido. Se os widgets essa lista não tiverem um valor quando esta ação for invocada, o envio do formulário será cancelado.

Disponível apenas nos apps do Google Chat. Não disponível para complementos do Google Workspace.

var textInput = CardService.newTextInput()
    .setFieldName("text_input_1")
    .setTitle("Text input title")

// Creates a footer button that requires an input from the above TextInput Widget.
var action = CardService.newAction()
    .setFunctionName("notificationCallback")
    .addRequiredWidget("text_input_1");
var fixedFooter =
      CardService
          .newFixedFooter()
          .setPrimaryButton(
              CardService
                  .newTextButton()
                  .setText("help")
                  .setOnClickAction(action));

Parâmetros

Retornar

Action: este objeto, para encadeamento.

Indica se essa ação requer entradas de todos os widgets.

Disponível apenas nos apps do Google Chat. Não disponível para complementos do Google Workspace.

// Creates a button with an action that requires inputs from all widgets.
const button = CardService.newTextButton()
    .setText('Create notification')
    .setOnClickAction(
        CardService.newAction()
            .setAllWidgetsAreRequired(true));

Parâmetros

Retornar

Action: este objeto, para encadeamento.

Define o nome da função de callback a ser chamada. Obrigatório.

Parâmetros

Retornar

Action: este objeto, para encadeamento.

Define a interação com um usuário, obrigatória apenas ao abrir uma caixa de diálogo. Se não for especificado, o app responde executando um Action, como abrir um link ou executar uma função, como de costume.

Disponível apenas nos apps do Google Chat. Não disponível para complementos do Google Workspace.

const action = CardService.newAction()
    .setFunctionName('handleDialog')
    .setInteraction(CardService.Interaction.OPEN_DIALOG);

Parâmetros

Retornar

Action: este objeto, para encadeamento.

Define o indicador de carregamento que aparece enquanto a ação está em andamento.

Parâmetros

Retornar

Action: este objeto, para encadeamento.

Permite que parâmetros personalizados sejam transmitidos para a função de callback. Opcional.

Parâmetros

Retornar

Action: este objeto, para encadeamento.

Indica se os valores do formulário são determinados pelos valores do cliente ou do servidor depois que uma resposta de ação atualiza o Card do formulário. Quando definido como true, o os valores do cliente persistem após a resposta do servidor. Quando definido como false, o servidor valores substituem os valores do formulário. O padrão é false.

Manter os valores do cliente ajuda a evitar situações em que um formulário muda inesperadamente depois que um usuário faz uma edição. Por exemplo, se um usuário editar um TextInput depois enviar um formulário, mas antes de o servidor responder. Se os valores persistirem, edite o o usuário fez permanece depois que a resposta do servidor atualiza o Card; caso contrário, o valor do formulário retorna ao valor enviado originalmente pelo usuário ao formulário.

Manter os valores do cliente pode interferir na capacidade do script de limpar campos de formulário ou substituir valores de formulário, portanto, evite ativar a persistência para esse tipo de funcionalidade. Sem persistência, é recomendável usar LoadIndicator.SPINNER para eventos, porque isso bloqueia a interface e impede edições do usuário antes da resposta do servidor. Como alternativa, use LoadIndicator.NONE e verifique se todos os elementos do formulário têm um onChange à ação.

// Creates a button with an action that persists the client's values as the on-click action.
const button = CardService.newTextButton()
    .setText('Create notification')
    .setOnClickAction(
        CardService.newAction()
            .setPersistValues(true)
            .setFunctionName('functionName'));

Parâmetros

Retornar

Action: este objeto, para encadeamento.