Pré-requisitos de autenticação para o conector do Google Sheets no Jitterbit Studio

Introdução

Estes são os pré-requisitos para autenticar com o conector do Google Sheets usando um credencial de cliente OAuth 2.0 de 3 etapas (3LO) ou uma chave privada associada a uma conta de serviço do Google Cloud.

OAuth 2.0 de 3 etapas (3LO)

Siga estas etapas para configurar um cliente OAuth 2.0 de 3 etapas (3LO):

1. No Google Cloud Console, crie um projeto do Google Cloud ou selecione um projeto existente para autenticação.

2. Ative a API do Google Sheets para o projeto selecionado usando a página do marketplace da API do Google Sheets.

3. Configure a tela de consentimento OAuth para o projeto selecionado. Para a etapa Acesso a Dados > Adicionar ou Remover Escopos, insira estes escopos do Google Sheets:

   Escopo	Atividade
   https://www.googleapis.com/auth/spreadsheets	Todos
   https://www.googleapis.com/auth/spreadsheets.readonly	Obter

4. Navegue até APIs e Serviços > Credenciais e clique em Criar credenciais > ID do cliente OAuth para abrir a página de configuração Criar ID do cliente OAuth:

   1. Selecione Aplicativo da Web para Tipo de aplicativo.

   2. Insira qualquer nome para Nome.

   3. Adicione uma das seguintes URLs (dependendo da região da sua organização) à lista de URIs de redirecionamento autorizadas:

      Região	URL
      APAC	https://apps.apac-southeast.jitterbit.com/design-studio/api/v1/oauth/authcode
      EMEA	https://apps.emea-west.jitterbit.com/design-studio/api/v1/oauth/authcode
      NA	https://apps.na-east.jitterbit.com/design-studio/api/v1/oauth/authcode

5. Clique em Criar para gerar o cliente OAuth e seu arquivo de credenciais.

6. Quando concluído, um diálogo Cliente OAuth criado aparece. Clique em Baixar JSON para baixar o arquivo de credenciais JSON contendo o ID do Cliente e o Segredo do Cliente para uso posterior:

   Exemplo de arquivo de credenciais JSON

   {
       "web": {
           "client_id": "...",
           "project_id": "my-project-123456",
           "auth_uri": "https://accounts.google.com/o/oauth2/auth",
           "token_uri": "https://oauth2.googleapis.com/token",
           "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
           "client_secret": "...",
           "redirect_uris": [
               "https://apps.my-region.jitterbit.com/design-studio/api/v1/oauth/authcode"
           ]
       }
   }
   

7. Clique em OK para fechar o diálogo. A credencial recém-gerada agora é exibida sob IDs de Cliente OAuth 2.0.

Configurar um registro de aplicativo no Console de Gerenciamento

Siga estas etapas para configurar os valores necessários para um aplicativo privado do Console de Gerenciamento registro de aplicativo:

1. Reúna as informações necessárias do arquivo de credenciais JSON baixado ao configurar o cliente OAuth do Google Sheets acima:

   • ID do Cliente (client_id)
   • Segredo do Cliente (client_secret)
   • URL de Autorização (auth_uri)
   • URL do token de acesso e URL do token de atualização (token_uri)

2. Na configuração do registro do aplicativo, insira estes escopos do Google Sheets:

   Escopo	Atividade
   https://www.googleapis.com/auth/spreadsheets	Todos
   https://www.googleapis.com/auth/spreadsheets.readonly	Obter

3. Defina o ID do Cliente do aplicativo para o valor client_id no seu arquivo de credenciais.

4. Defina o Segredo do Cliente do aplicativo para o valor client_secret no seu arquivo de credenciais.

5. Defina a URL de Autenticação do aplicativo para o valor auth_uri no seu arquivo de credenciais. Por exemplo, https://accounts.google.com/o/oauth2/auth.

6. Defina a URL do token de acesso e a URL do token de atualização do aplicativo para o valor token_uri no seu arquivo de credenciais. Por exemplo, https://oauth2.googleapis.com/token.

7. Vá para Opções avançadas. Na aba Solicitação de autenticação, crie esses pares chave-valor em Parâmetros:

   Chave	Valor	Enviar em
   response_type	code	URL de Solicitação
   access_type	offline	URL de Solicitação

Uma vez que o aplicativo privado esteja registrado na página Registros de Aplicativos, ele estará disponível para seleção no menu Aplicativo OAuth na conexão do Google Sheets ao usar a opção de autenticação OAuth.

Autenticação com chave privada usando uma conta de serviço

Siga estas etapas para criar uma conta de serviço e conceder funções para fornecer acesso ao projeto do Google Cloud a ser usado com o conector do Google Sheets:

1. No Google Cloud Console, crie um projeto do Google Cloud ou selecione um projeto existente para autenticação.

2. Ative a API do Google Sheets para o projeto selecionado usando a página do marketplace da API do Google Sheets.

3. No menu de navegação, vá para IAM & Admin > Contas de Serviço.

4. Clique em Criar Conta de Serviço, localizado na parte superior da página.

5. Insira os detalhes da conta de serviço:

   

   • Nome da conta de serviço: Insira qualquer string para o nome da conta de serviço.

   • ID da conta de serviço: Este campo é preenchido automaticamente para corresponder ao nome da conta de serviço e pode ser editado, se desejado.

   • Descrição da conta de serviço: Insira uma descrição para a conta de serviço.

6. Clique em Criar e Continuar.

7. Atribua um papel para permitir o acesso ao projeto (necessário para uma conexão bem-sucedida no conector do Google Sheets):

   

   • Papel: Usando o menu, selecione Projeto > Proprietário, e depois clique em Continuar.

8. Opcionalmente, conceda acesso à conta de serviço a usuários específicos:

   

9. Clique em Concluído.

Obter credenciais da conta de serviço

Siga estas etapas para obter as credenciais necessárias para a configuração da conexão:

1. Na página Contas de Serviço, clique no menu Ações para a conta de serviço criada acima, e depois clique em Gerenciar chaves.

2. Clique em Adicionar Chave > Criar nova chave, selecione JSON como o Tipo de chave, e depois clique em Criar para baixar o arquivo JSON para o seu computador:

   

3. Abra o arquivo JSON baixado em um editor de texto e mantenha os valores de project_id, client_email e private_key para serem usados durante a configuração da conexão.