Planilhas: tarefa "Get Batch"

A tarefa Planilhas: get batch permite ler e recuperar vários intervalos de valores não contínuos 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

Execute as seguintes tarefas no projeto do Google Cloud antes de configurar a tarefa Planilhas: Batch Get:

Ative a API Google Sheets (sheets.googleapis.com).
Ativar a API Google Sheets
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 - Batch 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.
Entenda e conheça as terminologias comuns usadas no Planilhas Google.

Configurar a tarefa "Planilhas - Get Batch"

Na interface da Apigee, selecione sua organização da Apigee.
Clique em Desenvolver > Integrações.
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.
Na barra de navegação do designer de integração, clique em +Adicionar uma tarefa/gatilho> Tarefas para coferir a lista de tarefas disponíveis.
Clique e coloque o elemento Planilhas - Batch Get no designer de integração.
Clique no elemento Planilhas - Get Batch para conferir o painel de configuração da tarefa Planilhas - Batch Get.
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 - Batch 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`
Intervalos	String	A notação A1 ou R1C1 do intervalo do qual os valores serão recuperados.
DateTimeRenderOption	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`
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 - Batch Get retorna a saída da resposta com um objeto com o ID da planilha e uma matriz de objetos ValueRange correspondentes a cada intervalo solicitado, listados na ordem solicitada. Confira a seguir um exemplo de saída:

{
        "spreadsheetId": SPREADSHEET_ID,
        "valueRanges": [
          {
            "range": "Sheet1!B1:B1000",
            "majorDimension": "COLUMNS",
            "values": [
              ["Cost",20.5,15,100,135.5]
            ]
          },
          {
            "range": "Sheet1!D1:D1000",
            "majorDimension": "COLUMNS",
            "values": [
              ["Ship Date",42430,42444,42449,42449]
            ]
          }
        ]
      }

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.