Implementare il supporto dei Drive condivisi

I Drive condivisi seguono modelli di organizzazione, condivisione e proprietà diversi da Il mio Drive. Se la tua app deve creare e gestire file sui Drive condivisi, devi implementare il supporto dei Drive condivisi nella tua app. La complessità dell'implementazione dipende dalla funzionalità della tua app.

Per iniziare, devi includere il parametro di query supportsAllDrives=true nelle tue richieste quando la tua app esegue le seguenti operazioni:

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 comunica 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 eseguono ricerche in più corpora richiedono funzionalità aggiuntive di Drive condivisi. Il resto di questo documento evidenzia le modifiche aggiuntive necessarie per eseguire queste attività.

Cercare contenuti in un Drive condiviso

Utilizza il metodo list nella risorsa files per trovare i file degli utenti nei Drive condivisi. Per cercare un Drive condiviso, vedi Cercare Drive condivisi.

Il metodo list contiene i seguenti parametri di query specifici per il Drive condiviso:

  • driveId: l'ID del Drive condiviso in cui eseguire la ricerca.

  • corpora: i corpi degli elementi (file o documenti) a cui si applica la query. I corpi supportati sono user, domain, drive e allDrives. Preferisci user o drive a allDrives per efficienza. Per impostazione predefinita, i corpora sono impostati su user.

  • includeItemsFromAllDrives: indica se includere nei risultati gli elementi di Il mio Drive e dei Drive condivisi. Se non è presente o è impostato su false, gli elementi del Drive condiviso non vengono restituiti.

  • supportsAllDrives: indica se l'applicazione richiedente supporta sia Il mio Drive sia il Drive condiviso. Se è false, gli elementi di Drive condivisi non sono inclusi nella risposta.

Le seguenti modalità di query sono specifiche per i Drive condivisi:

includeItemsFromAllDrives corpora Descrizione query
true user Esegue query sui file a cui l'utente ha avuto accesso, inclusi i file di Drive condivisi e di Il mio Drive.
true domain Esegue query sui file condivisi con il dominio, inclusi i file di Drive condivisi e Il mio Drive.
true drive Esegue query su tutti gli elementi del Drive condiviso specificato. driveId deve essere specificato nella richiesta.
true allDrives Esegue query sui file a cui l'utente ha avuto accesso e su tutti i Drive condivisi di cui è membro. Tieni presente che la risposta potrebbe includere incompleteSearch:true, a indicare che alcuni corpora non sono stati cercati per questa richiesta.

Tenere traccia delle modifiche su un Drive condiviso

Utilizza il metodo list sulla risorsa changes per tenere traccia delle modifiche su un Drive condiviso. Per maggiori informazioni, vedi Monitorare le modifiche per gli utenti e i drive condivisi.

Il metodo list contiene i seguenti parametri di query specifici per il Drive condiviso:

  • driveId: il Drive condiviso da cui vengono restituite le modifiche. Se specificati, gli ID modifica si riferiscono alle modifiche apportate agli elementi all'interno del Drive condiviso che forniscono lo stato attuale di un file. Per fare riferimento a una modifica specifica del Drive condiviso, devono essere utilizzati sia l'ID del Drive condiviso sia l'ID modifica come identificatore.

  • includeItemsFromAllDrives: indica se i file o le modifiche del Drive condiviso devono essere inclusi nell'elenco delle modifiche.

  • supportsAllDrives: Indica se l'applicazione richiedente supporta i Drive condivisi. Se il valore è false, gli elementi del Drive condiviso, inclusi sia i Drive condivisi sia i file all'interno di un Drive condiviso, non vengono restituiti.

Le seguenti modalità di query sono specifiche per i Drive condivisi:

includeItemsFromAllDrives driveId Descrizione query
true No Le modifiche riflettono quelle apportate ai file all'interno o all'esterno dei Drive condivisi a cui l'utente ha avuto accesso, nonché quelle apportate ai Drive condivisi di cui l'utente è membro.
true Sì Le modifiche riflettono quelle apportate al Drive condiviso specifico indicato e agli elementi al suo interno.

Per ulteriori dettagli sul comportamento del log delle modifiche, vedi Monitorare le modifiche per utenti e Drive condivisi.

Attivare il supporto del Drive condiviso nell'interfaccia utente di Drive

Per accedere ai contenuti dei drive condivisi utilizzando l'interfaccia utente di Drive, assicurati di aver selezionato la casella Supporto dei drive condivisi nella scheda Integrazione dell'interfaccia utente di Drive dell'API Google Drive nella console Google Cloud. Per saperne di più, consulta Configurare un'integrazione della UI di Drive.

Utilizzare Google Picker con i Drive condivisi

Il selettore Google supporta la selezione di elementi nei Drive condivisi. Per informazioni dettagliate sull'attivazione del supporto dei Drive condivisi e sull'aggiunta di visualizzazioni dei Drive condivisi nel selettore, consulta l'API Google Picker.