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. Questo documento illustra le differenze API specifiche dei Drive condivisi.

Risorsa Files

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

  • hasAugmentedPermissions: indica se a qualsiasi utente viene concesso l'accesso al file direttamente su questo file.
  • capabilities/canAddFolderFromAnotherDrive: indica se l'utente corrente può aggiungere a questa cartella una cartella di un altro Drive (Drive condiviso diverso o Il mio Drive).
  • capabilities/canDeleteChildren: indica se l'utente corrente può eliminare i secondari di questa cartella.
  • capabilities/canMoveChildrenOutOfDrive: indica se l'utente corrente può spostare elementi secondari di questa cartella all'esterno del Drive condiviso.
  • capabilities/canMoveChildrenWithinDrive: indica se l'utente corrente può spostare elementi secondari di questa cartella all'interno del Drive condiviso.
  • capabilities/canMoveItemWithinDrive: specifica 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 il file.
  • capabilities/canTrashChildren: indica se l'utente corrente può spostare nel cestino i secondari di questa cartella.
  • driveId: l'ID del Drive condiviso all'interno del quale si trova il file.
  • trashingUser: se il file è stato esplicitamente spostato nel cestino, l'utente che lo ha spostato.

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

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

  • permissions: a causa delle potenziali dimensioni degli ACL dei Drive condivisi, le autorizzazioni non vengono restituite come parte dei file. Utilizza il metodo permissions.list, che supporta l'impaginazione, per elencare le autorizzazioni per un file all'interno di un Drive condiviso o dello stesso Drive condiviso.
  • owners, ownerNames, ownedByMe: i file all'interno di un Drive condiviso sono di proprietà del Drive condiviso e non dei singoli utenti.
  • folderColorRgb: le cartelle non possono essere colorate 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 all'utente 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; è falso per la cartella di primo livello del Drive condiviso.

  • parents: l'utente principale non viene visualizzato nell'elenco degli elementi principali se l'utente che ha inviato la richiesta non è membro del Drive condiviso e non ha accesso all'utente principale. Inoltre, fatta eccezione per la 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.

Risorsa Permissions

Il campo permissionDetails viene compilato solo per i file che si trovano all'interno di un Drive condiviso. Questo campo è un elenco di autorizzazioni ridotte attive o ereditate da questo file del Drive condiviso. Questo è un campo di solo output ed è presente solo per gli elementi dei Drive condivisi. Inoltre,

  • Sono stati definiti due nuovi ruoli di organizer e fileOrganizer.
  • permissions.list ora supporta l'impaginazione.

Risorsa Changes

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

  • changeType: il tipo della 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. Presenta se changeType è drive e l'utente è ancora membro del Drive condiviso.

Potrebbero essere necessarie ulteriori modifiche alle applicazioni che richiedono la sincronizzazione dei contenuti con i Drive condivisi o il monitoraggio delle attività. Per maggiori dettagli, consulta Tenere traccia delle modifiche per utenti e Drive condivisi.