Google Drive organizza i file in raccolte, li descrive per tipo e fornisce attributi specifici per ogni file per facilitare la manipolazione dei file.
L'API Google Drive rappresenta i file archiviati su Drive come
risorsa File
.
Proprietà
Drive organizza i file in base alla relazione dell'utente con i contenuti e alla relativa posizione di archiviazione. Le raccolte sono specificate come parte dei metadati del file per mostrare con quale gruppo di file è archiviato il file all'interno di Drive. La differenza principale tra le raccolte di Il mio Drive e dei Drive condivisi è la proprietà dei file. Un singolo utente è il proprietario dei file in Il mio Drive, mentre un gruppo o un'organizzazione è proprietario dei file in un Drive condiviso.
- Il mio Drive
- Ogni utente ha una cartella "principale" chiamata "I miei file", che funge da gerarchia principale e comprende tutto ciò che discende da questa cartella principale. L'utente è il proprietario principale di questa cartella.
- Drive condivisi
- Un Drive condiviso è una struttura organizzativa all'interno di Drive che lavora parallelamente a Il mio Drive. Puoi organizzare un singolo file all'interno di un Drive condiviso o di Il mio Drive, ma non entrambi. Tuttavia, le scorciatoie di Drive possono essere utilizzate per indirizzare a file o cartelle da Drive condivisi a Il mio Drive o viceversa.
Tipi di file
Drive descrive i file in base al tipo. Questo elenco mostra tutti i tipi di file disponibili:
- Blob
- Un file che include testo o contenuti binari come immagini, video e PDF.
- Cartella
Un contenitore che puoi utilizzare per organizzare altri tipi di file su Drive. Le cartelle sono file che contengono solo metadati e hanno il tipo MIME
application/vnd.google-apps.folder
.Nota: un singolo file archiviato in Il mio Drive può essere contenuto in più cartelle. Un singolo file archiviato in un Drive condiviso può avere una sola cartella principale.
- Scorciatoia
Un file di soli metadati che rimanda a un altro file su Drive. Il tipo MIME del file di scorciatoia è
application/vnd.google-apps.shortcut
. Per ulteriori informazioni, consulta Creare una scorciatoia a un file di Drive.- Scorciatoia di terze parti
Un file di soli metadati che rimanda a contenuti archiviati su un sistema di archiviazione di terze parti. Il tipo MIME del file di scorciatoia di terze parti è
application/vnd.google-apps.drive-sdk
. Per ulteriori informazioni, consulta Creare una scorciatoia a un file esterno.- Documento di Google Workspace
Un file creato da un'applicazione Google Workspace, come Documenti, Fogli o Presentazioni Google. Il formato del tipo MIME è
application/vnd.google-apps.*app*
, dove app è il nome dell'applicazione (ad esempioapplication/vnd.google-apps.spreadsheet
per un file di Fogli Google). Per un elenco dei tipi MIME specifici per Drive e Google Workspace, vedi Tipi MIME supportati per Google Workspace e Google Drive.
Nota: non puoi caricare o scaricare cartelle, scorciatoie, scorciatoie di terze parti e documenti di Google Workspace da o verso Drive. Tuttavia, se utilizzano formati compatibili, puoi caricare o esportare i documenti di Google Workspace. Ad esempio, puoi creare un documento Google quando importi un PDF. Allo stesso modo, puoi esportare una presentazione di Presentazioni Google come file di Microsoft PowerPoint.
Caratteristiche del file
Questo elenco mostra alcune caratteristiche di un file di Drive:
- ID file
- Un ID univoco e opaco per ogni file. Gli ID file sono stabili per l'intera durata del file, anche se il nome del file cambia. Le espressioni di ricerca vengono utilizzate per individuare i file per nome, tipo, contenuti, contenitore principale, proprietario o altri metadati.
- Metadati
- Dati che descrivono i contenuti del file. Questi dati includono il nome, il tipo, la creazione e l'ora di modifica. Alcuni campi dei metadati, come
name
, sono indipendenti dall'utente e vengono visualizzati nello stesso modo per tutti gli utenti. Altri campi, comecapabilities
eviewedByMeDate
, contengono valori specifici dell'utente. I tipi di file, come immagini e video, contengono metadati aggiuntivi estratti da EXIF e altri metadati incorporati. - Autorizzazione
- Una concessione dell'accesso a un utente, un gruppo, un dominio o a chiunque può accedere a un file o a una gerarchia di cartelle. Gli utenti stabiliscono chi può accedere a un file mediante l'elenco di controllo dell'accesso (ACL), ovvero un elenco delle autorizzazioni del file. Per ulteriori informazioni, vedi Condividere file, cartelle e Drive.
- Contentezza
- Il corpo del file binario o di testo del file. Alcuni esempi di contenuti che puoi archiviare su Google Drive sono immagini, video, testo e PDF.
- Cronologia delle revisioni
- Il record delle modifiche solo ai contenuti del file, non ai metadati del file. Per maggiori dettagli sulle revisioni, consulta la panoramica delle modifiche e delle revisioni.
- Miniatura
- La rappresentazione grafica di un file. Drive genera automaticamente miniature per molti tipi di file comuni. Per le scorciatoie e altri tipi di file che non possono essere visualizzati da Drive, puoi fornire un'immagine in miniatura.
Organizzazione dei file
L'API Drive organizza i file in posizioni di archiviazione, chiamate spaces
, e raccolte, chiamate corpora
.
- Spazi
Posizioni di archiviazione specifiche isolate l'una dall'altra. Tutti i contenuti su Drive sono archiviati in uno di questi due spazi definiti:
drive
eappDataFolder
.drive
: include tutti i file visibili agli utenti creati in Drive. PDF, documenti, Documenti Google, scorciatoie e altri contenuti caricati dall'utente si trovano nello spaziodrive
.appDataFolder
: include i dati dell'applicazione per utente. Le applicazioni in genere archiviano file di configurazione e altri dati non destinati ad essere accessibili direttamente dagli utenti.
I file non possono essere spostati da uno spazio all'altro.
- Corpora
Raccolte di file utilizzate per restringere l'ambito delle ricerche di file e cartelle. I corpora per Drive sono:
user
,domain
,drive
eallDrives
.user
: include tutti i file creati e aperti dall'utente in "Il mio Drive" e quelli condivisi direttamente con l'utente in "Condivisi con me".drive
: include tutti i file contenuti in un singolo Drive condiviso, come indicato daldriveId
.domain
: include tutti i file disponibili per la ricerca condivisi con il dominio dell'utente.allDrives
: include tutti i file che si trovano nei Drive condivisi di cui l'utente è membro e tutti i file in "Il mio Drive" e "Condivisi con me". Utilizza i corporaallDrives
con cautela poiché ha un ambito ampio e può influire sulle prestazioni. Se possibile, utilizzauser
odrive
anzichéallDrives
per aumentare l'efficienza.
I file possono spostarsi liberamente tra i corpora quando cambiano le autorizzazioni e la proprietà.
Passaggi successivi
Di seguito sono riportati alcuni passaggi che potresti eseguire:
- Scopri come caricare i dati dei file su Drive.
- Scopri come scaricare ed esportare file da Drive.
- Scopri come archiviare i dati specifici dell'applicazione.
- Scopri come visualizzare il selettore di Google in una pagina.