Google Sheets

ACTIVEVersão 1.0.0Google

Leia e modifique planilhas do Google a partir dos seus processos.

Ver como JSON

Pré-requisitos

• uma conta Google com acesso à planilha;
• permissão no iBPMS para criar ou selecionar conexões;
• autorização concluída pelo fluxo OAuth.

google-sheets.json

{
  "schemaVersion": 1,
  "key": "google-sheets",
  "name": "Google Sheets",
  "description": "Leia e modifique planilhas do Google a partir dos seus processos.",
  "category": "google",
  "vendor": "Google",
  "version": "1.0.0",
  "status": "ACTIVE",
  "credentials": [
    {
      "type": "OAUTH2",
      "permissions": [
        "Ler e escrever dados nas suas planilhas",
        "Ver a lista de planilhas do seu Drive (só nomes e IDs)"
      ]
    }
  ],
  "actions": [
    {
      "key": "row.append",
      "name": "Adicionar linha",
      "description": "Adiciona uma linha ao final de uma página, mapeando dados do processo para as colunas.",
      "inputs": [
        {
          "key": "spreadsheetId",
          "label": "Planilha",
          "type": "RESOURCE_SELECT",
          "required": true
        },
        {
          "key": "sheetTitle",
          "label": "Página",
          "type": "DYNAMIC_SELECT",
          "required": true
        },
        {
          "key": "values",
          "label": "Valores",
          "type": "FIELD_MAPPING",
          "required": true
        }
      ],
      "outputs": [
        {
          "key": "spreadsheetId",
          "label": "Spreadsheet Id",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "updatedRange",
          "label": "Updated Range",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "updatedRows",
          "label": "Updated Rows",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "updatedCells",
          "label": "Updated Cells",
          "type": "OUTPUT",
          "required": false
        }
      ]
    },
    {
      "key": "cells.update",
      "name": "Preencher células",
      "description": "Escreve valores em células específicas (ex.: preencher um formulário). Mapeie cada célula (A1) para um valor ou expressão.",
      "inputs": [
        {
          "key": "spreadsheetId",
          "label": "Planilha",
          "type": "RESOURCE_SELECT",
          "required": true
        },
        {
          "key": "sheetTitle",
          "label": "Página",
          "type": "DYNAMIC_SELECT",
          "required": true
        },
        {
          "key": "updates",
          "label": "Células",
          "type": "CELL_MAPPING",
          "required": true
        }
      ],
      "outputs": [
        {
          "key": "totalUpdatedCells",
          "label": "Total Updated Cells",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "totalUpdatedRows",
          "label": "Total Updated Rows",
          "type": "OUTPUT",
          "required": false
        }
      ]
    }
  ],
  "triggers": []
}

Autorizando o acesso

1. No iBPMS, crie uma conexão do Google Sheets.
2. Revise as permissões no diálogo de consentimento.
3. Conclua a autorização na tela do Google e volte ao iBPMS.

Credenciais

Credencial

Credencial

OAUTH2

Campo	Formato esperado
Segredo

Permissões concedidas

• Ler e escrever dados nas suas planilhas
• Ver a lista de planilhas do seu Drive (só nomes e IDs)

Ações disponíveis

Ação

Adicionar linha

row.append

Adiciona uma linha ao final de uma página, mapeando dados do processo para as colunas.

Entradas

Campo	Tipo	Obrigatório	Descrição
spreadsheetIdPlanilha	RESOURCE_SELECT	Sim	—
sheetTitlePágina	DYNAMIC_SELECT	Sim	—
valuesValores	FIELD_MAPPING	Sim	—

Saídas

Campo	Tipo	Obrigatório	Descrição
spreadsheetIdSpreadsheet Id	OUTPUT	Não	—
updatedRangeUpdated Range	OUTPUT	Não	—
updatedRowsUpdated Rows	OUTPUT	Não	—
updatedCellsUpdated Cells	OUTPUT	Não	—

Chamada

{
  "connection": "google-sheets-producao",
  "operation": "row.append",
  "inputs": {
    "spreadsheetId": "{{ context.spreadsheetId }}",
    "sheetTitle": "{{ context.sheetTitle }}",
    "values": {
      "chave": "valor"
    }
  }
}

Resposta

{
  "spreadsheetId": 123,
  "updatedRange": "…",
  "updatedRows": "…",
  "updatedCells": "…"
}

Ação

Preencher células

cells.update

Escreve valores em células específicas (ex.: preencher um formulário). Mapeie cada célula (A1) para um valor ou expressão.

Entradas

Campo	Tipo	Obrigatório	Descrição
spreadsheetIdPlanilha	RESOURCE_SELECT	Sim	—
sheetTitlePágina	DYNAMIC_SELECT	Sim	—
updatesCélulas	CELL_MAPPING	Sim	—

Saídas

Campo	Tipo	Obrigatório	Descrição
totalUpdatedCellsTotal Updated Cells	OUTPUT	Não	—
totalUpdatedRowsTotal Updated Rows	OUTPUT	Não	—

Chamada

{
  "connection": "google-sheets-producao",
  "operation": "cells.update",
  "inputs": {
    "spreadsheetId": "{{ context.spreadsheetId }}",
    "sheetTitle": "{{ context.sheetTitle }}",
    "updates": {
      "chave": "valor"
    }
  }
}

Resposta

{
  "totalUpdatedCells": "…",
  "totalUpdatedRows": "…"
}

Triggers disponíveis

Este conector é somente de saída: nenhum evento dele inicia uma regra.

Limitações

• a listagem do Drive devolve apenas nomes e identificadores das planilhas;
• escritas concorrentes na mesma faixa de células podem se sobrescrever;
• não há triggers: mudanças na planilha não disparam regras;
• os limites de requisição da API do Google continuam se aplicando.

Erros comuns

Sintoma	Possível causa	Correção
Planilha não encontrada	Identificador incorreto ou sem acesso	Use a ação de listagem para obter o identificador correto.
Cabeçalhos vazios	Primeira linha da aba em branco	Garanta que a aba tenha uma linha de cabeçalho.
Linha no lugar errado	Aba não informada na ação	Informe explicitamente a aba de destino.

Veja também

• Todos os conectores
• Integrações
• Solução de problemas