Google Drive organizza i file in raccolte, li descrive per tipo e fornisce attributi specifici per ogni file per facilitarne la manipolazione.
L'API Google Drive rappresenta i file archiviati su Drive come una
files risorsa.
Proprietà
Drive organizza i file in base alla relazione dell'utente con i contenuti e alla posizione di archiviazione. Le raccolte vengono specificate come parte dei metadati del file per mostrare il gruppo di file in cui è 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 "root" denominata "Il mio Drive" che funge da gerarchia principale e include tutto ciò che deriva da questa cartella root. L'utente è il proprietario principale di questa cartella.
- Un Drive condiviso è una struttura organizzativa all'interno di Drive che si trova parallelamente a Il mio Drive. Puoi organizzare un singolo file all'interno di un Drive condiviso o di Il mio Drive, ma non di entrambi. Tuttavia, le scorciatoie di Drive possono essere utilizzate per puntare a file o cartelle da Drive condivisi a Il mio Drive o viceversa.
Tipi di file
Drive descrive i file per tipo. Questo elenco mostra tutti i tipi di file disponibili:
- Blob
- Un file che contiene testo o contenuti binari come immagini, video e PDF.
- Cartella
Un container 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. Per saperne di più, consulta Creare e popolare le cartelle.Nota: un singolo file archiviato in Il mio Drive può trovarsi in più cartelle. Un singolo file archiviato in un Drive condiviso può avere una sola cartella principale.
- Documento Google Workspace
Un file creato da un'applicazione Google Workspace, ad esempio 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.spreadsheetper un file Fogli). Per un elenco dei tipi MIME specifici di Drive e Google Workspace, vedi Tipi MIME supportati per Google Workspace e Google Drive.- Scorciatoia
Un file di soli metadati che punta a un altro file su Drive. Il tipo MIME del file di scorciatoia è
application/vnd.google-apps.shortcut. Per saperne di più, consulta Creare una scorciatoia a un file di Drive file.- Scorciatoia di terze parti
Un file di soli metadati che rimanda a contenuti archiviati in un sistema di archiviazione di terze parti. Il tipo MIME del file di scorciatoia di terze parti è
application/vnd.google-apps.drive-sdk. Per saperne di più, consulta Creare un file di scorciatoia per i contenuti archiviati dalla tua app.
Caratteristiche dei file
Questo elenco mostra alcune caratteristiche di un file di Drive:
- Proposta di accesso
- Una proposta di un richiedente a un approvatore per concedere a un destinatario l'accesso a un elemento di Drive. Per saperne di più, consulta Elencare e risolvere le proposte di accesso in attesa.
- Contenuti
- Il corpo binario o di testo del file. Alcuni esempi di contenuti che puoi archiviare su Drive sono immagini, video, testo e PDF.
- ID file
- Un ID univoco e opaco per ogni file. Gli ID file sono stabili per tutta la durata del file, anche se il nome del file cambia. Le espressioni di ricerca vengono utilizzate per individuare i file in base a nome, tipo, contenuti, container principale, proprietario o altri metadati.
- Metadati
- Dati che descrivono i contenuti del file. Questi dati includono il nome, il tipo, la creazione e gli orari di modifica. Alcuni campi di metadati, come
name, sono indipendenti dall'utente e vengono visualizzati allo stesso modo per ogni utente. Altri campi, comecapabilitieseviewedByMeDate, contengono valori specifici dell'utente. I tipi di file, come immagini e video, contengono metadati aggiuntivi estratti da EXIF e altri metadati incorporati. Per saperne di più, consulta Gestire i metadati dei file. - Autorizzazione
- Una concessione di accesso a un utente, un gruppo, un dominio o al mondo per accedere a un file o a una gerarchia di cartelle. Gli utenti controllano chi può accedere a un file con l'elenco di controllo degli accessi (ACL), che è un elenco di autorizzazioni per il file. Per saperne di più, consulta Condividere file, cartelle e Drive.
- Cronologia delle revisioni
- Il record delle modifiche solo ai contenuti del file, non ai metadati del file. Per maggiori dettagli sulle revisioni, vedi Panoramica delle modifiche e delle revisioni.
- Miniatura
- Una rappresentazione grafica di un file. Drive genera automaticamente le miniature per molti tipi di file comuni. Per le scorciatoie e altri tipi di file che Drive non può eseguire il rendering, puoi fornire un'immagine miniatura. Per saperne di più, consulta Caricare le miniature.
Organizzazione di 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 di Drive vengono archiviati in uno di questi due spazi definiti:
driveeappDataFolder.drive: include tutti i file visibili all'utente creati in Drive. PDF, documenti, Documenti Google, scorciatoie e altri contenuti caricati dall'utente si trovano nello spaziodrive.appDataFolder: include i dati delle applicazioni per utente. In genere, le applicazioni archiviano file di configurazione e altri dati che non devono essere accessibili direttamente dagli utenti.
I file non possono essere spostati tra gli
spaces.- Corpora
Raccolte di file utilizzate per restringere l'ambito delle ricerche di file e cartelle. I corpora per Drive sono:
user,domain,driveeallDrives.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 dadriveId.domain: include tutti i file ricercabili condivisi con il dominio dell'utente.allDrives: include tutti i file nei Drive condivisi di cui l'utente è membro e tutti i file in "Il mio Drive" e "Condivisi con me". Utilizza il corporaallDrivescon cautela, in quanto ha un ambito ampio e può influire sul rendimento. Se possibile, utilizzauserodriveanzichéallDrivesper una maggiore efficienza.
I file possono essere spostati liberamente tra i
corporaman mano che le autorizzazioni e la proprietà cambiano.
Argomenti correlati
Di seguito sono riportati alcuni possibili passaggi successivi:
- Scopri come creare e gestire i file.
- Scopri come creare e popolare le cartelle.
- Scopri come caricare i dati dei file.
- Scopri come scaricare ed esportare i file.
- Scopri come archiviare i dati specifici dell'applicazione.
- Scopri come visualizzare Google Picker in una pagina.