Veja os conectores suportados para integração de aplicativos.

Planilhas - Acrescentar tarefa

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

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

Antes de começar

Certifique-se de executar as seguintes tarefas no seu projeto do Google Cloud antes de configurar a tarefa Planilhas - Acrescentar :

  1. Habilite a API do Planilhas Google ( sheets.googleapis.com ).

    Habilitar a API do Planilhas Google

  2. Crie um perfil de autenticação . A Integração de Aplicativos usa um perfil de autenticação para se conectar a um ponto de extremidade de autenticação para a tarefa Planilhas - Acrescentar .

    Para obter informações sobre como conceder funções ou permissões adicionais a uma conta de serviço, consulte Conceder, alterar e revogar acesso .

  3. Entenda e aprenda sobre as terminologias comuns usadas no Planilhas Google.

Configurar a tarefa Planilhas - Acrescentar

  1. No Google Cloud console, vá para a página Integração de Aplicativos .

    Ir para Integração de Aplicativos

  2. 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.

  3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

    Se você estiver criando uma nova integração:

    1. Insira um nome e uma descrição no painel Criar integração .
    2. Selecione uma região para a integração.
    3. Selecione uma conta de serviço para a integração. Você pode alterar 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 de integração.
    4. Clique em Criar . A integração recém-criada será aberta no editor de integração .

  4. Na barra de navegação do editor de integração , clique em Tarefas para visualizar a lista de tarefas e conectores disponíveis.
  5. Clique e coloque o elemento Planilhas - Adicionar no editor de integração.
  6. Clique no elemento Planilhas - Adicionar no designer para visualizar o painel de configuração da tarefa Planilhas - Adicionar .
  7. Vá para Autenticação e selecione um perfil de autenticação existente que você deseja usar.

    Opcional. Se você não criou um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga os passos mencionados em Criar um novo perfil de autenticação .

  8. Vá para Entrada de tarefa e configure os campos de entrada exibidos usando a seguinte tabela de parâmetros de entrada de tarefa .

    As alterações 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 - Acrescentar :

Propriedade Tipo de dados Descrição
Id da planilha Corda O ID da sua planilha.

Você pode encontrar o ID da sua planilha no URL da web. Por exemplo, https://docs.google.com/spreadsheets/d/ SPREADSHEET_ID /edit#gid=0

Faixa Corda A notação A1 de um intervalo para pesquisar a tabela desejada na planilha.
IncluirValoresEmResposta Booleano Indica se o objeto retornado deve incluir os valores das células às quais foram anexados valores.
OpçãoInserirDados enumeração (InsertDataOption) Indica como os dados existentes serão alterados quando os novos dados forem anexados.
Opção de entrada de valor enumeração (ValueInputOption) Indica como os dados são interpretados.

Valor padrão: INPUT_VALUE_OPTION_UNSPECIFIED

Opção de renderização de data e hora de resposta enumeração (DateTimeRenderOption) Indica como os valores relacionados à data, hora e duração são representados na saída.

Valor padrão: SERIAL_NUMBER

Opção de renderização do valor de resposta enumeração (ValueRenderOption) Indica como os valores recuperados são representados na saída.

Valor padrão: FORMATTED_VALUE

Solicitar JSON O corpo da solicitação é um objeto ValueRange que descreve os valores de intervalo a serem gravados. Consulte a estrutura JSON da solicitação .

Saída da tarefa

A tarefa Planilhas - Acrescentar retorna a saída de resposta contendo 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 tratamento de erros

Uma estratégia de tratamento de erros para uma tarefa especifica a ação a ser tomada se a tarefa falhar devido a um erro temporário . Para obter 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 .

Cotas e limites

Para obter informações sobre cotas e limites, consulte Cotas e limites .

O que vem a seguir