Connettore Google Drive Graph (anteprima)

Articolo
12/20/2024

Con il connettore Microsoft Graph, l'organizzazione in M365 può indicizzare i file accessibili a chiunque in Google Drive, usando Microsoft Copilot e Ricerca.

Questo articolo è destinato agli amministratori di Microsoft 365 o a chiunque configuri, eserciti e monitori il connettore Google Drive.

Nota

Il connettore Google Drive è in anteprima. Se si vuole ottenere l'accesso anticipato per provarlo, iscriversi usando questo modulo.

Funzionalità

Accedere ai file di Google Drive usando la potenza della ricerca semantica
Conservare gli ACL definiti dall'organizzazione
Personalizzare la frequenza di ricerca per indicizzazione
Creare flussi di lavoro usando questa connessione e plug-in da Microsoft Copilot Studio

Limitazioni

Cartella, le risposte & commenti non sono indicizzabili

Prerequisiti

Prima di creare un connettore Google Drive, è necessario:

1. Essere un ruolo di amministratore con privilegi avanzati di Google Workspace o ottenere l'accesso

Può essere concesso l'accesso da un ruolo di amministratore con privilegi avanzati o un utente con privilegi amministrativi. Non è necessario un ruolo di amministratore con privilegi avanzati se è stato concesso l'accesso da un ruolo di amministratore con privilegi avanzati.

2. Configurare le credenziali di connessione dell'account del servizio Google Drive

Credenziali di connessione dell'account del servizio Google Drive configurate contenenti l'indirizzo di posta elettronica dell'account amministratore, l'indirizzo di posta elettronica client (indirizzo di posta elettronica dell'account di servizio) e la chiave privata. Per altre informazioni, vedere Creare ed eliminare chiavi dell'account del servizio.

3. Creare un account di Google Cloud Service

Creare un account del servizio Google Cloud (un account con autorità delegata per assumere un'identità utente) con Enable G Suite Domain-wide Delegation attivato per l'autenticazione da server a server e quindi generare una chiave privata JSON usando l'account. Per altre informazioni, vedere Creare account del servizio.

4. Aggiungere le API necessarie nell'account utente

Aggiungere Amministrazione'API SDK e l'API Google Drive nell'account utente.

5. Aggiungere gli ambiti OAuth all'account del servizio

Aggiungere (o chiedere a un utente con un ruolo di amministratore con privilegi avanzati di aggiungere) gli ambiti OAuth seguenti all'account del servizio usando un ruolo di amministratore con privilegi avanzati. Questi ambiti API sono necessari per eseguire la ricerca per indicizzazione di tutti i documenti e informazioni sul controllo di accesso (ACL) per tutti gli utenti in un dominio di 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

Configurazione

1. Nome visualizzato

Un nome visualizzato viene usato per identificare ogni riferimento in Copilot, consentendo agli utenti di riconoscere facilmente il file o l'elemento associato. Il nome visualizzato indica anche contenuto attendibile.

2. Dominio di Google Apps

Per iscriversi a Google Workspace, è necessario un nome di dominio Internet, ad esempio your-company.com. Questo dominio può ospitare un sito Web (www.your-company.com) e un messaggio di posta elettronica (info@your-company.com). Per altre informazioni, vedere Che cos'è un dominio?.

3. Posta elettronica dell'account amministratore di Google Apps

Immettere il messaggio di posta elettronica di un account amministratore di Google Apps nel user@company.com formato .

4. Implementazione a un pubblico limitato

Distribuire questa connessione a una base di utenti limitata se si vuole convalidarla in Copilot e in altre aree di ricerca prima di espandere l'implementazione a un pubblico più ampio.

Per altre impostazioni, ad esempio autorizzazioni di accesso, regole di inclusione dei dati, schema, frequenza di ricerca per indicizzazione e così via, vengono impostate le impostazioni predefinite in base a ciò che funziona meglio con i dati in Google Drive. Le impostazioni dei valori predefiniti sono le seguenti.

Pagina	Impostazioni	Valori predefiniti
Utenti	Autorizzazioni di accesso	Tutti i file accessibili a chiunque in Google Drive sono visibili a tutti gli utenti di Microsoft 365 nel tenant, da Microsoft Search o Copilot.
Contenuto	Contenuto indice	Tutti i post e le pagine pubblicati sono selezionati per impostazione predefinita.
Contenuto	Gestisci proprietà	Per controllare le proprietà predefinite e il relativo schema, fare clic qui.
Sincronizza	Ricerca per indicizzazione incrementale	Frequenza: ogni 15 minuti
Sincronizza	Ricerca per indicizzazione completa	Frequenza: ogni giorno

Se si desidera modificare uno di questi valori, è necessario scegliere l'opzione Installazione personalizzata .

Installazione personalizzata

L'installazione personalizzata è destinata agli amministratori che vogliono modificare i valori predefiniti per le impostazioni. Dopo aver fatto clic sull'opzione "Installazione personalizzata", verranno visualizzate altre tre schede: Utenti, Contenuto e Sincronizzazione.

Utenti

Autorizzazioni di accesso

Attualmente solo i file accessibili a chiunque in Google Drive sono indicizzati e visibili a tutti gli utenti di Microsoft 365 nel tenant, da Microsoft Search o Copilot.

Contenuto

Gestisci proprietà

Qui è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati di Google Drive. Assegnare uno schema alla proprietà (definire se una proprietà è ricercabile, ricercabile, recuperabile o perfezionabile), modificare l'etichetta semantica e aggiungere un alias alla proprietà . Le proprietà selezionate per impostazione predefinita sono:

Proprietà Source	Etichetta	Descrizione	Schema
CreatedTime	Data e ora di creazione	Ora in cui è stato creato il file.	Ricerca, Query, Recupera
Descrizione		Breve descrizione del file.
FileExtension	Estensione del file	Componente finale di fullFileExtension. Questo parametro è disponibile solo per i file con contenuto binario in Google Drive.	Query, Refine, Retrieve
FileType		Tipo del file.
IconLink	IconUrl	Collegamento statico non autenticato all'icona del file.	Recuperare
LastModifingUser	lastModifiedDateTime	Ultimo utente a modificare il file. Questo campo viene popolato solo quando l'ultima modifica è stata eseguita da un utente connesso.	Query, Recupero, Ricerca
modifiedTime	Autore ultima modifica	L'ultima volta che il file è stato modificato da chiunque (rfc 3339 data-ora).	Query, Recupero, Ricerca
Collegamento	URL	Collegamento per l'apertura del file in un editor o visualizzatore Google pertinente in un browser.	Recuperare
Nome	Nome file	Nome del file.	Query, Recupero, Ricerca
Proprietario	Creato da	Proprietario di questo file. Solo alcuni file legacy possono avere più di un proprietario. Questo campo non viene popolato per gli elementi nelle unità condivise.	Ricerca, Query, Recupera
ParentFolderLink		Collegamento per la cartella padre contenente il file.	Recuperare
ParentFolderName		Nome della cartella padre contenente il file.	Ricerca, Query, Recupera
Dimensioni		Dimensioni in byte di BLOB e file dell'editor di prima parte.	Ricerca, Query, Recupera

Sincronizza

È possibile configurare ricerche per indicizzazione complete e incrementali in base alle opzioni di pianificazione disponibili qui. Per impostazione predefinita, la ricerca per indicizzazione incrementale viene impostata per ogni 15 minuti e la ricerca per indicizzazione completa viene impostata per ogni giorno. Se necessario, è possibile modificare queste pianificazioni in base alle esigenze di aggiornamento dei dati.

Risoluzione dei problemi

Sono stati rilevati credenziali non valide. Controllare le informazioni sulle credenziali e controllare le autorizzazioni dell'account del servizio.

Questo errore si verifica quando l'account del servizio non dispone delle autorizzazioni necessarie per l'accesso a Google Drive. Controllare le informazioni sulle credenziali dell'account e assicurarsi che siano compilate correttamente nella pagina di installazione.

Le autorizzazioni necessarie per utenti/file sono mancanti.

Errore di autenticazione, mancano uno o più ambiti OAuth necessari per l'account del servizio. L'account del servizio deve includere entrambi gli ambiti API: