Consulte os conectores compatíveis com a Application Integration.

Planilhas: anexar tarefa

A tarefa Planilhas - Anexar permite anexar dados depois de uma tabela de dados especificada em uma planilha do Google. Novos valores são anexados à nova linha criada após a tabela especificada, começando com a primeira coluna da tabela.

O Planilhas Google é uma das muitas soluções de produtividade baseadas na nuvem do Google Workspace. Ele permite criar e editar planilhas on-line com a funcionalidade de colaboração em tempo real.

Antes de começar

Antes de configurar a tarefa Planilhas - Anexar, faça o seguinte no projeto do Google Cloud:

Ative a API Google Sheets (sheets.googleapis.com).
Ativar a API Google Sheets
Criar um perfil de autenticação. A Application Integration usa um perfil de autenticação para se conectar a um endpoint de autenticação para a tarefa Planilhas - Anexar.
Para informações sobre como conceder papéis ou permissões adicionais a uma conta de serviço, consulte Como conceder, alterar e revogar acesso.
Entenda e conheça as terminologias comuns usadas no Planilhas Google.

Configurar a tarefa do Planilhas – Anexar

No console do Google Cloud, acesse a página Application Integration.
Acessar o Application Integration
No menu de navegação, clique em Integrações.
A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.
Selecione uma integração existente ou clique em Criar integração para criar uma nova.
Se você estiver criando uma integração:
1. Digite um nome e uma descrição no painel Create Integration.
2. Selecione uma região para a integração.
  Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas.
  Observação:a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração na região selecionada.
4. Clique em Criar.
Isso abre a integração na página do editor de integração.
Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas disponíveis.
Clique e coloque o elemento Planilhas - Anexar no editor de integração.
Clique no elemento Planilhas - Anexar no designer para ver o painel de configuração de tarefas Planilhas - Anexar.
Acesse Autenticação e selecione o perfil de autenticação que você quer usar.
Opcional. Se você não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga as etapas em Criar um novo perfil de autenticação.
Acesse Entrada de tarefas e configure os campos de entrada exibidos com a tabela Parâmetros de entrada de tarefas.
As mudanças nos campos de entrada são salvas automaticamente.

Parâmetros de entrada da tarefa

A tabela a seguir descreve os parâmetros de entrada da tarefa Planilhas - Append:

Propriedade	Tipo de dados	Descrição
SpreadsheetId	String	O ID de sua planilha. Você pode encontrar o ID de sua planilha no URL da web. Por exemplo, `https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0`.
Intervalo	String	A notação A1 de um intervalo para pesquisar a tabela desejada na página.
IncludeValuesInResponse	Booleano	Indica se o objeto retornado deve incluir os valores das células que foram anexadas.
InsertDataOption	enumeração (InsertDataOption)	Indica como os dados existentes serão alterados quando os novos dados forem anexados.
ValueInputOption	enumeração (ValueInputOption)	Indica como os dados são interpretadoss Valor padrão: `INPUT_VALUE_OPTION_UNSPECIFIED`
ResponseDateTimeRenderOption	enumeração (DateTimeRenderOption)	Indica como os valores relacionados a data, hora e duração são representados na saída. Observação: dateTimeRenderOption não será considerado se o valor especificado para valueRenderOption for `FORMATTED_VALUE`. Valor padrão: `SERIAL_NUMBER`
ResponseValueRenderOption	enumeração (ValueRenderOption)	Indica como os valores recuperados são representados na saída. Valor padrão: `FORMATTED_VALUE`
Solicitação	JSON	O corpo da solicitação é um objeto ValueRange que descreve valores de intervalo a serem gravados. Consulte Estrutura de solicitação JSON.

Saída da tarefa

A tarefa Planilhas - Append retorna a saída da resposta com um objeto AppendValuesResponse, semelhante ao seguinte exemplo de saída:

    {
        "spreadsheetId": SPREADSHEET_ID,
        "tableRange": "Sheet1!A1:D2",
        "updates": {
          "spreadsheetId": SPREADSHEET_ID,
          "updatedRange": "Sheet1!A3:D4",
          "updatedRows": 2,
          "updatedColumns": 4,
          "updatedCells": 8,
        }
      }

Estratégia de solução de erros

A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.

A seguir

Adicione bordas e condições de borda.
Teste e publique sua integração.
Configure um gatilho.
Adicione uma tarefa de mapeamento de dados.
Confira todas as tarefas para os serviços do Google Cloud.