REST Resource: labels

Risorsa: etichetta

Un'etichetta definisce una tassonomia che può essere applicata agli elementi di Drive per organizzarli e cercarli. Le etichette possono essere semplici stringhe o contenere campi che descrivono metadati aggiuntivi che possono essere ulteriormente utilizzati per organizzare e cercare gli elementi di Drive.

Rappresentazione JSON 
{
  "name": string,
  "id": string,
  "revisionId": string,
  "labelType": enum (LabelType),
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "revisionCreator": {
    object (UserInfo)
  },
  "revisionCreateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "publishTime": string,
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "customer": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedLabelPolicy": {
    object (AppliedLabelPolicy)
  },
  "fields": [
    {
      object (Field)
    }
  ],
  "learnMoreUri": string,
  "lockStatus": {
    object (LockStatus)
  },
  "enabledAppSettings": {
    object (EnabledAppSettings)
  }
}
Campi
name

string

Solo output. Nome della risorsa dell'etichetta. Sarà nel formato labels/{id} o labels/{id}@{revisionId} a seconda della richiesta. Vedi id e revisionId di seguito.
id

string

Solo output. Identificatore univoco a livello globale di questa etichetta. L'ID fa parte dell'etichetta name, ma, a differenza di name, è coerente tra le revisioni. Corrisponde all'espressione regolare: ([a-zA-Z0-9])+
revisionId

string

Solo output. ID revisione dell'etichetta. L'ID revisione potrebbe essere incluso nell'etichetta name a seconda della richiesta inviata. Ogni volta che le proprietà sottoposte a revisione di un'etichetta vengono modificate, viene creata una nuova revisione. Corrisponde all'espressione regolare: ([a-zA-Z0-9])+
labelType

enum (LabelType)

Obbligatorio. Il tipo di etichetta.
creator

object (UserInfo)

Solo output. L'utente che ha creato questa etichetta.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stata creata l'etichetta.
revisionCreator

object (UserInfo)

Solo output. L'utente che ha creato questa revisione dell'etichetta.
revisionCreateTime

string (Timestamp format)

Solo output. L'ora in cui è stata creata questa revisione dell'etichetta.
publisher

object (UserInfo)

Solo output. L'utente che ha pubblicato questa etichetta. Questo valore non ha significato quando l'etichetta non è pubblicata.
publishTime

string (Timestamp format)

Solo output. L'ora in cui è stata pubblicata questa etichetta. Questo valore non ha significato quando l'etichetta non è pubblicata.
disabler

object (UserInfo)

Solo output. L'utente che ha disattivato questa etichetta. Questo valore non ha significato se l'etichetta non è disattivata.
disableTime

string (Timestamp format)

Solo output. La data e l'ora in cui l'etichetta è stata disattivata. Questo valore non ha significato se l'etichetta non è disattivata.
customer

string

Solo output. Il cliente a cui appartiene l'etichetta. Ad esempio: "customers/123abc789".
properties

object (Properties)

Obbligatorio. Le proprietà di base dell'etichetta.
lifecycle

object (Lifecycle)

Solo output. Lo stato del ciclo di vita dell'etichetta, ad esempio se è pubblicata, ritirata e se contiene modifiche in bozza.
displayHints

object (DisplayHints)

Solo output. La UI mostra suggerimenti per il rendering dell'etichetta.
appliedCapabilities

object (AppliedCapabilities)

Solo output. Le funzionalità correlate a questa etichetta nei metadati applicati.
schemaCapabilities

object (SchemaCapabilities)

Solo output. Le funzionalità di cui dispone l'utente in questa etichetta.
appliedLabelPolicy

object (AppliedLabelPolicy)

Solo output. Il comportamento di questa etichetta quando viene applicata agli elementi di Drive.
fields[]

object (Field)

Elenco dei campi in ordine decrescente di priorità.
learnMoreUri

string

URL personalizzato da presentare agli utenti per consentirgli di scoprire di più su questa etichetta e su come deve essere utilizzata.
lockStatus

object (LockStatus)

Solo output. Lo stato di blocco di questa etichetta.
enabledAppSettings

object (EnabledAppSettings)

Facoltativo. Le impostazioni EnabledApp per questa etichetta.

LabelType

Il tipo di etichetta.

Enum
LABEL_TYPE_UNSPECIFIED Tipo di etichetta sconosciuto.
SHARED Le etichette condivise possono essere condivise con gli utenti per essere applicate agli elementi di Drive.
ADMIN Etichetta di proprietà dell'amministratore. Creabili e modificabili solo dagli amministratori. Supporta alcune funzionalità aggiuntive solo per gli amministratori.
GOOGLE_APP Un'etichetta di proprietà di un'applicazione Google interna anziché di un cliente. Queste etichette sono di sola lettura.

UserInfo

Informazioni su un utente.

Rappresentazione JSON 
{
  "person": string
}
Campi
person

string

L'identificatore di questo utente che può essere utilizzato con l'API People per ottenere ulteriori informazioni. Ad esempio, people/12345678.

Proprietà

Proprietà di base dell'etichetta.

Rappresentazione JSON 
{
  "title": string,
  "description": string
}
Campi
title

string

Obbligatorio. Titolo dell'etichetta.
description

string

La descrizione dell'etichetta.

Lifecycle

Lo stato del ciclo di vita di un oggetto, ad esempio etichetta, campo o scelta. Il ciclo di vita applica le seguenti transizioni:

  • UNPUBLISHED_DRAFT (stato iniziale)
  • UNPUBLISHED_DRAFT -> PUBLISHED
  • UNPUBLISHED_DRAFT -> (Deleted)
  • PUBLISHED -> DISABLED
  • DISABLED -> PUBLISHED
  • DISABLED -> (Deleted)

Gli stati Pubblicato e Disattivato presentano alcune caratteristiche distinte:

  • Pubblicato: in questo stato è possibile apportare alcuni tipi di modifiche a un oggetto, nel qual caso hasUnpublishedChanges sarà true. Inoltre, alcuni tipi di modifiche non sono consentiti. In genere, qualsiasi modifica che invalidi o causi nuove limitazioni ai metadati esistenti relativi all'etichetta viene rifiutata.
  • Disattivata: se questa opzione è disattivata, viene applicato il valore DisabledPolicy configurato.
Rappresentazione JSON 
{
  "state": enum (State),
  "hasUnpublishedChanges": boolean,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
Campi
state

enum (State)

Solo output. Lo stato dell'oggetto associato a questo ciclo di vita.
hasUnpublishedChanges

boolean

Solo output. Indica se l'oggetto associato a questo ciclo di vita contiene modifiche non pubblicate.
disabledPolicy

object (DisabledPolicy)

Il criterio che regola la modalità di visualizzazione di un'etichetta, un campo o una scelta di selezione disattivati.

Stato

Lo stato dell'oggetto associato a questo ciclo di vita.

Enum
STATE_UNSPECIFIED Stato sconosciuto.
UNPUBLISHED_DRAFT Lo stato iniziale di un oggetto. Una volta pubblicato, l'oggetto non può più tornare in questo stato. Una volta pubblicato un oggetto, alcuni tipi di modifiche non sono più consentiti.
PUBLISHED L'oggetto è stato pubblicato. L'oggetto potrebbe contenere modifiche non pubblicate in bozza, come indicato da hasUnpublishedChanges.
DISABLED L'oggetto è stato pubblicato e da allora è stato disattivato. L'oggetto potrebbe contenere modifiche non pubblicate in bozza, come indicato da hasUnpublishedChanges.
DELETED L'oggetto è stato eliminato.

DisabledPolicy

Il criterio che regola il trattamento di un'etichetta, un campo o una scelta di selezione disattivati in contesti diversi.

Rappresentazione JSON 
{
  "hideInSearch": boolean,
  "showInApply": boolean
}
Campi
showInApply

boolean

Indica se mostrare questo oggetto disattivato nel menu Applica sugli elementi di Drive.

  • Quando è true, l'oggetto viene generalmente mostrato nell'interfaccia utente come disattivato e non è selezionabile.
  • Quando è false, l'oggetto è generalmente nascosto nell'interfaccia utente.

DisplayHints

La UI mostra suggerimenti per il rendering dell'etichetta.

Rappresentazione JSON 
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "priority": string
}
Campi
disabled

boolean

Indica se l'etichetta deve essere mostrata nell'interfaccia utente come disattivata.
shownInApply

boolean

Questa etichetta dovrebbe essere visualizzata nel menu di applicazione quando si applicano valori a un elemento di Drive.
priority

string (int64 format)

Ordine per visualizzare l'etichetta in un elenco.

AppliedCapabilities

Le funzionalità di cui dispone un utente sui metadati applicati a questa etichetta.

Rappresentazione JSON 
{
  "canRead": boolean,
  "canApply": boolean,
  "canRemove": boolean
}
Campi
canRead

boolean

Indica se l'utente può leggere i metadati applicati relativi a questa etichetta.
canApply

boolean

Indica se l'utente può applicare questa etichetta agli articoli.
canRemove

boolean

Indica se l'utente può rimuovere questa etichetta dagli elementi.

SchemaCapabilities

Le funzionalità correlate a questa etichetta durante la modifica.

Rappresentazione JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Campi
canUpdate

boolean

Indica se l'utente può modificare questa etichetta.
canDelete

boolean

Indica se l'utente può eliminare questa etichetta. L'utente deve disporre dell'autorizzazione e l'etichetta deve essere disattivata.
canDisable

boolean

Indica se l'utente può disattivare questa etichetta. L'utente deve disporre dell'autorizzazione e questa etichetta non deve essere già disattivata.
canEnable

boolean

Indica se l'utente può attivare questa etichetta. L'utente deve disporre dell'autorizzazione e questa etichetta deve essere disattivata.

AppliedLabelPolicy

Il comportamento di questa etichetta quando viene applicata agli elementi di Drive.

Rappresentazione JSON 
{
  "copyMode": enum (CopyMode)
}
Campi
copyMode

enum (CopyMode)

Indica come devono essere copiati i valori dell'etichetta e dei campi applicati quando viene copiato un elemento di Drive.

CopyMode

Indica come devono essere copiati i valori dell'etichetta e dei campi applicati quando viene copiato un elemento di Drive.

Enum
COPY_MODE_UNSPECIFIED Modalità di copia non specificata.
DO_NOT_COPY Per impostazione predefinita, i valori dell'etichetta e del campo applicati non vengono copiati quando viene copiato l'elemento di Drive a cui sono applicati.
ALWAYS_COPY L'etichetta e i valori dei campi applicati vengono sempre copiati quando viene copiato l'elemento di Drive a cui sono applicati. Solo gli amministratori possono utilizzare questa modalità.
COPY_APPLIABLE L'etichetta e i valori dei campi applicati vengono copiati se l'etichetta è applicabile dall'utente che esegue la copia.

Campo

Definisce un campo con un nome visualizzato, un tipo di dati e altre opzioni di configurazione. Questo campo definisce il tipo di metadati che possono essere impostati su un elemento di Drive.

Rappresentazione JSON 
{
  "id": string,
  "queryKey": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "updater": {
    object (UserInfo)
  },
  "updateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "lockStatus": {
    object (LockStatus)
  },

  // Union field type can be only one of the following:
  "textOptions": {
    object (TextOptions)
  },
  "integerOptions": {
    object (IntegerOptions)
  },
  "dateOptions": {
    object (DateOptions)
  },
  "selectionOptions": {
    object (SelectionOptions)
  },
  "userOptions": {
    object (UserOptions)
  }
  // End of list of possible types for union field type.
}
Campi
id

string

Solo output. La chiave di un campo, univoca all'interno di un'etichetta o di una raccolta.

Questo valore viene generato automaticamente. Corrisponde all'espressione regolare: ([a-zA-Z0-9])+
queryKey

string

Solo output. La chiave da utilizzare per creare query di ricerca di Drive per trovare i file in base ai valori definiti per questo campo nei file. Ad esempio, "{queryKey} > 01-01-2001".
properties

object (Properties)

Le proprietà di base del campo.
lifecycle

object (Lifecycle)

Solo output. Il ciclo di vita di questo campo.
displayHints

object (DisplayHints)

Solo output. Suggerimenti di visualizzazione dell'interfaccia utente per il rendering di un campo.
schemaCapabilities

object (SchemaCapabilities)

Solo output. Le funzionalità di questo utente durante la modifica di questo campo.
appliedCapabilities

object (AppliedCapabilities)

Solo output. Le funzionalità di questo utente per questo campo e il relativo valore quando l'etichetta viene applicata agli elementi di Drive.
creator

object (UserInfo)

Solo output. L'utente che ha creato questo campo.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato questo campo.
updater

object (UserInfo)

Solo output. L'utente che ha modificato questo campo.
updateTime

string (Timestamp format)

Solo output. L'ora in cui questo campo è stato aggiornato.
publisher

object (UserInfo)

Solo output. L'utente che ha pubblicato questo campo. Questo valore non ha significato quando il campo non è pubblicato.
disabler

object (UserInfo)

Solo output. L'utente che ha disattivato questo campo. Questo valore non ha significato se il campo non è disabilitato.
disableTime

string (Timestamp format)

Solo output. La data e l'ora in cui questo campo è stato disattivato. Questo valore non ha significato se il campo non è disabilitato.
lockStatus

object (LockStatus)

Solo output. Il valore LockStatus di questo campo.
Campo unione type. Il tipo di dati e le opzioni di questo campo. Una volta pubblicato, il tipo di dati non può essere modificato. type può essere solo uno dei seguenti:
textOptions

object (TextOptions)

Opzioni per i campi di testo.
integerOptions

object (IntegerOptions)

Opzioni per i campi di tipo intero.
dateOptions

object (DateOptions)

Opzioni per i campi della data.
selectionOptions

object (SelectionOptions)

Opzioni del campo di selezione.
userOptions

object (UserOptions)

Opzioni per i campi utente.

TextOptions

Opzioni per il tipo di campo di testo.

Rappresentazione JSON 
{
  "minLength": integer,
  "maxLength": integer
}
Campi
minLength

integer

Solo output. La lunghezza minima valida dei valori per il campo di testo.
maxLength

integer

Solo output. La lunghezza massima valida dei valori per il campo di testo.

IntegerOptions

Opzioni per il tipo di campo Integer.

Rappresentazione JSON 
{
  "minValue": string,
  "maxValue": string
}
Campi
minValue

string (int64 format)

Solo output. Il valore minimo valido per il campo intero.
maxValue

string (int64 format)

Solo output. Il valore massimo valido per il campo intero.

DateOptions

Opzioni per il tipo di campo data.

Rappresentazione JSON 
{
  "dateFormatType": enum (DateFormat),
  "dateFormat": string,
  "minValue": {
    object (Date)
  },
  "maxValue": {
    object (Date)
  }
}
Campi
dateFormatType

enum (DateFormat)

Opzione di formattazione della data localizzata. I valori dei campi vengono visualizzati in questo formato in base alle impostazioni internazionali.
dateFormat

string

Solo output. Formato della data ICU.
minValue

object (Date)

Solo output. Valore minimo valido (anno, mese, giorno).
maxValue

object (Date)

Solo output. Valore massimo valido (anno, mese, giorno).

DateFormat

Opzioni di formato della data localizzate.

Enum
DATE_FORMAT_UNSPECIFIED Formato della data non specificato.
LONG_DATE Include il nome completo del mese. Ad esempio, 12 gennaio 1999 (MMMM d, y)
SHORT_DATE Rappresentazione numerica breve. Ad esempio, 12/13/99 (M/d/aa)

Data

Rappresenta una data di calendario completa o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno, con un anno pari a zero (ad esempio un anniversario).
  • Un anno da solo, con un mese e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

Mese di un anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
day

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

SelectionOptions

Opzioni per il tipo di campo di selezione.

Rappresentazione JSON 
{
  "listOptions": {
    object (ListOptions)
  },
  "choices": [
    {
      object (Choice)
    }
  ]
}
Campi
listOptions

object (ListOptions)

Se specificato, indica che questo campo supporta un elenco di valori. Una volta pubblicato il campo, non è più possibile modificarlo.
choices[]

object (Choice)

Le opzioni disponibili per questo campo di selezione. L'ordine dell'elenco è coerente e modificato con insertBeforeChoice.

ListOptions

Opzioni per una variante con più valori di un tipo di campo associato.

Rappresentazione JSON 
{
  "maxEntries": integer
}
Campi
maxEntries

integer

Numero massimo di voci consentito.

Scelta

Scelta del campo di selezione.

Rappresentazione JSON 
{
  "id": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "updater": {
    object (UserInfo)
  },
  "updateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "publishTime": string,
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "lockStatus": {
    object (LockStatus)
  }
}
Campi
id

string

Il valore univoco della scelta. Questo ID viene generato automaticamente. Corrisponde all'espressione regolare: ([a-zA-Z0-9_])+.
properties

object (Properties)

Proprietà di base della scelta.
lifecycle

object (Lifecycle)

Solo output. Ciclo di vita della scelta.
displayHints

object (DisplayHints)

Solo output. La UI mostra suggerimenti per il rendering di una scelta.
schemaCapabilities

object (SchemaCapabilities)

Solo output. Le funzionalità correlate a questa opzione quando la modifichi.
appliedCapabilities

object (AppliedCapabilities)

Solo output. Le funzionalità correlate a questa scelta sui metadati applicati.
creator

object (UserInfo)

Solo output. L'utente che ha creato questa scelta.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stata creata questa scelta.
updater

object (UserInfo)

Solo output. L'utente che ha aggiornato per ultimo questa scelta.
updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento di questa scelta.
publisher

object (UserInfo)

Solo output. L'utente che ha pubblicato questa scelta. Questo valore non ha significato quando la scelta non è pubblicata.
publishTime

string (Timestamp format)

Solo output. L'ora di pubblicazione di questa scelta. Questo valore non ha significato quando la scelta non è pubblicata.
disabler

object (UserInfo)

Solo output. L'utente che ha disattivato questa scelta. Questo valore non ha significato se l'opzione non è disattivata.
disableTime

string (Timestamp format)

Solo output. L'ora in cui questa scelta è stata disattivata. Questo valore non ha significato se la scelta non è disattivata.
lockStatus

object (LockStatus)

Solo output. Lo stato della serratura di questa scelta.

Proprietà

Proprietà di base della scelta.

Rappresentazione JSON 
{
  "displayName": string,
  "description": string,
  "badgeConfig": {
    object (BadgeConfig)
  },
  "insertBeforeChoice": string
}
Campi
displayName

string

Obbligatorio. Il testo visualizzato nell'interfaccia utente che identifica questo campo.
description

string

La descrizione di questa etichetta.
badgeConfig

object (BadgeConfig)

La configurazione del badge per questa scelta. Se impostato, l'etichetta proprietaria di questa scelta è considerata un'etichetta con badge.
insertBeforeChoice

string

Solo input. Inserisci o sposta questa scelta prima di quella indicata. Se è vuoto, la scelta viene inserita alla fine dell'elenco.

BadgeConfig

Stato del badge dell'etichetta.

Rappresentazione JSON 
{
  "color": {
    object (Color)
  },
  "priorityOverride": string
}
Campi
color

object (Color)

Il colore del badge. Se non è specificato, non viene visualizzato alcun badge. I colori di sfondo, primo piano e solo (modalità chiara e scura) impostati qui vengono modificati nell'interfaccia utente di Drive nel colore supportato consigliato più simile.
priorityOverride

string (int64 format)

Sostituisci la priorità globale predefinita di questo badge. Se impostato su 0, viene utilizzata l'euristica di priorità predefinita.

Colore

Rappresenta un colore nello spazio colore RGBA. Questa rappresentazione è progettata per semplificare la conversione da e verso le rappresentazioni dei colori in varie lingue rispetto alla compattezza. Ad esempio, i campi di questa rappresentazione possono essere forniti facilmente al costruttore di java.awt.Color in Java; possono anche essere forniti facilmente al metodo +colorWithRed:green:blue:alpha di UIColor in iOS; e, con un po' di lavoro, possono essere facilmente formattati in una stringa rgba() CSS in JavaScript.

Questa pagina di riferimento non contiene informazioni sullo spazio colore assoluto da utilizzare per interpretare il valore RGB, ad esempio sRGB, Adobe RGB, DCI-P3 e BT.2020. Per impostazione predefinita, le applicazioni dovrebbero assumere lo spazio colore sRGB.

Quando è necessario decidere l'uguaglianza dei colori, le implementazioni, a meno che non sia documentato diversamente, trattano due colori come uguali se tutti i valori di rosso, verde, blu e alfa differiscono ciascuno di massimo 1e-5.

Esempio (Java):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

Esempio (iOS / Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

Esempio (JavaScript):

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
Rappresentazione JSON 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Campi
red

number

La quantità di rosso nel colore come valore compreso nell'intervallo [0, 1].
green

number

La quantità di verde nel colore come valore compreso nell'intervallo [0, 1].
blue

number

La quantità di blu nel colore come valore compreso nell'intervallo [0, 1].
alpha

number

La frazione di questo colore da applicare al pixel. In altre parole, il colore del pixel finale è definito dall'equazione:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Ciò significa che un valore di 1,0 corrisponde a un colore a tinta unita, mentre un valore di 0,0 corrisponde a un colore completamente trasparente. Viene utilizzato un messaggio wrapper anziché un semplice valore scalare float in modo da distinguere un valore predefinito dal valore non impostato. Se omesso, questo oggetto di colore viene visualizzato come un colore a tinta unita (come se al valore alfa fosse stato assegnato esplicitamente un valore di 1,0).

DisplayHints

La UI mostra suggerimenti per il rendering di un'opzione.

Rappresentazione JSON 
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "badgeColors": {
    object (BadgeColors)
  },
  "darkBadgeColors": {
    object (BadgeColors)
  },
  "badgePriority": string
}
Campi
disabled

boolean

Indica se l'opzione deve essere mostrata nell'interfaccia utente come disattivata.
shownInApply

boolean

Questa opzione dovrebbe essere visualizzata nel menu Applica quando applichi i valori a un elemento di Drive.
badgeColors

object (BadgeColors)

I colori da utilizzare per il badge. Sono stati utilizzati i colori di Materiale Google in base al properties.badge_config.color scelto.
darkBadgeColors

object (BadgeColors)

Il colore della modalità oscura da utilizzare per il badge. Sono stati utilizzati i colori di Materiale Google in base al properties.badge_config.color scelto.
badgePriority

string (int64 format)

La priorità di questo badge. Utilizzato per confrontare e ordinare più badge. Un numero inferiore indica che il badge deve essere mostrato per primo. Se non è presente una configurazione dei badge, il valore sarà 0. In caso contrario, verrà impostato su BadgeConfig.priority_override o sull'euristica predefinita che preferisce la data di creazione dell'etichetta e la priorità del campo e dell'opzione.

BadgeColors

Il colore derivato da BadgeConfig e modificato in base al colore supportato consigliato più simile.

Rappresentazione JSON 
{
  "backgroundColor": {
    object (Color)
  },
  "foregroundColor": {
    object (Color)
  },
  "soloColor": {
    object (Color)
  }
}
Campi
backgroundColor

object (Color)

Solo output. Sfondo del badge abbinato al primo piano.
foregroundColor

object (Color)

Solo output. Primo piano del badge abbinato allo sfondo.
soloColor

object (Color)

Solo output. Colore che può essere utilizzato per il testo senza sfondo.

SchemaCapabilities

Le funzionalità correlate a questa scelta quando la modifichi.

Rappresentazione JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Campi
canUpdate

boolean

Indica se l'utente può aggiornare questa scelta.
canDelete

boolean

Indica se l'utente può eliminare questa scelta.
canDisable

boolean

Indica se l'utente può disattivare questa scelta.
canEnable

boolean

Indica se l'utente può attivare questa scelta.

AppliedCapabilities

Le funzionalità correlate a questa scelta sui metadati applicati.

Rappresentazione JSON 
{
  "canRead": boolean,
  "canSearch": boolean,
  "canSelect": boolean
}
Campi
canRead

boolean

Indica se l'utente può leggere i metadati applicati correlati sugli elementi.
canSelect

boolean

Indica se l'utente può selezionare questa scelta per un elemento.

LockStatus

Contiene informazioni su se un componente dell'etichetta deve essere considerato bloccato.

Rappresentazione JSON 
{
  "locked": boolean
}
Campi
locked

boolean

Solo output. Indica se questo componente dell'etichetta è il target (diretto) di un LabelLock. Un componente dell'etichetta può essere bloccato implicitamente anche se non è il target diretto di un LabelLock, in questo caso questo campo è impostato su false.

UserOptions

Opzioni per il tipo di campo utente.

Rappresentazione JSON 
{
  "listOptions": {
    object (ListOptions)
  }
}
Campi
listOptions

object (ListOptions)

Se specificato, indica che questo campo supporta un elenco di valori. Una volta pubblicato il campo, non è più possibile modificarlo.

Proprietà

Le proprietà di base del campo.

Rappresentazione JSON 
{
  "displayName": string,
  "required": boolean,
  "insertBeforeField": string
}
Campi
displayName

string

Obbligatorio. Il testo visualizzato nell'interfaccia utente che identifica questo campo.
required

boolean

Indica se il campo deve essere contrassegnato come obbligatorio.
insertBeforeField

string

Solo input. Inserisci o sposta questo campo prima del campo indicato. Se è vuoto, il campo viene inserito alla fine dell'elenco.

DisplayHints

Suggerimenti di visualizzazione dell'interfaccia utente per il rendering di un campo.

Rappresentazione JSON 
{
  "required": boolean,
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean
}
Campi
required

boolean

Indica se il campo deve essere mostrato come obbligatorio nell'interfaccia utente.
disabled

boolean

Indica se il campo deve essere mostrato nell'interfaccia utente come disattivato.
shownInApply

boolean

Questo campo deve essere visualizzato nel menu di applicazione quando si applicano valori a un elemento di Drive.

SchemaCapabilities

Le funzionalità correlate a questo campo durante la modifica.

Rappresentazione JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Campi
canUpdate

boolean

Indica se l'utente può modificare questo campo.
canDelete

boolean

Indica se l'utente può eliminare questo campo. L'utente deve disporre dell'autorizzazione e il campo deve essere ritirato.
canDisable

boolean

Indica se l'utente può disattivare questo campo. L'utente deve disporre dell'autorizzazione e questo campo non deve essere già disattivato.
canEnable

boolean

Indica se l'utente può attivare questo campo. L'utente deve disporre dell'autorizzazione e questo campo deve essere disattivato.

AppliedCapabilities

Le funzionalità relative a questo campo nei metadati applicati.

Rappresentazione JSON 
{
  "canRead": boolean,
  "canSearch": boolean,
  "canWrite": boolean
}
Campi
canRead

boolean

Indica se l'utente può leggere i metadati applicati correlati sugli elementi.
canWrite

boolean

Indica se l'utente può impostare questo campo sugli elementi di Drive.

EnabledAppSettings

Descrive le app di Workspace in cui è possibile utilizzare l'etichetta.

Rappresentazione JSON 
{
  "enabledApps": [
    {
      object (EnabledApp)
    }
  ]
}
Campi
enabledApps[]

object (EnabledApp)

Facoltativo. L'elenco di app in cui è possibile utilizzare l'etichetta.

EnabledApp

Un'app in cui è possibile utilizzare l'etichetta.

Rappresentazione JSON 
{
  "app": enum (App)
}
Campi
app

enum (App)

Facoltativo. Il nome dell'app.

App

L'insieme di possibili app Workspace in cui è possibile utilizzare le etichette.

Enum
APP_UNSPECIFIED Non specificato
DRIVE Guida.
GMAIL Gmail

Metodi

create

 Crea una nuova etichetta.

delete

 Consente di eliminare definitivamente un'etichetta e i metadati correlati negli elementi di Drive.

delta

 Aggiorna una singola etichetta applicando un insieme di richieste di aggiornamento che generano una nuova revisione della bozza.

disable

 Disattivare un'etichetta pubblicata.

enable

 Attiva un'etichetta disattivata e ripristina il relativo stato pubblicato.

get

 Recupera un'etichetta in base al nome della risorsa.

list

 Elenca le etichette.

publish

 Pubblica tutte le modifiche alla bozza dell'etichetta.

updateLabelCopyMode

 Aggiorna il valore CopyMode di un'etichetta.

updateLabelEnabledAppSettings

 Aggiorna EabledAppSettings di un'etichetta.

updatePermissions

 Aggiorna le autorizzazioni di un'etichetta.