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étodos de autenticação do Google Drive**
| 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](kb-managed-googledrive-service-account-setup.md) |
| 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](kb-managed-googledrive-oauth2-setup.md) |
**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](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html) 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](kb-managed-googledrive-service-account-setup.md) ou. [Configurar a autenticação OAuth 2.0 para o Google Drive](kb-managed-googledrive-oauth2-setup.md)
+ 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, consulte[Permissões para acessar as fontes de dados](kb-permissions.md#kb-permissions-access-ds).
## Como configurar uma fonte de dados do Google Drive
A configuração de uma fonte de dados do Google Drive envolve as seguintes etapas:
1. **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](kb-managed-googledrive-service-account-setup.md) ou. [Configurar a autenticação OAuth 2.0 para o Google Drive](kb-managed-googledrive-oauth2-setup.md)
1. **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](kb-managed-ds-googledrive-connect.md).
1. **(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](kb-managed-ds-googledrive-acl.md).