Integração com o Google Sheets

Com o conector de ação do Google Sheets, você pode acessar o Google Sheets diretamente no Amazon Quick por meio de linguagem natural. Você pode criar e editar planilhas, ler e gravar intervalos de células, formatar células e pesquisar dados sem sair do Amazon Quick.

O Amazon Quick oferece suporte a vários métodos de autenticação para o Google Sheets. Escolha o método mais adequado aos requisitos de segurança da sua organização.

• Aplicativo OAuth padrão — usa um aplicativo OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Você se autentica diretamente com sua conta do Google.

• Aplicativo OAuth personalizado — usa um cliente OAuth gerenciado pelo cliente criado no Console do Google Cloud. Essa opção dá à sua organização controle total sobre a configuração do OAuth.

Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.

Antes de começar

Verifique se você tem o seguinte antes de configurar a integração.

• Uma conta do Google com acesso ao Google Sheets.

• Para um aplicativo OAuth personalizado: acesso ao Console do Google Cloud no site do Google com permissões para criar clientes OAuth.

• Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.

Configurando o Google Cloud

Se você usa a autenticação padrão do aplicativo OAuth, pule esta seção e consulte. Configurando o conector no Amazon Quick

Para a autenticação personalizada do aplicativo OAuth, conclua as etapas a seguir no Console do Google Cloud antes de configurar o Amazon Quick. Ao ativar a API na etapa 3, pesquise e ative a API do Google Sheets.

Crie um cliente OAuth no Google Cloud Console

Crie um cliente OAuth no Console do Google Cloud para obter as credenciais de cliente necessárias para o Amazon Quick. Para obter mais informações, consulte Como usar o OAuth 2.0 para acessar as APIs do Google no site do Google.

1. Faça login no Console do Google Cloud no site do Google.

2. Crie um novo projeto ou selecione um projeto existente.

3. No painel de navegação esquerdo, escolha APIs e serviços e, em seguida, escolha Biblioteca. Pesquise a API que sua integração exige e escolha Ativar.

4. Escolha a tela de consentimento do OAuth e escolha Começar.

5. Configure a tela de consentimento:

   • Insira o nome do aplicativo e selecione um e-mail de suporte ao usuário.

   • Em Audience, escolha Interno (somente para sua organização) ou Externo (qualquer usuário do Google).

   • Adicione os detalhes de contato do desenvolvedor e escolha Criar.

6. Escolha Criar cliente OAuth.

7. Configure o cliente:

   • Em Tipo de aplicativo, escolha Aplicativo Web.

   • Insira um nome para seu cliente.

   • Em URIs de redirecionamento autorizados, adicione o URL de retorno de chamada do Amazon Quick: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. Escolha Criar.

9. Registre os seguintes valores. Você precisa deles ao configurar o Amazon Quick.

   • ID do cliente

   • Segredo do cliente

Escopos recomendados

Os escopos a seguir são solicitados quando você se conecta ao Planilhas Google.

Escopos recomendados do Google Sheets

Escopo	Description
https://www.googleapis.com/auth/spreadsheets	Lê e grava planilhas do Google Sheets.
https://www.googleapis.com/auth/drive	Lê e grava arquivos no Google Drive.
https://www.googleapis.com/auth/drive.readonly	Lê arquivos no Google Drive.
openid	Autentica a identidade do usuário.
email	Lê o endereço de e-mail do usuário.

nota

Os email escopos openid e são incluídos automaticamente no fluxo de consentimento do OAuth para autenticação do usuário. Eles não são necessários para o Service-to-Service OAuth.

Configurando o conector no Amazon Quick

Conecte-se a partir da guia Disponível

Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.

1. No console do Amazon Quick, escolha Conectores.

2. Na guia Disponível, encontre o Google Sheets e escolha Connect.

3. Conclua o fluxo de login do Google e conceda as permissões solicitadas.

Em vez disso, para configurar um conector com o aplicativo OAuth personalizado, use a guia Criar para sua equipe, conforme descrito abaixo.

Crie a partir da guia Criar para sua equipe

Depois de concluir qualquer configuração necessária do Google Cloud, crie o conector no Amazon Quick.

1. No console do Amazon Quick, escolha Conectores.

2. Escolha a guia Criar para sua equipe.

3. Encontre e escolha Planilhas Google.

   nota

   Se já existir um conector do Google Sheets, uma caixa de diálogo será exibida com seus conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha Não, criar novo.

4. Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.

5. Em Tipo de conexão, escolha Rede pública.

6. Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.

   1. Para o aplicativo OAuth padrão:

      Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.

   2. Para o aplicativo OAuth personalizado, configure os seguintes campos:

      • URL base (opcional) — O URL base da API do Google Sheets. Por exemplo: https://sheets.googleapis.com

      • ID do cliente — O ID do cliente do Google Cloud OAuth.

      • Segredo do cliente — O segredo do cliente do Google Cloud OAuth.

      • URL do token — O endpoint do token. Por exemplo: https://oauth2.googleapis.com/token

      • URL de autorização — O endpoint de autorização. Por exemplo: https://accounts.google.com/o/oauth2/v2/auth

      • URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.

7. Escolha Próximo.

8. Se você escolher o aplicativo OAuth padrão ou o aplicativo OAuth personalizado, uma janela de autorização do Google será aberta. Revise as permissões solicitadas e escolha Permitir.

9. Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.

10. Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.

11. Selecione Publish.

Ações disponíveis

Depois de configurar o conector, as ações a seguir estarão disponíveis.

Ações disponíveis do Google Sheets

Categoria	Ação	Description
Valores	Obtenha valores	Lê valores de um intervalo de células.
Valores	Batch Get Value	Lê valores de vários intervalos de células em uma única solicitação.
Valores	Obter valores por filtro	Lê valores usando um filtro de dados.
Valores	Atualizar valores	Grava valores em um intervalo de células.
Valores	Valor de atualização em lote	Grava valores em vários intervalos de células em uma única solicitação.
Valores	Anexar valores	Acrescenta valores após a última linha de dados em um intervalo.
Valores	Excluir valores	Limpa valores de um intervalo de células.
Valores	Atualizar texto	Localiza e substitui texto em uma planilha.
Linhas	Criar linha	Cria uma nova linha em uma planilha.
Linhas	Colocar linhas	Insere as linhas em uma planilha.
Linhas	Obter linha de planilha	Procura uma linha com base nos critérios correspondentes.
Planilhas	Criar planilha	Cria uma nova planilha.
Planilhas	Obter informações da planilha	Recupera metadados para uma planilha.
Planilhas	Pesquisar planilhas	Pesquisa planilhas.
Planilhas	Criar planilha	Adiciona uma nova planilha a uma planilha.
Planilhas	Listar nomes de planilhas	Lista os nomes das folhas em uma planilha.
Planilhas	Atualizar propriedades da planilha	Atualiza as propriedades da pasta, como nome ou visibilidade.
Formatação	Atualizar formato de célula	Formata células em um intervalo.
Formatação	Atualizar regras de formatação condicional	Cria ou atualiza regras de formatação condicional.

nota

As ações que você pode usar dependem das planilhas acessíveis ao usuário autenticado.

Gerenciamento e solução de problemas

Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.

Problemas comuns de autenticação do Google

• Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado) — Verifique se sua conta do Google está ativa e se você pode fazer login diretamente no site do Google. Para o aplicativo OAuth personalizado, confirme se o URI de redirecionamento em seu cliente Google Cloud OAuth corresponde ao URL de retorno de chamada do Amazon Quick.

• Aplicativo bloqueado pelo administrador: se o administrador do Google Workspace restringir o acesso a aplicativos de terceiros, talvez você veja um erro ao tentar fazer login. Entre em contato com seu administrador do Google Workspace para permitir o aplicativo Amazon Quick.

• Credenciais de cliente inválidas (aplicativo OAuth personalizado) — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores do seu cliente Google Cloud OAuth.

• O pop-up de autenticação falha — Verifique se seu navegador permite pop-ups do domínio do console Amazon Quick. Tente usar um navegador diferente ou limpar o cache do navegador.

• Permissões revogadas — Se você revogou anteriormente o Amazon Quick Access nas configurações de permissões da sua Conta do Google, você precisa se autenticar novamente editando o conector e fazendo login novamente.

• Limitação da taxa de API do Google — o Google pode limitar as solicitações durante períodos de alto uso. Se as ações falharem, tente novamente após alguns minutos.

Sheets-specific Problemas do Google

• API do Planilhas Google não ativada — Verifique se a API do Planilhas Google está ativada no seu projeto do Google Cloud em APIs e Serviços, Biblioteca.