I Drive condivisi seguono organizzazioni, condivisioni e proprietà diverse modelli da Il mio Drive. Se la tua app creerà e gestirà file su file condivisi devi implementare il supporto dei Drive condivisi nella tua app. La complessità l'implementazione dipende dalla funzionalità dell'app.
Per iniziare, devi includere il parametro di query supportsAllDrives=true
in
le tue 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 le tue
è progettata per gestire
i file sui Drive condivisi.
Le applicazioni che leggono o modificano le autorizzazioni, tengono traccia delle modifiche o devono la ricerca in più corpora richiede funzionalità aggiuntive dei Drive condivisi. La parte restante di questo documento evidenzia le ulteriori modifiche che è necessario eseguire queste attività.
Cercare contenuti su un Drive condiviso
Utilizza il metodo files.list
per cercare
Drive condivisi. Questa sezione illustra i campi specifici dei Drive condivisi nella
files.list
. Per cercare un Drive condiviso, consulta
Cercare file e cartelle.
Il metodo files.list
contiene i seguenti elementi condivisi
e le modalità di query specifiche di Drive:
driveId
: ID del Drive condiviso in cui cercare.includeItemsFromAllDrives
: se gli elementi del Drive condiviso devono essere inclusi nei risultati. Se non è presente o viene impostato su false, gli elementi del Drive condiviso vengono e non vengono restituiti.corpora
: corpi di elementi (file/documenti) per a cui viene applicata la query. Gli organismi supportati sonouser
,domain
,drive
eallDrives
. Preferisciuser
odrive
aallDrives
per una maggiore efficienza.supportsAllDrives
: se l'applicazione che ha inviato la richiesta supporta sia da Il mio Drive che da Drive condivisi. Se il valore è false, gli elementi del Drive condiviso non vengono incluso nella risposta.
Le seguenti modalità di query sono specifiche per i Drive condivisi:
includeItemsFromAllDrives |
corpora |
Descrizione ricerca |
---|---|---|
true |
user |
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 query su tutti gli elementi nel Drive condiviso specificato. È necessario specificare driveId nella richiesta. |
true |
allDrives |
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 in alcuni corpora non è stata eseguita la ricerca per questa richiesta. |
true |
domain |
Query sui file condivisi con il dominio, inclusi i file del Drive condiviso e di Il mio Drive. |
Tenere traccia delle 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 nella
changes.list
. Per ulteriori informazioni, consulta
Tenere traccia delle modifiche per utenti e Drive condivisi.
Il metodo changes.list
contiene i seguenti elementi condivisi
e le modalità di query specifiche di Drive:
driveId
: il Drive condiviso da cui vengono restituite le modifiche. Se specificato, gli ID modifica si riferiscono alle modifiche all'interno del Drive condiviso, non modifiche ai file mostrati all'utente. Per fare riferimento a un Drive condiviso specifico modifica, sia l'ID del Drive condiviso sia l'ID modifica devono essere utilizzati come identificatori.supportsAllDrives
: se l'applicazione che ha inviato la richiesta supporta la condivisione guida. Se il valore è falso, gli elementi del Drive condiviso, inclusi i Drive condivisi e contenuti all'interno di un Drive condiviso, non vengono restituiti.includeItemsFromAllDrives
: se devono essere apportate modifiche o file dei Drive condivisi incluse nell'elenco delle modifiche.
Le seguenti modalità di query sono specifiche per i Drive condivisi:
includeItemsFromAllDrives |
driveId |
Descrizione ricerca |
---|---|---|
true |
No | Le modifiche riflettono le modifiche ai file all'interno o all'esterno dei Drive condivisi a cui l'utente ha eseguito l'accesso, nonché le modifiche ai Drive condivisi di cui l'utente è membro. |
true |
Sì | Le modifiche rispecchiano le modifiche apportate a un determinato Drive condiviso specificato e agli elementi al suo interno. |
Per ulteriori dettagli sul comportamento del log delle modifiche, consulta Log delle modifiche.
Attiva il supporto dei Drive condivisi nella UI di Drive
Per accedere ai contenuti del Drive condiviso utilizzando la UI di Drive, assicurati di aver selezionato "Assistenza per i Drive condivisi" nel Console API di Google. Per ulteriori informazioni, consulta Configura un'integrazione nella UI di Drive.
Utilizzare il selettore file con i Drive condivisi
Il selettore file supporta la selezione di elementi nei Drive condivisi. Per maggiori dettagli sull'attivazione del supporto dei Drive condivisi e sull'aggiunta della visualizzazione dei Drive condivisi Nel selettore file, consulta l'articolo sull'API Google Selecter.
Passaggi successivi
Continua a Gestire i Drive condivisi per sono utili per creare Drive condivisi e gestire le relative autorizzazioni.