Differenze tra Drive condiviso e API Il mio Drive

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

Questa guida illustra le differenze specifiche delle API di 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 al file direttamente su questo file.
  • capabilities/canAddFolderFromAnotherDrive: indica se l'utente corrente 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 corrente può eliminare i figli di questa cartella.
  • capabilities/canMoveChildrenOutOfDrive: indica se l'utente attuale può spostare i file secondari di questa cartella al di fuori del Drive condiviso.
  • capabilities/canMoveChildrenWithinDrive: indica se l'utente corrente può spostare i file 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 corrente ha accesso in lettura al Drive condiviso a cui appartiene questo file.
  • capabilities/canTrashChildren: indica se l'utente corrente può spostare nel cestino i file secondari di questa cartella.
  • driveId: l'ID del Drive condiviso in cui si trova il file.
  • trashingUser: se il file è stato eliminato in modo esplicito, l'utente che lo ha eliminato.
  • trashedTime: L'ora in cui l'elemento è stato cestinato. 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: non è possibile colorare le cartelle singolarmente.
  • shared: Tutti gli elementi di un Drive condiviso vengono condivisi.
  • writersCanShare: non è possibile limitare la condivisione in base al ruolo nei Drive condivisi.

I seguenti campi vengono impostati solo quando all'utente sono stati concessi i permessi di accesso ai file su un elemento:

  • sharedWithMeDate
  • sharingUser

I seguenti campi richiedono una particolare attenzione quando vengono utilizzati con i drive condivisi:

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

  • parents: un genitore non viene visualizzato nell'elenco dei genitori se l'utente che ha effettuato la richiesta non è membro del Drive condiviso e non ha accesso al genitore. Inoltre, ad eccezione della cartella di primo livello, l'elenco dei genitori deve contenere esattamente un elemento se il file si trova all'interno di un Drive condiviso.

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

Modifica risorsa

Le seguenti nuove proprietà sono disponibili nella risorsa changes 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 monitorare l'attività. Per maggiori dettagli, vedi Monitorare le modifiche per gli utenti e i Drive condivisi.