As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Conector de ação do Google Drive
Com o conector de ação do Google Drive, você pode acessar o Google Drive diretamente no Amazon Quick por meio de linguagem natural. Você pode carregar e baixar arquivos, gerenciar pastas, pesquisar conteúdo e acompanhar alterações sem sair do Amazon Quick.
O Amazon Quick oferece suporte a vários métodos de autenticação para o conector de ação do Google Drive. Escolha o método que melhor se adapta 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 Drive.
-
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 Drive.
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
-
Faça login no Console do Google Cloud
no site do Google. -
Crie um novo projeto ou selecione um projeto existente.
-
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.
-
Escolha a tela de consentimento do OAuth e escolha Começar.
-
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.
-
-
Escolha Criar cliente OAuth.
-
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
-
-
Escolha Criar.
-
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 Google Drive.
| Escopo | Description |
|---|---|
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. |
https://www.googleapis.com/auth/drive.metadata.readonly |
Lê os metadados do arquivo 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.
-
No console do Amazon Quick, escolha Conectores.
-
Na guia Disponível, encontre o Google Drive e escolha Connect.
-
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.
-
No console do Amazon Quick, escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
Encontre e escolha o Google Drive.
nota
Se já existir um conector do Google Drive, 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.
-
Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.
-
Em Tipo de conexão, escolha Rede pública.
-
Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.
-
Para o aplicativo OAuth padrão:
Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.
-
Para o aplicativo OAuth personalizado, configure os seguintes campos:
-
URL base (opcional) — O URL base da API do Google Drive. Por exemplo:
https://www.googleapis.com/drive -
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.
-
-
-
Escolha Próximo.
-
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.
-
Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.
-
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.
-
Selecione Publish.
Ações disponíveis
Depois de configurar o conector, as ações a seguir estarão disponíveis.
| Categoria | Ação | Description |
|---|---|---|
| Arquivos | Obter arquivo | Faz o download de um arquivo do Google Drive. |
| Arquivos | Pesquisar arquivos | Pesquisa arquivos por nome ou conteúdo. |
| Arquivos | Obter metadados do arquivo | Recupera metadados de um arquivo. |
| Arquivos | Importar arquivo | Faz o upload de um arquivo para o Google Drive. |
| Arquivos | Carregar arquivo do URL | Carrega um arquivo a partir de um URL. |
| Arquivos | Criar arquivo | Cria um novo arquivo. |
| Arquivos | Criar arquivo a partir do texto | Cria um arquivo a partir do conteúdo de texto. |
| Arquivos | Colocar arquivo | Substitui o conteúdo de um arquivo existente. |
| Arquivos | Atualizar conteúdo do arquivo | Edita o conteúdo de um arquivo existente. |
| Arquivos | Atualizar localização do arquivo | Move um arquivo para uma pasta diferente. |
| Arquivos | Copiar arquivo | Cria uma cópia de um arquivo. |
| Arquivos | Arquivo de exportação | Exporta um arquivo do Google Workspace para um formato diferente. |
| Arquivos | Excluir arquivo | Move um arquivo para a lixeira. |
| Pastas | Criar pasta | Cria uma pasta. |
| Pastas | Pastas de pesquisa | Pesquisa pastas por nome. |
| Permissões | Listar permissões | Lista as permissões para um arquivo ou pasta. |
| Comentários | Listar comentários | Lista os comentários em um arquivo. |
| Alterações | Alterações na lista | Lista as alterações recentes nos arquivos. |
| Alterações | Obtenha o token da página inicial de alterações | Recupera um token da página inicial para rastrear alterações. |
| Dirija | Obter informações sobre o Drive | Recupera informações sobre o Drive do usuário. |
nota
As ações que você pode usar dependem dos arquivos e pastas 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.
Drive-specific Problemas do Google
-
API do Google Drive não ativada — Verifique se a API do Google Drive está ativada em seu projeto do Google Cloud em APIs e Serviços, Biblioteca.
