Google Drive organizza i file in raccolte, descrive i file per tipo e fornisce attributi specifici per ogni file per facilitarne la manipolazione.
L'API Google Drive rappresenta i file archiviati su Drive come
File
.
Proprietà
Drive organizza i file in base alla relazione dell'utente con contenuti e la relativa posizione di archiviazione. Le Raccolte sono specificate nell'ambito metadati del file per mostrare il gruppo di file in cui è archiviato il file Drive. La differenza principale tra Il mio Drive e raccolte dei Drive condivisi sono di proprietà dei file. Un singolo utente è il proprietario dei file in Il mio Drive, mentre un gruppo o un'organizzazione sono proprietari dei file su un Drive condiviso.
- Il mio Drive
- Ogni utente ha una "root" cartella chiamata "My Drive" che funge da gerarchia principale. è costituito da tutti gli elementi che discendono da questa cartella principale. L'utente è proprietario principale di questa cartella.
- Drive condivisi
- Un Drive condiviso è un struttura organizzativa all'interno di Drive parallela Il mio Drive. Puoi organizzare un singolo file all'interno di un Drive o Il mio Drive, ma non entrambi. Tuttavia, Le scorciatoie di Drive possono essere utilizzate per puntare a file o cartelle dai Drive condivisi a Il mio Drive; vice versa.
Tipi di file
Drive descrive i file in base al tipo. Questo elenco mostra tutte le opzioni disponibili tipi di file:
- Blob
- Un file con contenuto testuale o binario 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 che 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 su 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 della scorciatoia è
application/vnd.google-apps.shortcut
. Per ulteriori informazioni, consulta la sezione Creare un scorciatoia a un file di Drive.- Scorciatoia di terze parti
Un file di soli metadati che rimanda a contenuti archiviati su un di archiviazione di terze parti. Il tipo MIME del file scorciatoia di terze parti è
application/vnd.google-apps.drive-sdk
. Per ulteriori informazioni, consulta la sezione Creare un a un file esterno.- Documento di Google Workspace
Un file che un'applicazione Google Workspace creati, 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 delle app specifiche per Drive e Google Workspace tipi MIME, consulta la sezione Google Workspace e Tipi MIME supportati da Google Drive.
Nota:non puoi caricare o scaricare cartelle, scorciatoie, terze parti scorciatoie e documenti di Google Workspace da o verso Drive. Tuttavia, se usano formati compatibili, puoi caricare o esportare documenti di Google Workspace. Ad esempio, puoi creare un documento Google quando importa un PDF. Analogamente, puoi esportare una presentazione 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 e sono stabili per tutta la durata del file, anche se cambia il nome. 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
nome, tipo, creazione e modifica. Alcuni campi di metadati,
name
, è indipendente dall'utente e viene visualizzato nello stesso modo per tutti gli utenti. Altro comecapabilities
eviewedByMeDate
contengono campi specifici e i relativi valori. I tipi di file, come immagini e video, contengono metadati aggiuntivi estratti dai file EXIF e da altri metadati incorporati. - Autorizzazione
- Un accesso concesso a un utente, a un gruppo, a un dominio o a chiunque può accedere di una gerarchia di file o cartelle. Gli utenti controllano chi può accedere a un file con Elenco di controllo dell'accesso (ACL, Access Control List), un elenco di autorizzazioni per il file. Per ulteriori informazioni, vedi Condividere file, cartelle e unità pubblicitarie.
- Contenuti
- Il corpo binario o testo del file. Alcuni esempi di contenuti che puoi archiviati su Google Drive sono immagini, video, testo e PDF.
- Cronologia delle revisioni
- Solo la registrazione delle modifiche ai contenuti del file, non i metadati di file. Per ulteriori informazioni sulle revisioni, vedi Modifiche e revisioni panoramica.
- Miniatura
- La rappresentazione grafica di un file. In auto genera automaticamente miniature per molti tipi di file comuni. Per le scorciatoie e altri tipi di file che Drive non è in grado di visualizzare, 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 tra loro. Tutti i contenuti di Drive vengono archiviati in uno di questi due spazi definiti:
drive
eappDataFolder
.drive
: include tutti i file visibili all'utente creati in Drive. PDF, documenti, Documenti Google, scorciatoie e gli altri contenuti caricati dall'utente si trovano nello spaziodrive
.appDataFolder
: include i dati delle applicazioni per utente. Applicazioni di solito archiviano file di configurazione e altri dati non destinati direttamente accessibili dagli utenti.
I file non possono spostarsi da uno spazio all'altro.
- Corpora
Raccolte di file utilizzate per restringere l'ambito di file e cartelle ricerche. 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 la dominio.allDrives
: include tutti i file nei Drive condivisi in cui si trova l'utente un membro e tutti i file in "Il mio Drive" e "Condivisi con me". Usa il corporaallDrives
con cautela, poiché ha un ambito ampio e può influisce sulle prestazioni. Se possibile, usauser
odrive
al posto diallDrives
per l'efficienza.
I file possono spostarsi liberamente tra i vari corpora man mano che le autorizzazioni e la proprietà cambiano.
Passaggi successivi
Di seguito sono riportati alcuni passaggi che puoi eseguire:
- Scopri come caricare i dati dei file per Drive.
- Scopri come scaricare e esportare file da Drive.
- Scopri come archiviare i dati specifici dell'applicazione.
- Scopri come visualizzare il selettore di Google su una pagina.