Consulte os conectores compatíveis com a Application Integration.

Tarefa Planilhas - Get

Visualização

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

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

Planilha: o objeto principal no Planilhas Google que pode conter várias páginas. Cada página tem informações estruturadas contidas nas células.

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

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 Application Integration 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. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

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

4. Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas disponíveis.
5. Clique e coloque o elemento Planilhas - Get no editor 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	enumeração (Dimension)	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. 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 - 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.