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á.
Google Drive
O Google Drive é um serviço de colaboração e armazenamento de arquivos baseado em nuvem. Você pode conectar o Google Drive como uma fonte de dados para sua base de conhecimento gerenciada para rastrear unidades pessoais, unidades compartilhadas e arquivos compartilhados com a identidade autenticada.
Recursos compatíveis
-
Rastreie unidades pessoais, unidades compartilhadas e arquivos compartilhados com a identidade autenticada
-
Detecção automática de campos comuns do documento (como título, autor e datas de criação ou modificação)
-
Filtros de conteúdo de inclusão e exclusão por IDs de drive compartilhado e tipos MIME
-
Inclusão granular de pastas e arquivos específicos (somente com autenticação OAuth 2.0)
-
Date-based filtragem de conteúdo modificado antes ou depois de uma data específica
-
Sincronizações incrementais de conteúdo para conteúdo adicionado, atualizado e excluído
-
Conta de serviço e autenticação OAuth 2.0
-
Document-level controle de acesso (ACLs), com autenticação de conta de serviço
Métodos de autenticação
Uma fonte de dados do Google Drive é compatível com dois métodos de autenticação. Escolha uma antes de começar, pois ela determina as credenciais que você cria, qual conteúdo o conector pode rastrear e se você pode usar o controle de acesso em nível de documento. Recomendamos a autenticação da conta de serviço para novas fontes de dados.
| Método | Como ele se autentica | Quando usar | Configuração |
|---|---|---|---|
Conta de serviço (SERVICE_ACCOUNT) — recomendada |
Uma conta de serviço do Google Cloud com delegação em todo o domínio é autenticada com uma chave privada e, em seguida, se faz passar por um usuário administrador do Google Workspace para acessar o conteúdo do Drive para qualquer usuário em seu domínio. | A maioria das fontes de dados e qualquer fonte de dados que use controle de acesso em nível de documento. É necessário que um administrador do Google Workspace seja configurado. | Configurar a autenticação da conta de serviço |
OAuth 2.0 () OAUTH2 |
Um ID de cliente e segredo do OAuth 2.0 junto com um token de atualização delegado que você obtém do login de um único usuário do Google. O conector acessa somente o conteúdo que o usuário pode acessar. | Use quando um único usuário do Google tiver acesso a todo o conteúdo do Drive que você deseja rastrear ou quando você não puder configurar a delegação em todo o domínio. Filtros granulares de ID de pasta e arquivo estão disponíveis somente com esse método. Não é compatível com controle de acesso em nível de documento. | Configurar a autenticação OAuth 2.0 |
Importante
A autenticação da conta de serviço requer acesso de administrador do Google Workspace. Se sua organização restringir o acesso a aplicativos de terceiros no Google Workspace, talvez seu administrador também precise permitir o acesso ao OAuth 2.0 em seu nome para o método OAuth 2.0.
Pré-requisitos
No Google Workspace e no Google Cloud, certifique-se de:
-
Tenha acesso a um projeto do Google Cloud em que você pode ativar APIs e criar credenciais.
-
Tenha uma conta do Google Workspace com um domínio de e-mail que corresponda ao conteúdo que você quer rastrear. Para a autenticação da conta de serviço, você também precisa ter acesso de administrador ao Google Workspace.
Em sua AWS conta, certifique-se de:
-
Armazenar as credenciais de autenticação em um segredo do AWS Secrets Manager e anotar o nome do recurso da Amazon (ARN) do segredo.
-
Para ver os pares exatos de valores-chave a serem armazenados no segredo, consulte a página de configuração do seu método de autenticação: Configurar a autenticação da conta de serviço para o Google Drive ou. Configurar a autenticação OAuth 2.0 para o Google Drive
-
Inclua as permissões necessárias para se conectar à sua fonte de dados na role/permissions política AWS Identity and Access Management (IAM) da sua base de conhecimento. Para obter informações sobre as permissões necessárias, consultePermissões para acessar as fontes de dados.
Como configurar uma fonte de dados do Google Drive
A configuração de uma fonte de dados do Google Drive envolve as seguintes etapas:
-
Configure a autenticação. Siga a página do método escolhido para configurar o Google Cloud e o Google Workspace, gerar credenciais e armazená-las em AWS: Configurar a autenticação da conta de serviço para o Google Drive ou. Configurar a autenticação OAuth 2.0 para o Google Drive
-
Conecte a fonte de dados. Crie a fonte de dados do Google Drive na base de conhecimento usando a Console de gerenciamento da AWS ou a API. Consulte Conectar uma fonte de dados do Google Drive.
-
(Opcional) Ative o controle de acesso em nível de documento. Filtre os resultados da consulta de acordo com as permissões do Google Drive de cada usuário. Requer autenticação da conta de serviço. Consulte Document-level controles de acesso.
