Le etichette sono metadati che definisci per aiutare gli utenti a organizzare, trovare e applicare ai file su Google Drive. L'API Drive Etichette è un'API RESTful che supporta i processi aziendali allegando metadati a Drive . Gli utilizzi comuni di questa API sono:
Classificare i contenuti per seguire una strategia di governance delle informazioni: crea una per identificare contenuti o dati sensibili che richiedono una gestione speciale. Ad esempio, puoi creare un'etichetta con badge (un'etichetta codificata per colore valori dell'opzione) con titolo "Sensibilità" con il valore "Top Secret", "Riservato", e "Pubblico".
Applica i criteri agli elementi su Drive: crea etichette da gestire Promuovi i contenuti durante tutto il loro ciclo di vita e assicurati che siano conformi alle prassi di conservazione dei registri della tua organizzazione. Ad esempio, utilizza le etichette per Gestire un criterio di perdita di dati (DLP), in base al quale i file con livello di "Sensibilità" insieme di etichette su "Top Secret" non possono essere scaricati su un computer.
Seleziona e trova i file: crea etichette per aumentare la ricercabilità del tuo aziendali consentendo alle persone della tua organizzazione di trovare etichette e i relativi campi. Ad esempio, un utente della tua organizzazione potrebbe utilizzare Opzioni di ricerca di Drive per trovare tutti i contratti in attesa di firma entro una data specifica.
Di seguito è riportato un elenco dei termini comuni utilizzati nell'API Drive Etichette:
- Etichetta
Metadati strutturati posizionati in un file di Drive. Gli utenti di Drive possono assegnare etichette e impostare valori dei campi delle etichette per . Le etichette sono composte da:
- Nome etichetta
- Il nome della risorsa dell'etichetta. L'ID etichetta costituisce parte della
Nome etichetta. A seconda della richiesta, il nome può avere una delle seguenti forme:
labels/{id}
olabels/{id}@{revisionId}
. Per ulteriori informazioni, vedi Revisione delle etichette di seguito. - ID etichetta
- Un identificatore univoco globale per l'etichetta. L'ID costituisce parte del nome dell'etichetta, ma a differenza del nome, è coerente tra una revisione e l'altra.
Esistono due stili di etichette:
- Etichetta con badge
Un'etichetta con un
SelectionOptions
tipo di campo contenente opzioni che possono essere codificate per colore per indicare l'importanza. Per farlo, impostabadgeConfig
tramiteProperties
diChoice
Drive visualizza il colore dell'opzione scelta per ogni file in modo che gli utenti comprendere chiaramente lo stato, la classificazione e così via del file. Ad esempio, "Top Secret" per l'opzione "Sensibilità" etichetta con badge potrebbero essere visualizzati in rosso. Puoi avere una sola etichetta con badge alla volta.
- Etichetta standard
Un'etichetta contenente zero o più tipi di campo. Un'etichetta standard può titoli, ad esempio "Project Moonshot" e indicare tutti i file legati al progetto. Un'etichetta standard può avere anche diversi e campi strutturati. Ad esempio, un'etichetta con il titolo "Contratto" potrebbe contiene i campi "Company" (Azienda), "Data di scadenza" "Status" (Stato) e "Firmatari" Ogni campo è di un tipo specifico (testo, data, la selezione o l'utente).
|
|
- Campo
Un singolo componente digitato e impostabile di un'etichetta. Un'etichetta può avere zero o con più campi associati.
- Tipo di campo
- Il tipo di dati del valore associato al campo. Configurabile come
testo, numero intero, data, utente o selezione. Se configuri il campo con
ListOptions
, puoi impostare i campi utente e di selezione con più e i relativi valori. Il tipo scelto influisce su entrambi i valori validi applicabili a Elementi di Drive e opzioni di query di ricerca disponibili.
- Scelta
Una delle varie opzioni che un utente può scegliere all'interno di un
SelectionOptions
.- Tipo di etichetta
Tutte le etichette includono un
LabelType
. Esistono due tipi di etichette:- Amministratore
Per creare e modificare le etichette di proprietà dell'amministratore, devi essere un account con Gestisci etichette di accesso.
Gli amministratori possono condividere le etichette dell'amministratore con qualsiasi utente per concedergli l' di visualizzarle e applicarle agli elementi di Drive. Modifica o lettura i valori delle etichette negli elementi di Drive richiedono le seguenti autorizzazioni:
Modifica: l'utente può modificare i metadati degli elementi di Drive relativi a un data l'etichetta, l'utente deve disporre dei livelli di autorizzazione appropriati:
- Elemento di Drive:
EDITOR
- Etichetta:
APPLIER
- Elemento di Drive:
Lettura: consente a un utente di leggere o cercare i metadati degli elementi di Drive a una determinata etichetta, l'utente deve disporre della livelli di autorizzazione:
- Elemento di Drive:
READER
- Etichetta:
READER
- Elemento di Drive:
Gli utenti non amministratori possono creare etichette condivise che altri possono applicare agli elementi di Drive. I team possono creare e organizzare le etichette da usare all'interno del team senza richiedere l'intervento di un amministratore.
- Tassonomia delle etichette
I campi delle etichette attualmente configurati disponibili per gli utenti per l'applicazione File di Drive. Chiamato anche schema delle etichette.
Esempi di tassonomie di etichette:
- Sensibilità: rosso, arancione, giallo, verde
- Stato: non iniziato, bozza, in revisione, finale
- Tipo di contenuti: contratto, documento di design, simulazione
- Dipartimento – Marketing, Finanza, Risorse Umane, Vendite
- Ciclo di vita delle etichette
Le etichette attraversano un ciclo di vita in cui vengono create, pubblicate, aggiornate così via. Man mano che un'etichetta supera il ciclo di vita, la sua revisione dell'etichetta viene incrementato. Per saperne di più, consulta Ciclo di vita delle etichette.
- Revisione delle etichette
Un'istanza dell'etichetta. Ogni volta che un'etichetta viene creata, aggiornata, pubblicata deprecata, la revisione delle etichette viene incrementata.
- Revisione della bozza
- Il numero di revisione dell'istanza bozza attuale dell'etichetta. Puoi apporta diversi aggiornamenti a un'etichetta, ognuno dei quali incrementa la revisione della bozza senza influire sulla revisione pubblicata. La possibilità di avere le bozze delle etichette consentono di testare gli aggiornamenti delle etichette prima della pubblicazione.
- Revisione pubblicata
- Il numero di revisione della versione pubblicata di un'etichetta. L'elemento pubblicato l'etichetta è l'istanza dell'etichetta attualmente disponibile per gli utenti.
Argomenti correlati
Per saperne di più sullo sviluppo con le API Google Workspace, inclusa la gestione l'autenticazione e l'autorizzazione, consulta l'articolo Iniziare come Google Workspace sviluppatore.
Per scoprire come configurare ed eseguire una semplice app con API Etichette, prova la guida rapida di Python.