Differenze tra Drive condiviso e API Il mio Drive

I Drive condivisi seguono modelli di organizzazione, condivisione e proprietà diversi da Il mio Drive. Di conseguenza, alcune operazioni di Il mio Drive non sono consentite per i contenuti di un Drive condiviso.

Questa guida illustra le differenze specifiche dell'API per i Drive condivisi nelle risorse files e changes.

Risorsa file

I seguenti campi della risorsa files vengono compilati solo per i file che si trovano in un Drive condiviso:

  • hasAugmentedPermissions: indica se agli utenti è stato concesso l'accesso diretto al file.
  • capabilities/canAddFolderFromAnotherDrive: indica se l'utente attuale può aggiungere una cartella da un altro Drive (un altro Drive condiviso o Il mio Drive) a questa cartella.
  • capabilities/canDeleteChildren: indica se l'utente attuale può eliminare gli elementi secondari di questa cartella.
  • capabilities/canMoveChildrenOutOfDrive: indica se l'utente attuale può spostare gli elementi secondari di questa cartella all'esterno del Drive condiviso.
  • capabilities/canMoveChildrenWithinDrive: indica se l'utente attuale può spostare gli elementi secondari di questa cartella all'interno del Drive condiviso.
  • capabilities/canMoveItemWithinDrive: indica se l'utente attuale può spostare questo elemento del Drive condiviso all'interno del Drive condiviso.
  • capabilities/canReadDrive: indica se l'utente attuale ha accesso in lettura al Drive condiviso a cui appartiene questo file.
  • capabilities/canTrashChildren: indica se l'utente attuale può spostare gli elementi secondari di questa cartella nel cestino.
  • driveId: l'ID del Drive condiviso in cui si trova il file.
  • trashingUser: se il file è stato spostato esplicitamente nel cestino, l'utente che lo ha fatto.
  • trashedTime: l'ora in cui l'elemento è stato spostato nel cestino. Se utilizzi la versione precedente dell'API Drive v2, questo campo si chiama trashedDate.

I seguenti campi non vengono compilati per i file che si trovano in un Drive condiviso:

  • permissions: a causa delle dimensioni potenziali degli elenchi di controllo dell'accesso (ACL) dei Drive condivisi, le autorizzazioni non vengono restituite come parte dei file. Utilizza il metodo permissions.list, che supporta la paginazione, per elencare le autorizzazioni per un file all'interno di un Drive condiviso o della cartella del Drive condiviso.
  • owners, ownerNames, ownedByMe: i file all'interno di un Drive condiviso sono di proprietà del Drive condiviso, non dei singoli utenti.
  • folderColorRgb: le cartelle non possono essere colorate singolarmente.
  • shared: tutti gli elementi di un Drive condiviso sono condivisi.
  • writersCanShare: non è possibile limitare la condivisione in base al ruolo nei Drive condivisi.

I seguenti campi vengono impostati solo quando all'utente sono state concesse le autorizzazioni di accesso ai file per un elemento:

  • sharedWithMeDate
  • sharingUser

I seguenti campi richiedono una particolare attenzione quando li utilizzi con i Drive condivisi:

  • parents.isRoot: questo campo è true solo per la cartella principale di Il mio Drive; è false per la cartella di primo livello del Drive condiviso.

  • parents: un elemento principale non viene visualizzato nell'elenco degli elementi principali se l'utente che effettua la richiesta non è membro del Drive condiviso e non ha accesso all'elemento principale. Inoltre, ad eccezione della cartella di primo livello, l'elenco degli elementi principali deve contenere esattamente un elemento se il file si trova in un Drive condiviso.

  • capabilities/canRemoveChildren: utilizza capabilities/canDeleteChildren o capabilities/canTrashChildren.

Risorsa change

I seguenti nuovi campi sono disponibili nella changes risorsa per un Drive condiviso:

  • changeType: il tipo di modifica. I valori possibili sono file e drive.
  • driveId: l'ID del Drive condiviso associato a questa modifica.
  • drive: lo stato aggiornato del Drive condiviso. Presente se changeType è drive e l'utente è ancora membro del Drive condiviso.

Potrebbero essere necessarie modifiche aggiuntive per le applicazioni che devono sincronizzare i contenuti con i Drive condivisi o rilevare l'attività. Per maggiori dettagli, vedi Monitorare le modifiche per utenti e Drive condivisi.