Pular para as operações

Dados de referência

Google Sheets em um fluxo de decisão.

5 Google Sheets operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
Dados de referência
Tipo
Integração
Autenticação
Conta de serviço do Google
Ambiente de teste
Somente host de produção

Quem são

Google's spreadsheet, and the API that reads one.

O Google Sheets é a planilha do Google Workspace, e sua API deixa um programa ler e escrever nas células de um documento que alguém está editando ao mesmo tempo. É essa combinação que o faz aparecer em toda ferramenta de automação: é o banco de dados que quem não programa já sabe manter. Ler uma planilha privada exige uma identidade Google, não uma chave de API.

O que um fluxo pode chamar

5 operações, cada uma um passo que você coloca no editor.

  1. GET/v4/spreadsheets/$data.spreadsheet_id/values/$data.sheet_range

    Ler um intervalo

    Reads one A1 range, for example "Rates!A2:D200".

  2. GET/v4/spreadsheets/$data.spreadsheet_id/values:batchGet?ranges=$data.sheet_range&ranges=$data.sheet_range_2

    Ler vários intervalos de uma vez

    Uma chamada para vários intervalos, que é o formato certo quando um fluxo precisa de uma tabela de taxas e de uma tabela de corte da mesma pasta.

  3. GET/v4/spreadsheets/$data.spreadsheet_id

    Read the workbook's structure

    Nomes das abas, tamanhos e propriedades, sem nenhum dado de célula.

  4. POST/v4/spreadsheets/$data.spreadsheet_id/values/$data.sheet_range:append?valueInputOption=RAW&insertDataOption=INSERT_ROWS

    Acrescentar uma linha

    Acrescenta uma linha depois da última que tem dados no intervalo.

  5. PUT/v4/spreadsheets/$data.spreadsheet_id/values/$data.sheet_range?valueInputOption=RAW

    Sobrescrever um intervalo

    Substitui as células de um intervalo. Mais estreito do que parece e fácil de errar: o intervalo é sobrescrito preencha-o o array de valores ou não, então um array mais curto deixa as células antigas para trás em vez de limpá-las.

Onde isso entra na decisão

Reference data calls have a natural place in a flow.

Parte de uma política é número, não lógica — uma tabela de taxas, um corte regional, uma lista de empregadores bloqueados — e quem cuida desses números raramente é quem edita o fluxo. Lê-los na hora da decisão mantém os dois trabalhos separados, ao custo de uma chamada de rede num caminho que de outra forma nunca sairia do motor, então vale a pena cachear a resposta.

Whatever Google Sheets returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add Google Sheets as a connection authenticating with a Google service account.
  • 02A Google Sheets tem um host só para os dois ambientes, então proteja as execuções de teste com credenciais e limites seus.
  • 03Coloque um nó de Conexão e escolha uma operação — “Ler um intervalo” costuma ser a primeira de que um fluxo precisa.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a Google Sheets em um fluxo.

Como conecto a Google Sheets a um fluxo de decisão?

Adicione a Google Sheets como uma conexão no seu workspace, autenticando com uma conta de serviço do Google, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a Google Sheets em uma decisão sem nunca ver o segredo.

Dá para testar a Google Sheets sem tocar em produção?

A Google Sheets expõe um host só para os dois ambientes, então não existe um sandbox separado para apontar. As execuções de teste continuam rodando no Sandbox e ficam registradas à parte no histórico de decisões, mas a chamada vai para o mesmo lugar que a de produção — então proteja isso com credenciais de teste, limites de taxa ou dados seus.

O que um fluxo pode chamar na Google Sheets?

5 operations, including “Read a range”, “Read several ranges at once”, “Read the workbook's structure”. Each one is a step you place on the canvas and map into the fields your rules read, and most flows start with “Read a range”. The list comes from the same manifest the engine uses to make the call, so this page cannot describe an operation the product does not have.

Em que ponto de uma decisão a Google Sheets deve ser chamada?

Parte de uma política é número, não lógica — uma tabela de taxas, um corte regional, uma lista de empregadores bloqueados — e quem cuida desses números raramente é quem edita o fluxo. Lê-los na hora da decisão mantém os dois trabalhos separados, ao custo de uma chamada de rede num caminho que de outra forma nunca sairia do motor, então vale a pena cachear a resposta.

Quando você quiser

Wire Google Sheets into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação