Differenze tra Drive condiviso e API Il mio Drive

I Drive condivisi hanno modelli di organizzazione, condivisione e proprietà diversi da quelli di Il mio Drive. Di conseguenza, alcune operazioni di Il mio Drive non sono consentite per i contenuti di un Drive condiviso. Questo documento illustra le differenze tra le API specifiche per i Drive condivisi.

Risorsa Files

I seguenti campi vengono compilati solo per i file all'interno di un Drive condiviso:

  • hasAugmentedPermissions: indica se a 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 Drive condiviso diverso o Il mio Drive) a questa cartella.
  • capabilities/canDeleteChildren: indica se l'utente corrente può eliminare le cartelle secondarie di questa cartella.
  • capabilities/canMoveChildrenOutOfDrive: indica se l'utente corrente può spostare le cartelle secondarie di questa cartella al di fuori del Drive condiviso.
  • capabilities/canMoveChildrenWithinDrive: indica se l'utente corrente può spostare le cartelle secondarie di questa cartella all'interno del Drive condiviso.
  • capabilities/canMoveItemWithinDrive: indica se l'utente corrente 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ò eliminare le cartelle secondarie di questa cartella.
  • driveId: l'ID del Drive condiviso in cui si trova il file.
  • trashingUser: se il file è stato eliminato esplicitamente, l'utente che lo ha eliminato.

  • trashedTime: l'ora in cui l'elemento è stato spostato nel cestino.

I seguenti campi non vengono compilati per i file all'interno di un Drive condiviso:

  • permissions: a causa delle potenziali dimensioni degli ACL dei Drive condivisi, le autorizzazioni non vengono restituite all'interno 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 del Drive condiviso stesso.
  • 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 sono condivisi.
  • writersCanShare: al momento non è possibile limitare la condivisione in base al ruolo nei Drive condivisi.

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

  • sharedWithMeDate
  • sharingUser

I seguenti campi richiedono un'attenzione particolare quando li utilizzi con le unità condivise:

  • 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 gruppo principale non viene visualizzato nell'elenco dei gruppi principali se l'utente che effettua la richiesta non è membro del Drive condiviso e non ha accesso al gruppo principale. Inoltre, ad eccezione della cartella di primo livello, l'elenco di directory principali deve contenere esattamente un elemento se il file si trova in un drive condiviso.

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

Risorsa Permissions

Il campo permissionDetails viene compilato solo per i file all'interno di un drive condiviso. Questo campo è un elenco di autorizzazioni condensate attive o ereditate da questo file del Drive condiviso. Questo campo è di sola uscita ed è presente solo per gli elementi di Drive condiviso. Inoltre,

  • Sono stati definiti due nuovi ruoli organizer e fileOrganizer.
  • permissions.list ora supporta la paginazione.

Risorsa Changes

Nella risorsa Changes per un drive condiviso sono disponibili i seguenti nuovi campi:

  • 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, consulta Monitorare le modifiche per gli utenti e i Drive condivisi.