Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Google Drive organizza i file in raccolte, li descrive per tipo e
fornisce attributi specifici per ciascun file per facilitarne la manipolazione.
L'API Google Drive rappresenta i file archiviati su Drive come risorsa
files.
Proprietà
Drive organizza i file in base al rapporto dell'utente con i contenuti e alla loro posizione di archiviazione. Le raccolte vengono specificate come parte dei metadati del file per mostrare con quale gruppo di file viene archiviato il file in Drive. La differenza principale tra Il mio Drive e
le raccolte dei Drive condivisi è la proprietà dei file. Un singolo utente è il proprietario dei file
nel proprio Drive, mentre un gruppo o un'organizzazione è proprietario dei file
in un Drive condiviso.
Il mio Drive
Ogni utente ha una cartella "radice" chiamata "Il mio
Drive", che funge da gerarchia principale e
contiene tutto ciò che deriva da questa cartella radice. L'utente è il
proprietario principale di questa cartella.
Drive condivisi
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 dai 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 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. Per saperne di più,
vedi Creare e compilare cartelle.
Nota: un singolo file archiviato su 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, come Documenti, Fogli o Presentazioni Google. Il formato del tipo MIME è
application/vnd.google-apps.*app*, dove app è il nome dell'applicazione
(ad esempio application/vnd.google-apps.spreadsheet per un
file Fogli). Per un elenco dei tipi MIME specifici di Drive e
Google Workspace, vedi Tipi MIME supportati da Google Workspace e
Google Drive.
Scorciatoia
Un file solo di metadati che rimanda a un altro file su Drive. Il tipo MIME del file
di scorciatoia è application/vnd.google-apps.shortcut. Per saperne di più, vedi Creare una scorciatoia a un file di Drive.
Scorciatoia di terze parti
Un file solo 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, vedi Creare un file di scorciatoia ai contenuti archiviati dalla tua app.
Caratteristiche del file
Questo elenco mostra alcune caratteristiche di un file di Drive:
Il corpo binario o di testo del file. Alcuni esempi di contenuti che puoi archiviare in
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, contenitore principale, proprietario o altri metadati.
Metadati
Dati che descrivono i contenuti del file. Questi dati includono nome, tipo,
creazione e orari di modifica. Alcuni campi dei metadati, come name,
sono indipendenti dall'utente e vengono visualizzati allo stesso modo per ogni utente. Altri campi, come
capabilities e viewedByMeDate, contengono valori specifici per l'utente. I tipi di file, come immagini e video, contengono metadati aggiuntivi estratti da EXIF e altri metadati incorporati. Per saperne di più, vedi Gestire i metadati dei file.
Autorizzazione
Una concessione di accesso per un utente, un gruppo, un dominio o il 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 dell'accesso (ACL), che è un elenco di autorizzazioni per il file. Per maggiori
informazioni, vedi Condividere file, cartelle e
unità.
Cronologia delle revisioni
La registrazione delle modifiche solo ai contenuti del file, non ai metadati. Per
maggiori dettagli sulle revisioni, consulta Panoramica di modifiche e revisioni.
Miniatura
Una rappresentazione grafica di un file. Drive genera automaticamente
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
in miniatura. Per saperne di più, consulta Caricare miniature.
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
e appDataFolder.
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 spazio drive.
appDataFolder: include i dati delle applicazioni per utente. Le applicazioni
in genere archiviano file di configurazione e altri dati non destinati a essere
accessibili direttamente agli utenti.
I file non possono essere spostati tra spaces.
Corpora
Raccolte di file utilizzate per restringere l'ambito delle ricerche di file e cartelle. I
corpora per Drive sono: user, domain, drive e
allDrives.
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 da driveId.
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 i corpora allDrives con cautela, in quanto hanno un ambito ampio e possono influire sul rendimento. Se possibile, utilizza user o drive anziché
allDrives per una maggiore efficienza.
I file possono essere spostati liberamente tra corpora man mano che le autorizzazioni e la proprietà cambiano.
Argomenti correlati
Ecco alcuni passaggi successivi che puoi intraprendere:
[null,null,["Ultimo aggiornamento 2025-08-04 UTC."],[],[],null,["# Files and folders overview\n\nGoogle Drive organizes files in collections, describes files by types, and\nprovides specific attributes for each file to facilitate file manipulation.\n\nThe Google Drive API represents files stored on Drive as a\n[`files`](/workspace/drive/api/reference/rest/v3/files) resource.\n| **Note:** Folders are treated as a type of file. For more details about folders, see [File types](#types).\n\nOwnership\n---------\n\nDrive organizes files based on the user's relationship with the\ncontent and its storage location. *Collections* are specified as part of the\nfile's metadata to show which group of files the file is stored with inside\nDrive. The main difference between My Drive and\nshared drive collections is file ownership. A single user is the owner of files\nin their My Drive, whereas a group or organization owns files in\na shared drive.\n\n*My Drive*\n: Each user has a \"root\" folder called \"My\n Drive\" that functions as their primary hierarchy, and\n consists of everything that descends from this root folder. The user is the\n primary owner of this folder.\n\n*Shared drives*\n: A [shared drive](/workspace/drive/api/guides/about-shareddrives) is an\n organizational structure within Drive that lives parallel to\n My Drive. You can organize an individual file within a shared\n drive or My Drive, but not both. However, [Drive shortcuts](/workspace/drive/api/guides/shortcuts) can be used to\n point to files or folders from shared drives to My Drive, or\n the other way around.\n\nFile types\n----------\n\nDrive describes files by types. This list shows all available\nfile types:\n\n*Blob*\n: A file that contains text or binary content such as images, videos, and\n PDFs.\n\n*Folder*\n\n: A container you can use to organize other types of files on\n Drive. Folders are files that only contain metadata, and have\n the MIME type `application/vnd.google-apps.folder`. For more information,\n see [Create and populate folders](/workspace/drive/api/guides/folder).\n\n **Note:** A single file stored on My Drive can be in multiple\n folders. A single file stored on a [shared\n drive](/workspace/drive/api/guides/about-shareddrives) can only have one parent folder.\n\n*Google Workspace document*\n\n: A file that a Google Workspace application\n creates, such as Google Docs, Sheets, or\n Slides. The MIME type format is\n `application/vnd.google-apps.*app*` where *app* is the application name\n (such as `application/vnd.google-apps.spreadsheet` for a\n Sheets file). For a list of Drive and\n Google Workspace-specific MIME types, see [Google Workspace and\n Google Drive supported MIME types](/workspace/drive/api/guides/mime-types).\n\n*Shortcut*\n\n: A metadata-only file that points to another file on Drive. The\n shortcut file MIME type is `application/vnd.google-apps.shortcut`. For more\n information, see [Create a shortcut to a Drive\n file](/workspace/drive/api/guides/shortcuts).\n\n*Third-party shortcut*\n\n: A metadata-only file that links to content stored on a third-party storage\n system. The third-party shortcut file MIME type is\n `application/vnd.google-apps.drive-sdk`. For more information, see [Create a\n shortcut file to content stored by your\n app](/workspace/drive/api/guides/third-party-shortcuts).\n\n| **Note:** You cannot upload or download folders, Google Workspace documents, shortcuts, and third-party shortcuts to or from Drive. However, if they use compatible formats you can upload or export Google Workspace documents. For example, you can create a Docs document when you import a PDF. Similarly, you can export a Google Slides presentation as a Microsoft PowerPoint file.\n\nFile characteristics\n--------------------\n\nThis list shows some characteristics of a Drive file:\n\n*Access proposal*\n: A proposal from a requester to an approver to grant a recipient access to a\n Drive item. For more information, see [List and resolve\n pending access\n proposals](/workspace/drive/api/guides/manage-sharing#access-proposals).\n\n*Content*\n: The binary or text body of the file. Some content examples you can store in\n Drive are images, videos, text, and PDFs.\n\n*File ID*\n: A unique, opaque ID for each file. File IDs are stable throughout the life of\n the file, even if the file name changes. [Search\n expressions](/workspace/drive/api/guides/search-files) are used to locate files by name,\n type, content, parent container, owner, or other metadata.\n\n*Metadata*\n: Data describing the contents of the file. This data includes the name, type,\n creation, and modification times. Some metadata fields, such as the `name`,\n are user-agnostic and appear the same for each user. Other fields, such as\n `capabilities` and `viewedByMeDate` contain user-specific values. File\n types, such as images and videos, contain additional metadata extracted from\n EXIF and other embedded metadata. For more information, see [Manage file\n metadata](/workspace/drive/api/guides/file).\n\n*Permission*\n: An access grant for a user, group, domain, or the world to access a file or a\n folder hierarchy. Users control who can access a file with the access\n control list (ACL), which is a list of permissions for the file. For more\n information, see [Share files, folders and\n drives](/workspace/drive/api/guides/manage-sharing).\n\n*Revision history*\n: The record of changes to the file content only, not the file metadata. For\n more details about revisions, see [Changes and revisions overview](/workspace/drive/api/guides/change-overview).\n\n*Thumbnail*\n: A graphical representation of a file. Drive automatically\n generates thumbnails for many common file types. For shortcuts and other\n file types that Drive can't render, you can provide a\n thumbnail image. For more information, see [Upload thumbnails](/workspace/drive/api/guides/file#upload-thumbnails).\n\nFile organization\n-----------------\n\nThe Drive API organizes files into storage locations, called `spaces`,\nand collections, called `corpora`.\n\n*Spaces*\n\n: Specific storage locations that are isolated from each other. All content in\n Drive is stored in one of these two defined spaces: `drive`\n and `appDataFolder`.\n\n - `drive`: Includes all user-visible files created in\n Drive. PDFs, documents, Google Docs, shortcuts, and\n other content the user uploads is located in the `drive` space.\n\n - `appDataFolder`: Includes per-user application data. Applications\n typically store configuration files and other data not intended to be\n directly accessible by users.\n\n Files cannot move between `spaces`.\n\n*Corpora*\n\n: Collections of files used to narrow the scope of file and folder searches. The\n corpora for Drive are: `user`, `domain`, `drive`, and\n `allDrives`.\n\n - `user`: Includes all files created by and opened by the user in \"My\n Drive\", and those shared directly with the user in\n \"Shared with me.\"\n\n - `drive`: Includes all files contained in a single shared drive, as\n indicated by the `driveId`.\n\n - `domain`: Includes all searchable files shared with the user's domain.\n\n - `allDrives`: Includes all files in shared drives where the user is a\n member, and all files in \"My Drive\" and \"Shared with me.\"\n Use the `allDrives` corpora with caution as it has a broad scope and can\n affect performance. When possible, use `user` or `drive` instead of\n `allDrives` for efficiency.\n\n Files can move freely between `corpora` as permissions and ownership change.\n\nRelated topics\n--------------\n\nHere are a few next steps you might take:\n\n- Learn how to [Create and manage files](/workspace/drive/api/guides/create-file).\n- Learn how to [Create and populate folders](/workspace/drive/api/guides/folder).\n- Learn how to [Upload file data](/workspace/drive/api/guides/manage-uploads).\n- Learn how to [Download and export files](/workspace/drive/api/guides/manage-downloads).\n- Learn how to [Store application-specific data](/workspace/drive/api/guides/appdata).\n- Learn how to [Display the Google Picker](/workspace/drive/api/guides/picker) on a page."]]
