Panoramica dell'API Drive Labels

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 metadati ai file di Drive. Gli utilizzi comuni di questa API sono:

  • Classificare i contenuti per seguire una strategia di governance delle informazioni: crea un'etichetta per identificare contenuti o dati sensibili che richiedono una gestione speciale. Ad esempio, potresti creare un'etichetta con badge (un'etichetta con valori di opzioni codificati a colori) denominata "Sensibilità" con i valori "Segretissimo", "Riservato" e "Pubblico".

  • Applicare criteri agli elementi di Drive: crea etichette per gestire i contenuti di Drive durante tutto il loro 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 i file con un'etichetta"Sensibilità " impostata su"Top Secret" non possono essere scaricati su un computer.

  • Seleziona e trova 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 relativi campi. Ad esempio, un utente della 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 di 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 i valori dei campi delle etichette per i file. Le etichette sono composte da:

Nome dell'etichetta
Il nome della risorsa dell'etichetta. L'ID etichetta fa parte del nome dell'etichetta. A seconda della richiesta, il nome ha il seguente formato: labels/{id} o labels/{id}@{revisionId}. Per ulteriori informazioni, consulta la sezione 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.

Esistono due stili di etichette:

Etichetta con badge

Un'etichetta con un tipo di campo SelectionOptions contenente scelte che possono essere codificate in base al colore per indicare l'importanza. Per farlo, imposta badgeConfig tramite il Properties di un Choice.

Drive mostra il colore dell'opzione scelta per ogni file in modo che gli utenti possano comprendere 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, ad esempio "Progetto Moonshot", e indicare tutti i file correlati 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 "Firmatari". Ogni campo è di un tipo specifico (testo, data, selezione o utente).

Diagramma di un'etichetta con badge.
Figura 1. Etichetta con badge
Diagramma di etichette standard.
Figura 2. Etichetta standard
Campo

Un singolo componente di un'etichetta impostabile e di tipo. 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 di query di ricerca disponibili.
Choice

Una delle diverse opzioni che un utente può scegliere all'interno di un SelectionOptions campo.

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 amministratore dell'account con il privilegio Gestisci etichette.

Gli amministratori possono condividere le etichette di amministrazione con qualsiasi utente per concedergli la possibilità di visualizzarle e applicarle agli elementi di Drive. La modifica o la lettura degli attributi delle etichette degli elementi di Drive richiede le seguenti autorizzazioni:

  • Modifica: per modificare i metadati degli elementi di Drive relativi a una determinata etichetta, l'utente deve disporre dei livelli di autorizzazione appropriati:

    • Elemento di Drive: EDITOR
    • Etichetta: APPLIER

  • Lettura: per leggere o cercare i metadati degli elementi di Drive correlati a una determinata etichetta, l'utente deve disporre dei livelli di autorizzazione appropriati:

    • Elemento di Drive: READER
    • Etichetta: READER
Condiviso

Gli utenti non amministratori possono creare etichette condivise che altri possono applicare agli elementi di Drive. I team possono creare e organizzare le proprie etichette per l'utilizzo all'interno del team senza richiedere 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.

Esempi di tassonomie di etichette:

  • Sensibilità: rosso, arancione, giallo, verde
  • Stato: Non iniziato, Bozza, In revisione, Finale
  • Tipo di contenuti: Contratto, Documento di progettazione, Simulazione
  • 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 completa il ciclo di vita, la relativa revisione dell'etichetta viene incrementata. Per ulteriori informazioni, consulta la sezione Ciclo di vita delle etichette.

Revisione delle etichette

Un'istanza dell'etichetta. Ogni volta che un'etichetta viene creata, aggiornata, pubblicata o ritirata, la revisione dell'etichetta viene incrementata.

Revisione della bozza
Il numero di revisione dell'istanza di bozza corrente dell'etichetta. Puoi apportare diversi aggiornamenti a un'etichetta, incrementando ogni volta il numero della revisione della bozza, senza influire sulla revisione pubblicata. La possibilità di avere etichette in 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 attualmente disponibile per gli utenti.