Le etichette sono metadati che definisci per aiutare gli utenti a organizzare, trovare e applicare criteri ai file su Google Drive. L'API Drive Labels è un'API RESTful che supporta i processi aziendali allegando i metadati ai tuoi file di Drive. Gli utilizzi comuni di questa API sono:
Classifica i contenuti in base a 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 per colore) chiamata "Sensibilità" con i valori "Top Secret", "Riservato" e "Pubblico".
Applica criteri agli elementi di Drive: crea etichette per gestire i contenuti di Drive durante tutto il loro ciclo di vita e assicurarti che rispettino le prassi di conservazione dei record della tua organizzazione. Ad esempio, puoi utilizzare le etichette per gestire un criterio di perdita di dati (DLP), in base al quale i file con un'etichetta"Sensibilità " impostata su"Top Secret" non possono essere scaricati su un computer.
Selezionare e trovare i file: crea etichette per aumentare la ricercabilità dei contenuti della tua azienda consentendo alle persone della tua organizzazione di trovare gli elementi in base alle etichette e ai campi corrispondenti. Ad esempio, qualcuno nella tua organizzazione potrebbe utilizzare le 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 Labels:
- Etichetta
Metadati strutturati inseriti in un file di Drive. Gli utenti di Drive possono assegnare etichette e impostare valori per i campi delle etichette per i file. Le etichette sono composte da:
- Nome etichetta
- Il nome della risorsa dell'etichetta. L'ID etichetta costituisce parte del nome dell'etichetta. A seconda della richiesta, il nome sarà nel formato
labels/{id}
olabels/{id}@{revisionId}
. Per ulteriori informazioni, consulta la sezione Revisione delle etichette di seguito. - ID etichetta
- Un identificatore univoco a livello globale per l'etichetta. L'ID fa parte del nome dell'etichetta, ma a differenza del nome, è coerente tra le revisioni.
Esistono due stili di etichette:
- Etichetta con badge
Un'etichetta con un tipo di campo
SelectionOptions
contenente scelte che possono essere codificate per colore per indicare l'importanza. Per farlo, impostabadgeConfig
tramiteProperties
diChoice
.Drive mostra il colore dell'opzione scelta per ciascun file, in modo che gli utenti comprendano chiaramente lo stato, la classificazione e così via del file. Ad esempio, l'opzione "Top Secret" per l'etichetta con badge "Sensibilità" potrebbe essere visualizzata 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 potrebbe avere un titolo di etichetta, ad esempio "Progetto Moonshot", e indicare tutti i file relativi al progetto. Un'etichetta standard può anche avere diversi campi strutturati. Ad esempio, un'etichetta con il titolo "Contratto" potrebbe contenere i campi "Azienda", "Data di scadenza", "Stato" e "Firmatori". Ogni campo è di un tipo specifico (testo, data, selezione o utente).
- Campo
Singolo componente configurabile di un'etichetta. A un'etichetta possono essere associati zero o più campi.
- 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ù valori. Il tipo scelto influisce sia sui valori validi applicabili agli elementi di Drive sia sulle opzioni delle query di ricerca disponibili.
- Scelta
Una delle diverse opzioni che un utente può scegliere all'interno di un campo
SelectionOptions
.- Tipo di etichetta
Tutte le etichette includono un
LabelType
. Esistono due tipi di etichette:- Amministratore
Per creare e modificare etichette di proprietà dell'amministratore, devi essere un amministratore di account con il privilegio Gestione etichette.
Gli amministratori possono condividere le etichette amministratore con qualsiasi utente per concedergli la possibilità di visualizzarle e applicarle agli elementi di Drive. La modifica o la lettura dei valori delle etichette negli elementi di Drive richiede le seguenti autorizzazioni:
Modifica: affinché un utente possa modificare i metadati degli elementi di Drive relativi a una data etichetta, deve disporre dei livelli di autorizzazione appropriati:
- Elemento di Drive:
EDITOR
- Etichetta:
APPLIER
- Elemento di Drive:
Lettura: affinché un utente possa leggere o cercare i metadati degli elementi di Drive relativi a una determinata etichetta, deve disporre dei livelli di autorizzazione appropriati:
- Elemento di Drive:
READER
- Etichetta:
READER
- Elemento di Drive:
Gli utenti non amministratori possono creare etichette condivise che altri utenti possono applicare a elementi di Drive. I team possono creare e organizzare le proprie etichette da usare all'interno del team senza la necessità di un amministratore.
- Tassonomia delle etichette
I campi delle etichette attualmente configurati disponibili per gli utenti per l'applicazione ai file di Drive. Chiamato anche schema delle etichette,
Esempio di tassonomie di etichette:
- Sensibilità: rosso, arancione, giallo, verde
- Stato: Non avviato, Bozza, In revisione, Finale
- Tipo di contenuti: contratto, documento di progettazione, modello
- Reparto: marketing, finanza, risorse umane, vendite
- Ciclo di vita delle etichette
Le etichette attraversano un ciclo di vita in cui vengono create, pubblicate, aggiornate e così via. Man mano che un'etichetta percorre il ciclo di vita, la revisione dell'etichetta viene incrementata. Per saperne di più, vedi Ciclo di vita delle etichette.
- Revisione delle etichette
Un'istanza dell'etichetta. Ogni volta che un'etichetta viene creata, aggiornata, pubblicata o deprecata, la sua revisione viene incrementata.
- Revisione della bozza
- Il numero di revisione dell'istanza di 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 definire le bozze delle etichette 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 attualmente disponibile per gli utenti.
Argomenti correlati
Per saperne di più sullo sviluppo con le API Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Iniziare come sviluppatore di Google Workspace.
Per scoprire come configurare ed eseguire una semplice app dell'API Labels, prova la guida rapida di Python.