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, consulte[Métodos de autenticação](quick-action-auth.md). ## 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](https://console.cloud.google.com/) no site do Google com permissões para criar clientes OAuth. + Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md). ## 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](#google-drive-action-quicksuite-setup) 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](https://developers.google.com/identity/protocols/oauth2) do Google. 1. Faça login no [Console do Google Cloud](https://console.cloud.google.com/) no site do Google. 1. Crie um novo projeto ou selecione um projeto existente. 1. **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**. 1. Escolha a **tela de consentimento do OAuth** e escolha **Começar**. 1. 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**. 1. Escolha **Criar cliente OAuth.** 1. 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` 1. Escolha **Criar**. 1. 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. **Escopos recomendados pelo 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. 1. No console do Amazon Quick, escolha **Conectores**. 1. Na guia **Disponível**, encontre **o Google Drive** e escolha **Connect**. 1. 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**. 1. Escolha a guia **Criar para sua equipe**. 1. 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**. 1. Insira um **nome** para seu conector. Opcionalmente, escolha **\+ Adicionar descrição** para adicionar uma descrição. 1. Em **Tipo de conexão**, escolha **Rede pública**. 1. 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. 1. 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. 1. Escolha **Próximo**. 1. 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**. 1. Na página **Revisar**, revise as ações disponíveis para o conector. Escolha **Próximo**. 1. 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. 1. 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 Drive** | 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, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations). ### 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](https://accounts.google.com) 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**.