Panoramica delle etichette
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Le etichette sono metadati che definisci per aiutare gli utenti a organizzare, trovare e applicare
criteri ai file in Google Drive. L'API Drive consente agli sviluppatori di
applicare etichette a file e cartelle, impostare i valori dei campi delle etichette, leggere le etichette e i valori dei campi
sui file e cercare i file utilizzando i termini dei metadati definiti dalla tassonomia delle etichette personalizzate.
Le etichette di Drive possono supportare i processi aziendali allegando metadati
a file e cartelle. Gli utilizzi comuni delle etichette sono:
Classificare i contenuti per seguire una strategia di governance delle informazioni: crea un'etichetta per identificare contenuti sensibili o dati che richiedono una gestione speciale.
Ad esempio, potresti creare un'etichetta con badge (un'etichetta con valori di opzione codificati a colori) intitolata "Sensibilità" con i valori "Top Secret", "Riservato" e "Pubblico".
Applica criteri agli elementi in Drive: crea etichette per gestire
i contenuti di Drive durante tutto il ciclo di vita e assicurati che rispettino
le prassi di conservazione dei record della tua organizzazione. Ad esempio, utilizza le etichette per
gestire un criterio di prevenzione della perdita di dati (DLP) in base al quale gli utenti non possono scaricare file con un'etichetta
"Sensibilità" impostata su "Top Secret".
Selezionare e trovare i file: crea etichette per aumentare la ricercabilità dei contenuti della tua azienda consentendo alle persone della tua organizzazione di trovare elementi in base alle etichette e ai relativi campi. Ad esempio, applica un insieme di etichette "Stato della firma"
con il valore "In attesa di firma" a tutti i contratti in attesa di firma entro una data
specifica. La ricerca di Drive può quindi restituire questi contratti quando
qualcuno cerca "in attesa di firma".
Di seguito è riportato un elenco dei termini comuni utilizzati dalle etichette di Drive:
- Etichetta
Metadati strutturati inseriti in un file di Drive.
Gli utenti di Drive possono assegnare etichette e impostare i valori dei campi delle etichette per i file. Le etichette sono composte da:
- Nome etichetta
- Il nome della risorsa dell'etichetta. L'ID etichetta fa parte del
nome dell'etichetta. A seconda della richiesta, il nome è nel formato:
labels/{id} o labels/{id}@{revisionId}. Per ulteriori informazioni, vedi
Revisione delle etichette di seguito.
- ID etichetta
- Un identificatore univoco globale per l'etichetta. L'ID fa parte del
nome dell'etichetta, ma a differenza del nome, è coerente tra le revisioni.
- Campo
Un componente digitato e impostabile di un'etichetta. Un'etichetta può avere zero o
più campi associati. I campi di selezione e utente possono essere impostati con
più valori se il campo è configurato con
ListOptions nell'API Google Drive Labels.
- Tipo di campo
- Il tipo di dati del valore associato al campo. Configurabile come
numero intero, stringa di data, testo, utente o selezione. Il tipo scelto influisce sia sui valori validi applicabili agli elementi di Drive sia sulle opzioni di query di ricerca disponibili.
- Tassonomia delle etichette
I campi delle etichette configurati disponibili per gli utenti per l'applicazione ai
file di Drive. Leggibili e scrivibili tramite l'API Drive Labels. Noto anche come schema delle etichette.
- Revisione dell'etichetta
Un'istanza dell'etichetta. Ogni volta che un'etichetta viene creata, aggiornata, pubblicata o
ritirata, la revisione dell'etichetta aumenta.
- Revisione bozza
- Il numero di revisione dell'istanza bozza corrente dell'etichetta. Puoi
apportare diversi aggiornamenti a un'etichetta, ognuno dei quali incrementa il numero di revisione della bozza, senza influire sulla revisione pubblicata. La possibilità di avere
etichette bozza ti consente di testare gli aggiornamenti delle etichette prima della pubblicazione.
- Revisione pubblicata
- Il numero di revisione della versione pubblicata di un'etichetta. L'etichetta pubblicata
è l'istanza dell'etichetta disponibile per gli utenti.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-04 UTC.
[null,null,["Ultimo aggiornamento 2025-08-04 UTC."],[],[],null,["# Labels overview\n\n*Labels* are metadata that you define to help users organize, find, and apply\npolicy to files in Google Drive. The Drive API allows developers to\napply labels to files and folders, set label field values, read labels and field\nvalues on files, and search for files using metadata terms defined by the custom\nlabel taxonomy.\n\nDrive labels can support business processes by attaching metadata\nto files and folders. Common uses for labels are:\n\n- **Classify content to follow an information governance strategy**---Create a\n label to identify sensitive content or data that requires special handling.\n For example, you might create a badged label (a label with color-coded\n option values) titled \"Sensitivity\" with the values of \"Top Secret,\"\n \"Confidential,\" and \"Public.\"\n\n- **Apply policy to items in Drive**---Create labels to manage\n Drive content throughout its lifecycle and ensure it adheres\n to your organization's record keeping practices. For example, use labels to\n manage a data loss policy (DLP) whereby users can't download files with a\n \"Sensitivity\" label set to \"Top Secret\".\n\n- **Curate and find files**---Create labels to increase searchability of your\n company's content by letting people in your organization find items based on\n labels and their fields. For example, apply a \"Signature Status\" label set\n to \"Awaiting Signature\" to all contracts awaiting signature by a specific\n date. Drive search can then return these contracts when\n someone searches \"awaiting signature\".\n\nBelow is a list of common terms used by Drive labels:\n\n*Label*\n\n: Structured metadata placed on a Drive file.\n Drive users can assign labels and set label field values\n for files. Labels are composed of:\n\n *Label name*\n : The resource name of the label. The *label ID* is part of the\n Label name. Depending on the request, the name is in the form of either:\n `labels/{id}` or `labels/{id}@{revisionId}`. For more information, see\n [Label revision](#revision) below.\n\n *Label ID*\n : A globally unique identifier for the label. The ID is part of the\n label name, but unlike the name, it's consistent between revisions.\n\n*Field*\n\n: An individual typed, settable component of a label. A label can have zero or\n more fields associated with it. Selection and user fields can be set with\n multiple values if the field is configured with\n [`ListOptions`](/workspace/drive/labels/reference/rest/v2/labels#listoptions) in the\n [Google Drive Labels API](/workspace/drive/labels/guides/overview).\n\n *Field type*\n : The data type of the value associated with the *field*. Configurable as\n integer, dateString, text, user, or selection. The type chosen impacts\n both the valid values applicable to Drive items and the\n search query options available.\n\n*Label taxonomy*\n\n: The configured label fields available to users for application to\n Drive files. Readable and writable through the\n Drive Labels API. Also known as the label schema.\n\n*Label revision*\n\n: An instance of the label. Anytime a label is created, updated, published, or\n deprecated, the label revision increments.\n\n *Draft revision*\n : The revision number of the current draft instance of the label. You can\n make several updates to a label, each incrementing its draft revision\n number, without affecting the published revision. The ability to have\n draft labels lets you test label updates before publishing.\n\n *Published revision*\n : The revision number of the published version of a label. The published\n label is the instance of the label available to users.\n\nRelated topics\n--------------\n\n- To learn about using labels in Drive, see [Set a label field\n on a file](/workspace/drive/api/guides/set-label).\n- Learn more about the [Drive Labels API](/workspace/drive/labels/guides/overview)."]]
