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,Tope 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:
- Abra seu app no editor do AppSheet
- Vá em Settings > Integrations
- Ative IN: from cloud services to your app
- Em Application Access Keys, crie uma chave (ou use uma existente) e copie-a
- 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
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | AppSheet Application Access Key |
appId | string | Yes | AppSheet app ID (found in App > Settings > Integrations > IN) |
tableName | string | Yes | Name of the table to read from |
region | string | No | AppSheet region subdomain: "www" (global, default), "eu", or "asia-southeast" |
selector | string | No | Optional AppSheet expression to filter/sort/limit rows, e.g. Filter(TableName, [Age] >= 21) or Top(OrderBy(Filter(TableName, true), [LastName], true), 10) |
Output
| Parameter | Type | Description |
|---|---|---|
rows | array | Matching rows returned by AppSheet |
metadata | json | Operation metadata |
↳ rowCount | number | Number 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
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | AppSheet Application Access Key |
appId | string | Yes | AppSheet app ID (found in App > Settings > Integrations > IN) |
tableName | string | Yes | Name of the table to add rows to |
region | string | No | AppSheet region subdomain: "www" (global, default), "eu", or "asia-southeast" |
rows | json | Yes | Array of row objects to add, each a column-name/value map, e.g. [{ "FirstName": "Jan", "LastName": "Jones" }] |
Output
| Parameter | Type | Description |
|---|---|---|
rows | array | Rows added by AppSheet, including any generated key values |
metadata | json | Operation metadata |
↳ rowCount | number | Number 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
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | AppSheet Application Access Key |
appId | string | Yes | AppSheet app ID (found in App > Settings > Integrations > IN) |
tableName | string | Yes | Name of the table to update rows in |
region | string | No | AppSheet region subdomain: "www" (global, default), "eu", or "asia-southeast" |
rows | json | Yes | Array of row objects to update, each including the key column and the columns to change, e.g. [{ "RowID": "123", "Status": "Done" }] |
Output
| Parameter | Type | Description |
|---|---|---|
rows | array | Rows updated by AppSheet |
metadata | json | Operation metadata |
↳ rowCount | number | Number 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
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | AppSheet Application Access Key |
appId | string | Yes | AppSheet app ID (found in App > Settings > Integrations > IN) |
tableName | string | Yes | Name of the table to delete rows from |
region | string | No | AppSheet region subdomain: "www" (global, default), "eu", or "asia-southeast" |
rows | json | Yes | Array of row objects identifying rows to delete by key column, e.g. [{ "RowID": "123" }] |
Output
| Parameter | Type | Description |
|---|---|---|
rows | array | Rows deleted by AppSheet |
metadata | json | Operation metadata |
↳ rowCount | number | Number of rows deleted |