Implementare il supporto dei Drive condivisi

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 sono user, domain, drive e allDrives. Preferisci user o drive a allDrives 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 nell'interfaccia utente 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.