Implementare il supporto dei Drive condivisi

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

Per iniziare, devi includere il parametro di query supportsAllDrives=true nelle 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 comunica a Google Drive che la tua applicazione è progettata per gestire i file sui drive condivisi.

Le applicazioni che leggono o modificano le autorizzazioni, monitorano le modifiche o devono eseguire ricerche in più corpora richiedono funzionalità aggiuntive del Drive condiviso. La parte restante di questo documento evidenzia le ulteriori modifiche 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 per i drive condivisi:

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

  • includeItemsFromAllDrives: indica se gli elementi dei Drive condivisi devono essere inclusi nei risultati. Se non è presente o è impostato su false, gli elementi del Drive condiviso non vengono restituiti.

  • corpora: i testi degli elementi (file/documenti) a cui si applica la query. I tipi di corpo supportati sono user, domain, drive e allDrives. Per maggiore efficienza, preferisci user o drive a allDrives.

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

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

includeItemsFromAllDrives corpora Descrizione ricerca
true user Esegue query sui file a cui l'utente ha eseguito l'accesso, inclusi i file di Drive condivisi e di 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 eseguito l'accesso e su tutti i Drive condivisi di cui è membro. Tieni presente che la risposta potrebbe includere incompleteSearch : true, a indicare che non è stata eseguita alcuna ricerca in alcuni corpora per questa richiesta.
true domain Esegue query sui file condivisi nel 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 saperne di più, consulta Tenere traccia delle modifiche per utenti e Drive condivisi. Il metodo changes.list contiene i seguenti campi e modalità di query specifici per i 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 sia l'ID del Drive condiviso sia l'ID modifica come identificatore.
  • 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 i file o le modifiche dei Drive condivisi devono essere inclusi nell'elenco delle modifiche.

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

includeItemsFromAllDrives driveId Descrizione ricerca
true No Le modifiche rispecchiano 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 riflettono le modifiche al determinato 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 "Supporto dei Drive condivisi" nella console API di Google. Per ulteriori informazioni, consulta la pagina Configurare un'integrazione dell'interfaccia utente di Drive.

Utilizzare il selettore di file con i Drive condivisi

Il selettore di 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 dei file, consulta l'API Google Picker.

Passaggi successivi

Vai a Gestire i Drive condivisi per assistenza sulla creazione e sulla gestione delle autorizzazioni dei Drive condivisi.