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 utilizzati ulteriormente 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. Avrà il 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 far parte dell'etichetta name a seconda della richiesta emessa. Viene creata una nuova revisione ogni volta che vengono modificate le proprietà con revisione di un'etichetta. 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. 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 quando l'etichetta non è disattivata.
disableTime

string (Timestamp format)

Solo output. L'ora in cui questa etichetta è stata disattivata. Questo valore non ha significato quando l'etichetta non è disattivata.
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 è pubblicata, ritirata e se sono presenti modifiche in bozza.
displayHints

object (DisplayHints)

Solo output. Suggerimenti per la visualizzazione della UI 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à che l'utente ha 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 decrescente di priorità.
learnMoreUri

string

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

object (LockStatus)

Solo output. Il LockStatus di questa etichetta.
enabledAppSettings

object (EnabledAppSettings)

(Facoltativo) Il EnabledAppSettings per 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 da applicare agli elementi di Drive.
ADMIN Etichetta di proprietà dell'amministratore. Possono essere creati e modificati 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 maggiori informazioni. Ad esempio, people/12345678.

Proprietà

Proprietà di base dell'etichetta.

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

string

Obbligatorio. Il 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. Per maggiori informazioni, consulta la sezione Ciclo di vita delle etichette.

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 Pubblicato e Disattivato presentano alcune caratteristiche distinte:

  • Published: Alcuni tipi di modifiche potrebbero essere apportati a un oggetto in questo stato, nel qual caso hasUnpublishedChanges sarà true. Inoltre, alcuni tipi di modifiche non sono consentiti. In generale, qualsiasi modifica che invaliderebbe o causerebbe nuove limitazioni ai metadati esistenti correlati all'etichetta viene rifiutata.
  • Disabled: se disattivato, 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 include modifiche non pubblicate.
disabledPolicy

object (DisabledPolicy)

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

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 potrà mai tornare a 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 alla bozza non pubblicate, come indicato da hasUnpublishedChanges.
DISABLED L'oggetto è stato pubblicato e poi disattivato. L'oggetto potrebbe contenere modifiche alla bozza non pubblicate, come indicato da hasUnpublishedChanges.
DELETED L'oggetto è stato eliminato.

DisabledPolicy

Il criterio che regola il modo in cui trattare un'etichetta, un campo o una scelta di selezione disabilitati in contesti diversi.

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

boolean

Indica se mostrare questo oggetto disattivato nel menu di applicazione degli elementi di Drive.

  • Quando true, l'oggetto viene generalmente visualizzato 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 visualizzata nell'interfaccia utente come disattivata.
shownInApply

boolean

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

string (int64 format)

L'ordine in cui visualizzare le etichette in un elenco.

AppliedCapabilities

Le funzionalità di cui dispone un utente sui metadati applicati di 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

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

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 l'etichetta e i valori dei campi applicati quando viene copiato un elemento di Drive.

CopyMode

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

Enum
COPY_MODE_UNSPECIFIED Modalità di copia non specificata.
DO_NOT_COPY L'etichetta e i valori dei campi applicati non vengono copiati per impostazione predefinita 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 può essere applicata 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 per il rendering di un campo visualizzati nell'interfaccia utente.
schemaCapabilities

object (SchemaCapabilities)

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

object (AppliedCapabilities)

Solo output. Le funzionalità di cui dispone questo utente in 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 è stato aggiornato questo campo.
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 quando il campo non è disabilitato.
disableTime

string (Timestamp format)

Solo output. L'ora in cui questo campo è stato disattivato. Questo valore non ha significato quando il campo non è disabilitato.
lockStatus

object (LockStatus)

Solo output. Il 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 Integer.
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 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 valido massimo 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 data ICU.
minValue

object (Date)

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

object (Date)

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

DateFormat

Opzioni di 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 (MMMM d, y)
SHORT_DATE Rappresentazione numerica breve. Ad esempio, 13/12/99 (M/g/aa)

Data

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

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • 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

L'anno della data. Deve essere compreso tra 1 e 9999 o tra 0 e 9999 per specificare una data senza anno.
month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 o 0 per specificare un anno senza mese e giorno.
day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure compreso tra 0 e 31 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 multivalore 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. Suggerimenti per il rendering di una scelta visualizzati nell'UI.
schemaCapabilities

object (SchemaCapabilities)

Solo output. Le funzionalità correlate a questa opzione durante la modifica.
appliedCapabilities

object (AppliedCapabilities)

Solo output. Le funzionalità relative 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 questa scelta per ultimo.
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 viene pubblicata.
publishTime

string (Timestamp format)

Solo output. L'ora in cui è stata pubblicata questa scelta. Questo valore non ha significato quando la scelta non viene pubblicata.
disabler

object (UserInfo)

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

string (Timestamp format)

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

object (LockStatus)

Solo output. Il 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 da mostrare 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 impostata, l'etichetta proprietaria di questa scelta viene 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à Buio e Chiaro) impostati qui vengono modificati nell'interfaccia utente di Drive nel colore supportato consigliato più simile.
priorityOverride

string (int64 format)

Esegui l'override della 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, piuttosto che per la compattezza. Ad esempio, i campi di questa rappresentazione possono essere forniti in modo semplice al costruttore di java.awt.Color in Java; possono anche essere forniti in modo semplice 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 devono utilizzare lo spazio colore sRGB.

Quando è necessario decidere l'uguaglianza dei colori, le implementazioni, se non diversamente documentato, considerano due colori uguali se tutti i loro valori di rosso, verde, blu e alfa differiscono al 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 da applicare al pixel. ovvero il colore finale del pixel è 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 pieno, mentre un valore di 0,0 corrisponde a un colore completamente trasparente. Utilizza un messaggio wrapper anziché un semplice scalare float, in modo da poter distinguere tra un valore predefinito e il valore che viene annullato. Se omesso, questo oggetto colore viene visualizzato come un colore solido (come se al valore alfa fosse stato assegnato esplicitamente un valore di 1.0).

DisplayHints

Suggerimenti per il rendering di un'opzione visualizzati nell'UI.

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 nell'interfaccia utente come disattivata.
shownInApply

boolean

Questa opzione deve essere visualizzata nel menu di applicazione quando si applicano valori a un elemento di Drive.
badgeColors

object (BadgeColors)

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

object (BadgeColors)

Il colore della modalità Buio da utilizzare per il badge. Passaggio ai colori di Google Material 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 più basso indica che il badge deve essere mostrato per primo. Quando non è presente una configurazione dei badge, questo valore è 0. In caso contrario, questo valore verrà impostato su BadgeConfig.priority_override o sull'euristica predefinita che preferisce la data di creazione dell'etichetta e la priorità di campo e opzione.

BadgeColors

Il colore derivato da BadgeConfig e modificato con il colore supportato consigliato più vicino.

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

object (Color)

Solo output. Sfondo del badge che si abbina al primo piano.
foregroundColor

object (Color)

Solo output. Il primo piano del badge si abbina 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.

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

boolean

Se l'utente può aggiornare questa scelta.
canDelete

boolean

Se l'utente può eliminare questa scelta.
canDisable

boolean

Se l'utente può disattivare questa scelta.
canEnable

boolean

Se l'utente può attivare questa scelta.

AppliedCapabilities

Le funzionalità relative 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 agli elementi.
canSelect

boolean

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

LockStatus

Contiene informazioni che indicano se un componente di 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 blocco etichetta. Un componente di etichetta può essere bloccato implicitamente anche se non è il target diretto di un blocco dell'etichetta, 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, 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 da mostrare 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 posizionato alla fine dell'elenco.

DisplayHints

Suggerimenti per il rendering di un campo visualizzati nell'interfaccia utente.

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

boolean

Indica se il campo deve essere visualizzato 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à correlate 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 agli elementi.
canWrite

boolean

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

EnabledAppSettings

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

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

object (EnabledApp)

(Facoltativo) L'elenco delle 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 delle possibili app Google Workspace in cui è possibile utilizzare le etichette.

Enum
APP_UNSPECIFIED Non specificato
DRIVE Drive
GMAIL Gmail

Metodi

create

 Crea un'etichetta.

delete

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

delta

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

disable

 Disattivare un'etichetta pubblicata.

enable

 Attiva un'etichetta disattivata e ripristina il suo 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 CopyMode di un'etichetta.

updateLabelEnabledAppSettings

 Aggiorna il EnabledAppSettings di un'etichetta.

updatePermissions

 Aggiorna le autorizzazioni di un'etichetta.