Tarefa Planilhas - Get

A tarefa Planilhas - Get permite ler e recuperar um único intervalo de valores de uma planilha do Google.

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

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

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

    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 Planilhas - Get

  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 - Get no designer de integração.
  6. Clique no elemento Planilhas - Get no designer para ver o painel de configuração de tarefas Planilhas - Get.
  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 - Get:

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.

MajorDimension enum (Dimensão) A categoria ou dimensão principal que deve ser aplicada. Por exemplo, ROWS ou COLUMNS.

Valor padrão: DIMENSION_UNSPECIFIED

Intervalo String A notação A1 ou R1C1 do intervalo do qual os valores serão recuperados.
dateTimeRenderOption enum (DateTimeRenderOption) Indica como os valores relacionados a data, hora e duração são representados na saída.

Valor padrão: SERIAL_NUMBER

ValueRenderOption enum (ValueRenderOption) Indica como os valores recuperados são representados na saída.

Valor padrão: FORMATTED_VALUE

Saída da tarefa

A tarefa Planilhas - Get retorna a resposta da resposta com um objeto ValueRange correspondente ao intervalo solicitado. Veja a seguir um exemplo de saída:

    {
        "range": "Sheet1!A1:D5",
        "majorDimension": "ROWS",
        "values": [
          ["Item", "Cost", "Stocked", "Ship Date"],
          ["Wheel", "$20.50", "4", "42430"],
          ["Door", "$15", "2", "42444"],
          ["Engine", "$100", "1", "42449"],
          ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
        ],
      }

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.