REST Resource: labels

Risorsa: etichetta

Un'etichetta definisce una tassonomia che può essere applicata agli elementi di Drive per organizzarli ed eseguire ricerche tra gli elementi. Le etichette possono essere semplici stringhe o contenere campi che descrivono metadati aggiuntivi che possono essere ulteriormente utilizzati per organizzare e cercare 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)
  }
}
Campi
name

string

Solo output. Nome risorsa dell'etichetta. A seconda della richiesta, sarà labels/{id} o labels/{id}@{revisionId}. Vedi id e revisionId di seguito.
id

string

Solo output. Identificatore univoco globale di questa etichetta. L'ID costituisce parte dell'etichetta name, ma a differenza di name, l'ID è coerente tra una revisione e l'altra. Corrisponde all'espressione regolare: ([a-zA-Z0-9])+
revisionId

string

Solo output. ID revisione dell'etichetta. L'ID revisione potrebbe far parte dell'etichetta name, a seconda della richiesta inviata. Una nuova revisione viene creata ogni volta che le proprietà di un'etichetta sottoposte a revisione vengono modificate. 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 questa etichetta.
revisionCreator

object (UserInfo)

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

string (Timestamp format)

Solo output. Ora in cui è stata creata la revisione di questa etichetta.
publisher

object (UserInfo)

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

string (Timestamp format)

Solo output. Data e ora di pubblicazione dell'etichetta. Questo valore non ha alcun significato se l'etichetta non è pubblicata.
disabler

object (UserInfo)

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

string (Timestamp format)

Solo output. L'ora in cui questa etichetta è stata disattivata. Questo valore non ha alcun significato se l'etichetta non è disabilitata.
customer

string

Solo output. Il cliente a cui appartiene questa 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, incluso se è stata pubblicata, deprecata e se presenta modifiche alla bozza.
displayHints

object (DisplayHints)

Solo output. Suggerimenti di visualizzazione dell'interfaccia utente per il rendering dell'etichetta.
appliedCapabilities

object (AppliedCapabilities)

Solo output. Le funzionalità relative a questa etichetta sui metadati applicati.
schemaCapabilities

object (SchemaCapabilities)

Solo output. Le funzionalità dell'utente su questa etichetta.
appliedLabelPolicy

object (AppliedLabelPolicy)

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

object (Field)

Elenco dei campi in ordine di priorità decrescente.
learnMoreUri

string

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

object (LockStatus)

Solo output. Il valore LockStatus di questa etichetta.

LabelType

Il tipo di questa etichetta.

Enum
LABEL_TYPE_UNSPECIFIED Tipo di etichetta sconosciuto.
SHARED Le etichette condivise possono essere condivise con gli utenti per applicarle agli elementi di Drive.
ADMIN Etichetta di proprietà dell'amministratore. Creabile e modificabile solo dagli amministratori. Supporta alcune funzionalità aggiuntive riservate agli amministratori.

UserInfo

Informazioni su un utente.

Rappresentazione JSON 
{
  "person": string
}
Campi
person

string

L'identificatore per questo utente che può essere utilizzato con l'API People per ottenere ulteriori informazioni. Ad esempio, persone/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

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 -> (Eliminato)
  • PUBLISHED -> DISABLED
  • DISABLED -> PUBLISHED
  • DISABLED -> (Eliminato)

Gli stati Pubblicati e Disattivato hanno alcune caratteristiche distinte:

  • Pubblicato: alcuni tipi di modifiche possono essere apportate a un oggetto in questo stato; in tal caso il valore hasUnpublishedChanges sarà vero. Inoltre, alcuni tipi di modifiche non sono consentiti. In genere, qualsiasi modifica che invalida o causa nuove restrizioni sui metadati esistenti relativi all'etichetta viene rifiutata.
  • Disattivato: se disattivato, l'impostazione DisabledPolicy configurata diventa effettiva.
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 ha 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 a questo stato. Una volta pubblicato un oggetto, non sono più consentiti alcuni tipi di modifiche.
PUBLISHED L'oggetto è stato pubblicato. L'oggetto potrebbe avere modifiche alla bozza non pubblicate, come indicato da hasUnpublishedChanges.
DISABLED L'oggetto è stato pubblicato e successivamente è stato disabilitato. L'oggetto potrebbe avere modifiche alla bozza non pubblicate, come indicato da hasUnpublishedChanges.
DELETED L'oggetto è stato eliminato.

DisabledPolicy

Le norme che regolano le modalità di trattamento di un'etichetta, un campo o una 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 nella UI come disabilitato e non è selezionabile.
  • Quando false, l'oggetto è generalmente nascosto nella UI.

DisplayHints

Suggerimenti di visualizzazione dell'interfaccia utente per il rendering dell'etichetta.

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

boolean

Indica se l'etichetta deve essere visualizzata nella UI come disabilitata.
shownInApply

boolean

Questa etichetta dovrebbe essere visualizzata nel menu Applica quando applichi valori a un elemento di Drive.
priority

string (int64 format)

Ordine per visualizzare l'etichetta in un elenco.

AppliedCapabilities

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

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

boolean

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

boolean

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

boolean

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

SchemaCapabilities

Le funzionalità correlate a questa etichetta durante la modifica dell'etichetta.

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

boolean

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 disabilitata.
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

Comportamento di questa etichetta quando viene applicata agli elementi di Drive.

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

enum (CopyMode)

Indica come copiare l'etichetta applicata e i valori dei campi quando viene copiato un elemento di Drive.

CopyMode

Indica come copiare l'etichetta applicata e i valori dei campi quando viene copiato un elemento di Drive.

Enum
COPY_MODE_UNSPECIFIED Modalità di copia non specificata.
DO_NOT_COPY Per impostazione predefinita, quando viene copiato l'elemento di Drive a cui sono applicati, i valori dell'etichetta e dei campi applicati non vengono copiati.
ALWAYS_COPY I valori delle etichette e 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 applicata e i valori dei campi vengono copiati se l'etichetta è applicabile all'utente che esegue la copia.

Campo

Definisce un campo con nome visualizzato, tipo di dati e altre opzioni di configurazione. Questo campo definisce il tipo di metadati che è possibile impostare 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 libreria.

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

string

Solo output. La chiave da utilizzare durante la creazione di query di ricerca di Drive per trovare i file in base ai valori definiti per questo campo nei file. Ad esempio, "{queryKey} > 2001-01-01".
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 quando modifica questo campo.
appliedCapabilities

object (AppliedCapabilities)

Solo output. Le funzionalità di questo utente su 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 alcun significato se il campo non è pubblicato.
disabler

object (UserInfo)

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

string (Timestamp format)

Solo output. Data e ora di disattivazione del campo. Questo valore non ha alcun 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 del campo di testo.
integerOptions

object (IntegerOptions)

Opzioni del campo intero.
dateOptions

object (DateOptions)

Opzioni del campo Data.
selectionOptions

object (SelectionOptions)

Opzioni del campo di selezione.
userOptions

object (UserOptions)

Opzioni del campo utente.

TextOptions

Opzioni per il tipo di campo 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 Numero intero.

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

string (int64 format)

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

string (int64 format)

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

DateOptions

Opzioni per il tipo di campo della 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 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 per il formato della data localizzate.

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

Data

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

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • Un mese e un giorno con zero anni (ad esempio, un anniversario).
  • Un anno a sé stante, con uno zero mese e uno zero-day.
  • Un anno e un mese, con zero day (ad esempio, la data di scadenza della carta di credito).

Tipi correlati:

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

integer

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

integer

Mese dell'anno. Il valore 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 deve essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e 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, questo valore non può essere modificato.
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 a più valori di un tipo di campo associato.

Rappresentazione JSON 
{
  "maxEntries": integer
}
Campi
maxEntries

integer

Numero massimo di voci consentite.

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 unico 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 a scelta.
displayHints

object (DisplayHints)

Solo output. Suggerimenti di visualizzazione dell'interfaccia utente per il rendering di una scelta.
schemaCapabilities

object (SchemaCapabilities)

Solo output. Le funzionalità relative a questa opzione durante la modifica dell'opzione.
appliedCapabilities

object (AppliedCapabilities)

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

object (UserInfo)

Solo output. L'utente che ha creato la 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 questa scelta per ultimo.
updateTime

string (Timestamp format)

Solo output. L'ultima volta che questa scelta è stata aggiornata.
publisher

object (UserInfo)

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

string (Timestamp format)

Solo output. Data/ora di pubblicazione della scelta. Questo valore non ha alcun significato se la scelta non è pubblicata.
disabler

object (UserInfo)

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

string (Timestamp format)

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

object (LockStatus)

Solo output. Il valore LockStatus 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 che identifica questo campo nell'interfaccia utente.
description

string

La descrizione di questa etichetta.
badgeConfig

object (BadgeConfig)

La configurazione del badge per questa scelta. Se impostata, l'etichetta proprietaria di questa scelta viene considerata "etichetta con badge".
insertBeforeChoice

string

Solo input. Inserisci o sposta questa opzione prima di quella indicata. Se vuoto, l'opzione viene posizionata 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, in primo piano e Solo (modalità Luce e Buio) impostati qui vengono modificati nell'UI di Drive con il colore supportato più simile consigliato.
priorityOverride

string (int64 format)

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

Colore

Rappresenta un colore nello spazio colore RGBA. Questa rappresentazione è progettata per facilitare la conversione da e verso rappresentazioni a colori in vari linguaggi piuttosto che per la compattezza. Ad esempio, i campi di questa rappresentazione possono essere forniti banalmente al costruttore di java.awt.Color in Java; può anche essere fornito banalmente al metodo +colorWithRed:green:blue:alpha di UIColor in iOS; e, con un po' di lavoro, può essere facilmente formattata in una stringa rgba() CSS in JavaScript.

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

Quando è necessario decidere l'uguaglianza dei colori, le implementazioni, salvo diversa indicazione, tratta i due colori come uguali se tutti i rispettivi valori di rosso, verde, blu e alfa differiscono di un massimo di 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 nell'intervallo [0, 1].
green

number

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

number

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

number

La frazione di questo colore che deve essere applicata al pixel. In altre parole, il colore finale dei pixel è definito dall'equazione:

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

Ciò significa che un valore pari a 1,0 corrisponde a un colore in tinta unita, mentre un valore pari a 0,0 a un colore completamente trasparente. Viene utilizzato un messaggio wrapper anziché un semplice scalare in virgola mobile in modo che sia possibile distinguere tra un valore predefinito e il valore non impostato. Se omesso, l'oggetto colore viene visualizzato come colore a tinta unita (come se al valore alpha fosse stato assegnato esplicitamente un valore 1,0).

DisplayHints

Suggerimenti di visualizzazione dell'interfaccia utente 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 visualizzata nella UI come disabilitata.
shownInApply

boolean

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

object (BadgeColors)

I colori da utilizzare per il badge. Passati ai colori Material Google in base al valore properties.badge_config.color scelto.
darkBadgeColors

object (BadgeColors)

Il colore modalità Buio da utilizzare per il badge. Passati ai colori Material Google in base al valore properties.badge_config.color scelto.
badgePriority

string (int64 format)

La priorità di questo badge. Utilizzato per confrontare più badge e ordinarli. Un numero inferiore indica che il badge deve essere mostrato per primo. Se non è presente una configurazione con 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à di campi e opzioni.

BadgeColors

Il colore derivato da BadgeConfig e modificato con il 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 che si accoppia al primo piano.
foregroundColor

object (Color)

Solo output. Assegna un badge a un primo piano che si accoppia allo sfondo.
soloColor

object (Color)

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

SchemaCapabilities

Le funzionalità correlate a questa scelta durante la modifica della scelta.

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ò abilitare questa scelta.

AppliedCapabilities

Le funzionalità relative a questa scelta sui metadati applicati.

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

boolean

Se l'utente può leggere i metadati applicati correlati agli elementi.
canSelect

boolean

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

LockStatus

Contiene informazioni sull'eventuale necessità di considerare bloccato un componente di un'etichetta.

Rappresentazione JSON 
{
  "locked": boolean
}
Campi
locked

boolean

Solo output. Indica se questo componente dell'etichetta è la destinazione (diretta) di un LabelLock. Un componente di etichetta può essere bloccato in modo implicito anche se non è la destinazione diretta di un oggetto LabelLock, nel qual 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, questo valore non può essere modificato.

Proprietà

Le proprietà di base del campo.

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

string

Obbligatorio. Il testo visualizzato che identifica questo campo nell'interfaccia utente.
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 posizionato in fondo all'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 visualizzato come richiesto nella UI.
disabled

boolean

Indica se il campo deve essere visualizzato nella UI come disabilitato.
shownInApply

boolean

Questo campo deve essere visualizzato nel menu Applica quando applichi valori a un elemento di Drive.

SchemaCapabilities

Le funzionalità correlate a questo campo durante la modifica del campo.

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 obsoleto.
canDisable

boolean

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

boolean

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

AppliedCapabilities

Le funzionalità relative a questo campo sui metadati applicati.

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

boolean

Se l'utente può leggere i metadati applicati correlati agli elementi.
canWrite

boolean

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

Metodi

create

 Crea una nuova etichetta.

delete

 Elimina definitivamente un'etichetta e i metadati correlati dagli elementi di Drive.

delta

 Consente di aggiornare una singola etichetta applicando un insieme di richieste di aggiornamento che genera una nuova revisione della bozza.

disable

 Disattivare un'etichetta pubblicata.

enable

 Abilita un'etichetta disabilitata e ripristina il suo stato di pubblicazione.

get

 Viene visualizzata un'etichetta in base al nome della risorsa.

list

 Elenca le etichette.

publish

 Pubblica tutte le modifiche alla bozza dell'etichetta.

updateLabelCopyMode

 Consente di aggiornare il valore CopyMode di un'etichetta.

updatePermissions

 Aggiorna le autorizzazioni di un'etichetta.