Consulte os conetores suportados para a solução Application Integration.

Sheets: obtenha tarefa

A tarefa Sheets - Get permite-lhe ler e obter um único intervalo de valores de uma folha de cálculo do Google.

O Google Sheets é uma das muitas soluções de produtividade baseadas na nuvem no Google Workspace. Permite-lhe criar e editar folhas de cálculo online com funcionalidade de colaboração em tempo real.

Antes de começar

Certifique-se de que realiza as seguintes tarefas no seu projeto do Google Cloud antes de configurar a tarefa Sheets - Get:

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

    Ative a API Google Sheets

  2. Crie um perfil de autenticação do tipo Conta de serviço. A integração de aplicações usa um perfil de autenticação (conta de serviço) para se ligar a um ponto final de autenticação para a tarefa Sheets - Get.

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

  3. No Google Sheets, conceda à conta de serviço autorização para aceder à folha de cálculo.
  4. Compreenda e saiba mais sobre a terminologia comum usada no Google Sheets.

Configure o Sheets - Get task

  1. Na Google Cloud consola, aceda à página Application Integration.

    Aceda à solução Application Integration

  2. No menu de navegação, clique em Integrações.

    A página Integrações é apresentada com 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 estiver a criar uma nova integração:

    1. Introduza 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. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
    4. Clique em Criar. A integração recém-criada é aberta no editor de integração.

  4. Na barra de navegação do editor de integração, clique em Tasks para ver a lista de tarefas e conetores disponíveis.
  5. Clique e coloque o elemento Sheets - Get no editor de integração.
  6. Clique no elemento Sheets – Get no criador para ver o painel de configuração da tarefa Sheets – Get.
  7. Aceda a Autenticação e selecione um perfil de autenticação existente que quer usar.

    Opcional. Se não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga os passos mencionados em Crie um novo perfil de autenticação.

  8. Aceda a Entrada de tarefas e configure os campos de entrada apresentados através da seguinte tabela de parâmetros de entrada de tarefas.

    As alterações aos campos de entrada são guardadas automaticamente.

Parâmetros de entrada da tarefa

A tabela seguinte descreve os parâmetros de entrada da tarefa Sheets - Get:

Propriedade Tipo de dados Descrição
SpreadsheetId String O ID da sua folha de cálculo.

Pode encontrar o ID da folha de cálculo no respetivo URL Web. Por exemplo, https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0

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

Valor predefinido: DIMENSION_UNSPECIFIED

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

Valor predefinido: SERIAL_NUMBER

ValueRenderOption enum (ValueRenderOption) Indica como os valores obtidos são representados no resultado.

Valor predefinido: FORMATTED_VALUE

Resultado da tarefa

A tarefa Sheets - Get devolve o resultado da resposta que contém um objeto ValueRange correspondente ao intervalo pedido. Segue-se um exemplo de resultado:

    {
        "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 processamento de erros

Uma estratégia de processamento de erros para uma tarefa especifica a ação a realizar se a tarefa falhar devido a um erro temporário. Para obter informações sobre como usar uma estratégia de processamento de erros e conhecer os diferentes tipos de estratégias de processamento de erros, consulte o artigo Estratégias de processamento de erros.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?