Conector do Google Drive Graph (Pré-visualização)

Artigo
12/20/2024

Com o conector do Microsoft Graph, a sua organização no M365 pode indexar ficheiros acessíveis a qualquer pessoa no Google Drive, utilizando o Microsoft Copilot e a Pesquisa.

Este artigo destina-se a administradores do Microsoft 365 ou a qualquer pessoa que configure, execute e monitorize o conector do Google Drive.

Observação

O conector do Google Drive está em pré-visualização. Se quiser ter acesso antecipado para experimentar, inscreva-se com este formulário.

Recursos

Aceder a ficheiros do Google Drive com o poder da pesquisa semântica
Reter ACLs definidas pela sua organização
Personalizar a frequência de pesquisa
Criar fluxos de trabalho com esta ligação e plug-ins do Microsoft Copilot Studio

Limitações

Pasta, respostas & comentários não são indexáveis

Pré-requisitos

Antes de criar um conector do Google Drive, tem de:

1. Seja uma função de superdministrador do Google Workspace ou lhe seja concedido acesso

Pode ser-lhe concedido acesso por uma função de super administrador ou é um utilizador com privilégios administrativos. Não precisa de uma função de superdmin para si próprio se lhe tiver sido concedido acesso por uma função de super administrador.

2. Configurar as credenciais de ligação da Conta de Serviço do Google Drive

Configurou as credenciais de ligação da Conta de Serviço do Google Drive que contêm o e-mail da conta de administrador, o e-mail do cliente (e-mail da conta de serviço) e a chave privada. Para obter mais informações, veja Criar e eliminar chaves de conta de serviço.

3. Criar uma Conta do Google Cloud Service

Crie uma Conta do Serviço Cloud do Google (uma conta com autoridade delegada para assumir uma identidade de utilizador) com a opção Ativar Delegação ao nível do Domínio do G Suite ativada para autenticação servidor a servidor e, em seguida, gerar uma chave privada JSON com a conta. Para obter mais informações, veja Criar contas de serviço.

4. Adicionar APIs necessárias na sua conta de utilizador

Adicione Administração API do SDK e a API do Google Drive na sua conta de utilizador.

5. Adicione os âmbitos OAuth à sua conta de serviço

Adicione (ou peça a um utilizador com uma função de super admin para adicionar) os seguintes âmbitos OAuth à sua conta de serviço com uma função de super administrador. Estes âmbitos de API são necessários para pesquisar todos os documentos e informações de controlo de acesso (ACL) para todos os utilizadores num domínio do Google Workspace:

https://www.googleapis.com/auth/admin.directory.user.readonly

https://www.googleapis.com/auth/admin.directory.group.readonly

https://www.googleapis.com/auth/drive.readonly

Configurar

1. Nome a apresentar

Um nome a apresentar é utilizado para identificar cada referência no Copilot, ajudando os utilizadores a reconhecer facilmente o ficheiro ou item associado. O nome a apresentar também significa conteúdo fidedigno.

2. Domínio do Google Apps

Para se inscrever no Google Workspace, precisa de um nome de domínio da Internet, como your-company.com. Este domínio pode alojar um site (www.your-company.com) e um e-mail (info@your-company.com). Para obter mais informações, consulte O que é um domínio?.

3. E-mail da conta de administrador do Google Apps

Introduza o e-mail de uma conta de administrador do Google Apps no user@company.com formato .

4. Implementação para audiência limitada

Implemente esta ligação numa base de utilizadores limitada se pretender validá-la no Copilot e noutras superfícies de pesquisa antes de expandir a implementação para uma audiência mais ampla.

Para outras definições, como Permissões de Acesso, Regras de inclusão de dados, Esquema, Frequência de pesquisa, etc., definimos as predefinições com base no que funciona melhor com os dados no Google Drive. As predefinições de valores são as seguintes.

Page	Configurações	Valores Predefinidos
Usuários	Permissões de Acesso	Todos os ficheiros acessíveis a qualquer pessoa no Google Drive são visíveis para todos os utilizadores do Microsoft 365 no seu inquilino, a partir do Microsoft Search ou Copilot.
Conteúdo	Conteúdo do Índice	Todas as páginas e mensagens publicadas estão selecionadas por predefinição.
Conteúdo	Gerir Propriedades	Para marcar as propriedades predefinidas e o respetivo esquema, clique aqui.
Sincronização	Pesquisa Incremental	Frequência: a cada 15 minutos
Sincronização	Pesquisa completa	Frequência: todos os dias

Se quiser editar qualquer um destes valores, tem de escolher a opção Configuração Personalizada .

Configuração Personalizada

A configuração personalizada destina-se aos administradores que pretendem editar os valores predefinidos das definições. Depois de clicar na opção "Configuração Personalizada", deverá ver outros três separadores : Utilizadores, Conteúdo e Sincronização.

Usuários

Permissões de acesso

Atualmente, apenas os ficheiros acessíveis a qualquer pessoa no Google Drive são indexados e visíveis para todos os utilizadores do Microsoft 365 no seu inquilino, a partir do Microsoft Search ou Copilot.

Conteúdo

Gerir Propriedades

Aqui, pode adicionar ou remover propriedades disponíveis da sua origem de dados do Google Drive. Atribua um esquema à propriedade (defina se uma propriedade é pesquisável, consultada, recuperável ou refinável), altere a etiqueta semântica e adicione um alias à propriedade. As propriedades selecionadas por predefinição são:

Propriedade Source	Label	Descrição	Esquema
CreatedTime	Data e hora de criação	A hora em que o ficheiro foi criado.	Procurar, Consultar, Obter
Descrição		Uma breve descrição do ficheiro.
FileExtension	Extensão de arquivo	O componente final de fullFileExtension. Este parâmetro só está disponível para ficheiros com conteúdo binário no Google Drive.	Consulta, Refinar, Obter
FileType		O tipo do ficheiro.
IconLink	IconUrl	Uma ligação estática e não autenticada para o ícone do ficheiro.	Obter
LastModifingUser	lastModifiedDateTime	O último utilizador a modificar o ficheiro. Este campo só é preenchido quando a última modificação foi efetuada por um utilizador com sessão iniciada.	Consultar, Obter, Procurar
modifiedTime	Última modificação por	A última vez que o ficheiro foi modificado por qualquer pessoa (RFC 3339 data-hora).	Consultar, Obter, Procurar
Link	url	Uma ligação para abrir o ficheiro num editor ou visualizador relevante do Google num browser.	Obter
Nome	Nome do Arquivo	O nome do arquivo.	Consultar, Obter, Procurar
Proprietário	Criado por	O proprietário deste ficheiro. Apenas determinados ficheiros legados podem ter mais do que um proprietário. Este campo não é preenchido para itens em unidades partilhadas.	Procurar, Consultar, Obter
ParentFolderLink		Uma ligação para a pasta principal que contém o ficheiro.	Obter
ParentFolderName		O nome da pasta principal que contém o ficheiro.	Procurar, Consultar, Obter
Tamanho		Dimensionar bytes de blobs e ficheiros de editor originais.	Procurar, Consultar, Obter

Sincronização

Pode configurar pesquisas completas e incrementais com base nas opções de agendamento aqui presentes. Por predefinição, a pesquisa incremental é definida para cada 15 minutos e a pesquisa completa é definida para todos os dias. Se necessário, pode ajustar estas agendas de acordo com as suas necessidades de atualização de dados.

Solução de problemas

Foram detetadas credenciais inválidas. Verifique as informações das credenciais e marcar as permissões da conta de serviço.

Este erro ocorre quando a conta de serviço não tem as permissões necessárias para o acesso ao Google Drive. Verifique as informações de credenciais da conta e certifique-se de que estão corretamente preenchidas na página de configuração.

Faltam as permissões necessárias para utilizadores/ficheiros.

Erro de autenticação, um ou mais âmbitos OAuth necessários para a sua conta de serviço estão em falta. A sua conta de serviço tem de incluir ambos os âmbitos da API: