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:

  1. Ative a API Google Sheets (sheets.googleapis.com).

    Ativar a API Google Sheets

  2. Criar um perfil de autenticação. A integração da Apigee 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.

  3. Entenda e conheça as terminologias comuns usadas no Planilhas Google.

Configurar a tarefa do Planilhas – Anexar

  1. Na interface da Apigee, selecione sua organização da Apigee.
  2. Clique em Desenvolver > Integrações.
  3. Selecione uma integração existente ou clique em Criar integração.

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Digite um nome e uma descrição na caixa de diálogo Criar integração.
    2. Selecione uma Região para a integração na lista de regiões compatíveis.
    3. Clique em Criar.

    Isso abre a integração na página do designer de integração.

  4. Na barra de navegação do designer de integração, clique em +Adicionar uma tarefa/gatilho> Tarefas para ver a lista de tarefas disponíveis.
  5. Clique e posicione o elemento Planilhas - Anexar no designer de integração.
  6. Clique no elemento Planilhas - Anexar no designer para ver o painel de configuração de tarefas Planilhas - Anexar.
  7. 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.

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

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

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