Google AppSheet

Google AppSheet é a plataforma de desenvolvimento de apps no-code do Google que permite às equipes transformar planilhas e bancos de dados em apps mobile e web, com fontes de dados como Google Sheets, Excel e bancos de dados na nuvem.

Com a integração Google AppSheet no Zoen, você pode:

  • Encontrar linhas: Consulte uma tabela com uma expressão Selector opcional (Filter, OrderBy, Top e mais) para filtrar, ordenar e limitar as linhas retornadas
  • Adicionar linhas: Insira novas linhas em uma tabela, deixando o AppSheet gerar a coluna-chave automaticamente ou fornecendo-a explicitamente
  • Editar linhas: Atualize linhas existentes pela coluna-chave, alterando apenas os campos necessários
  • Excluir linhas: Remova linhas de uma tabela pela coluna-chave

No Zoen, a integração Google AppSheet permite que seus agentes leiam e escrevam dados de apps AppSheet como parte de fluxos automatizados — sincronizando pedidos, roteando leads, escalando tickets ou mantendo uma tabela sincronizada com outro sistema, tudo sem abrir o editor do AppSheet.

Obtendo sua Application Access Key

O Google AppSheet autentica com uma Application Access Key estática, em vez de OAuth:

  1. Abra seu app no editor do AppSheet
  2. Vá em Settings > Integrations
  3. Ative IN: from cloud services to your app
  4. Em Application Access Keys, crie uma chave (ou use uma existente) e copie-a
  5. Use a Application Access Key, junto com o App ID e o nome da tabela, na configuração do bloco Zoen

A API do AppSheet exige um plano Enterprise.

Usage Instructions

Integrate Google AppSheet into your workflow. Find, add, edit, and delete rows in an AppSheet table using the AppSheet API. Requires an AppSheet Enterprise plan with the API enabled and an Application Access Key.

Actions

google_appsheet_find_rows

Read rows from an AppSheet table. Omit the selector to return every row, or provide a Selector expression (Filter/Select/OrderBy/Top) to narrow and shape the results.

Input

ParameterTypeRequiredDescription
apiKeystringYesAppSheet Application Access Key
appIdstringYesAppSheet app ID (found in App > Settings > Integrations > IN)
tableNamestringYesName of the table to read from
regionstringNoAppSheet region subdomain: "www" (global, default), "eu", or "asia-southeast"
selectorstringNoOptional AppSheet expression to filter/sort/limit rows, e.g. Filter(TableName, [Age] >= 21) or Top(OrderBy(Filter(TableName, true), [LastName], true), 10)

Output

ParameterTypeDescription
rowsarrayMatching rows returned by AppSheet
metadatajsonOperation metadata
rowCountnumberNumber of rows returned

google_appsheet_add_rows

Add new rows to an AppSheet table. The key column value must be provided explicitly, or omitted when its Initial value expression generates it automatically (e.g. UNIQUEID()).

Input

ParameterTypeRequiredDescription
apiKeystringYesAppSheet Application Access Key
appIdstringYesAppSheet app ID (found in App > Settings > Integrations > IN)
tableNamestringYesName of the table to add rows to
regionstringNoAppSheet region subdomain: "www" (global, default), "eu", or "asia-southeast"
rowsjsonYesArray of row objects to add, each a column-name/value map, e.g. [{ "FirstName": "Jan", "LastName": "Jones" }]

Output

ParameterTypeDescription
rowsarrayRows added by AppSheet, including any generated key values
metadatajsonOperation metadata
rowCountnumberNumber of rows added

google_appsheet_edit_rows

Update existing rows in an AppSheet table. Each row must explicitly include the key column name and value, plus any columns to change.

Input

ParameterTypeRequiredDescription
apiKeystringYesAppSheet Application Access Key
appIdstringYesAppSheet app ID (found in App > Settings > Integrations > IN)
tableNamestringYesName of the table to update rows in
regionstringNoAppSheet region subdomain: "www" (global, default), "eu", or "asia-southeast"
rowsjsonYesArray of row objects to update, each including the key column and the columns to change, e.g. [{ "RowID": "123", "Status": "Done" }]

Output

ParameterTypeDescription
rowsarrayRows updated by AppSheet
metadatajsonOperation metadata
rowCountnumberNumber of rows updated

google_appsheet_delete_rows

Delete rows from an AppSheet table. Each row only needs to include the key column name and value.

Input

ParameterTypeRequiredDescription
apiKeystringYesAppSheet Application Access Key
appIdstringYesAppSheet app ID (found in App > Settings > Integrations > IN)
tableNamestringYesName of the table to delete rows from
regionstringNoAppSheet region subdomain: "www" (global, default), "eu", or "asia-southeast"
rowsjsonYesArray of row objects identifying rows to delete by key column, e.g. [{ "RowID": "123" }]

Output

ParameterTypeDescription
rowsarrayRows deleted by AppSheet
metadatajsonOperation metadata
rowCountnumberNumber of rows deleted

On this page