I Drive condivisi seguono modelli di organizzazione, condivisione e proprietà di Il mio Drive. Se l'app creerà e gestirà file su Drive condivisi, devi implementare il supporto dei Drive condivisi. La complessità dell'implementazione dipende dalla funzionalità dell'app.
Per iniziare, devi includere il parametro di query supportsAllDrives=true
nelle
richieste quando la tua app esegue le operazioni elencate di seguito:
API Drive v3
files.get
files.list
files.create
files.update
files.copy
files.delete
changes.list
changes.getStartPageToken
permissions.list
permissions.get
permissions.create
permissions.update
permissions.delete
API Drive v2
files.get
files.list
files.insert
files.update
files.patch
files.copy
files.trash
files.untrash
files.delete
files.touch
children.insert
parents.insert
changes.list
changes.getStartPageToken
changes.get
permissions.list
permissions.get
permissions.insert
permissions.update
permissions.patch
permissions.delete
Il parametro supportsAllDrives=true
indica a Google Drive che la tua applicazione è progettata per gestire i file sui Drive condivisi.
Le applicazioni che leggono o modificano le autorizzazioni, tengono traccia delle modifiche o devono eseguire ricerche in più corpora richiedono funzionalità aggiuntive dei Drive condivisi. La parte restante di questo documento evidenzia le modifiche aggiuntive necessarie per eseguire queste attività.
Cercare contenuti su un Drive condiviso
Utilizza il metodo files.list
per cercare i Drive condivisi. Questa sezione illustra i campi specifici dei Drive condivisi nel metodo files.list
. Per cercare un Drive condiviso, consulta Cercare file e cartelle.
Il metodo files.list
contiene i seguenti campi e modalità di query specifici dei Drive condivisi:
driveId
- ID del Drive condiviso in cui eseguire la ricerca.includeItemsFromAllDrives
: indica se gli elementi del Drive condiviso devono essere inclusi nei risultati. Se non è presente o viene impostato su false, gli elementi del Drive condiviso non vengono restituiti.corpora
: corpi di elementi (file/documenti) a cui si applica la query. I corpi supportati sonouser
,domain
,drive
eallDrives
. Per maggiore efficienza, preferisciuser
odrive
aallDrives
.supportsAllDrives
: indica se l'applicazione richiedente supporta sia I miei Drive sia i Drive condivisi. Se il valore è false, gli elementi del Drive condiviso non sono inclusi nella risposta.
Le seguenti modalità di query sono specifiche dei Drive condivisi:
includeItemsFromAllDrives |
corpora |
Descrizione ricerca |
---|---|---|
true |
user |
Esegue una query sui file a cui l'utente ha eseguito l'accesso, inclusi i file del Drive condiviso e di Il mio Drive. |
true |
drive |
Esegue una query su tutti gli elementi del Drive condiviso specificato. L'ID Drive deve essere specificato nella richiesta. |
true |
allDrives |
Esegue una query sui file a cui l'utente ha eseguito l'accesso e su tutti i Drive condivisi di cui è membro. Tieni presente che la risposta potrebbe includere incompleteSearch : true , a indicare che questa richiesta non è stata cercata in alcuni corpora. |
true |
domain |
Esegue una query sui file condivisi con il dominio, inclusi i file del Drive condiviso e di Il mio Drive. |
Monitorare le modifiche su un Drive condiviso
Utilizza il metodo changes.list
per monitorare le modifiche
su un Drive condiviso. Questa sezione illustra i campi specifici dei Drive condivisi nel metodo changes.list
. Per ulteriori informazioni, consulta Monitorare le modifiche per utenti e Drive condivisi.
Il metodo changes.list
contiene i seguenti campi e modalità di query specifici dei Drive condivisi:
driveId
: il Drive condiviso da cui vengono restituite le modifiche. Se specificati, gli ID modifica si riferiscono alle modifiche all'interno del Drive condiviso, non alle modifiche ai file mostrati all'utente. Per fare riferimento a una modifica specifica del Drive condiviso, è necessario utilizzare come identificatore sia l'ID del Drive condiviso sia l'ID modifica.supportsAllDrives
: indica se l'applicazione richiedente supporta i Drive condivisi. Se il valore è false, gli elementi del Drive condiviso, inclusi i Drive condivisi e i file all'interno di un Drive condiviso, non vengono restituiti.includeItemsFromAllDrives
: indica se le modifiche o i file dei Drive condivisi devono essere inclusi nell'elenco delle modifiche.
Le seguenti modalità di query sono specifiche dei Drive condivisi:
includeItemsFromAllDrives |
driveId |
Descrizione ricerca |
---|---|---|
true |
No | Le modifiche si riferiscono alle modifiche apportate ai file all'interno o all'esterno dei Drive condivisi a cui l'utente ha eseguito l'accesso, nonché alle modifiche ai Drive condivisi di cui l'utente è membro. |
true |
Sì | Le modifiche riflettono le modifiche apportate al Drive condiviso specificato e agli elementi al suo interno. |
Per ulteriori dettagli sul comportamento del log delle modifiche, consulta Log delle modifiche.
Attivare il supporto dei Drive condivisi nell'interfaccia utente di Drive
Per accedere ai contenuti dei Drive condivisi utilizzando l'interfaccia utente di Drive, assicurati di aver selezionato l'opzione "Supporto dei Drive condivisi" nella console API di Google. Per saperne di più, consulta Configurare un'integrazione dell'interfaccia utente di Drive.
Utilizzare il selettore file con i Drive condivisi
Il selettore file supporta la selezione di elementi nei Drive condivisi. Per informazioni dettagliate sull'attivazione del supporto dei Drive condivisi e sull'aggiunta della visualizzazione dei Drive condivisi nel selettore file, consulta l'API Google Picker.
Passaggi successivi
Continua su Gestire i Drive condivisi per ricevere assistenza sulla creazione di Drive condivisi e sulla gestione delle relative autorizzazioni.