Implementare il supporto dei Drive condivisi

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 sono user, domain, drive e allDrives. Per maggiore efficienza, preferisci user o drive a allDrives.

  • 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.