REST Resource: labels

Recurso: Etiqueta

Una etiqueta define una taxonomía que se puede aplicar a los elementos de Drive para organizarlos y buscarlos. Las etiquetas pueden ser cadenas simples o contener campos que describen metadatos adicionales que se pueden usar para organizar y buscar elementos de Drive.

Representación 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)
  }
}
Campos
name

string

Solo salida. Es el nombre del recurso de la etiqueta. Tendrá el formato labels/{id} o labels/{id}@{revisionId}, según la solicitud. Consulta id y revisionId a continuación.
id

string

Solo salida. Es el identificador único a nivel global de esta etiqueta. El ID forma parte de la etiqueta name, pero a diferencia de name, el ID es coherente entre las revisiones. Coincide con la regex: ([a-zA-Z0-9])+
revisionId

string

Solo salida. Es el ID de la revisión de la etiqueta. El ID de revisión puede ser parte de la etiqueta name según la solicitud emitida. Se crea una revisión nueva cada vez que se cambian las propiedades revisadas de una etiqueta. Coincide con la regex: ([a-zA-Z0-9])+
labelType

enum (LabelType)

Obligatorio. Es el tipo de etiqueta.
creator

object (UserInfo)

Solo salida. El usuario que creó esta etiqueta.
createTime

string (Timestamp format)

Solo salida. La hora en la que se creó esta etiqueta.
revisionCreator

object (UserInfo)

Solo salida. Es el usuario que creó esta revisión de la etiqueta.
revisionCreateTime

string (Timestamp format)

Solo salida. La hora en la que se creó esta revisión de la etiqueta.
publisher

object (UserInfo)

Solo salida. El usuario que publicó esta etiqueta. Este valor no tiene sentido cuando la etiqueta no está publicada.
publishTime

string (Timestamp format)

Solo salida. Es la hora en la que se publicó esta etiqueta. Este valor no tiene sentido cuando la etiqueta no está publicada.
disabler

object (UserInfo)

Solo salida. El usuario que inhabilitó esta etiqueta. Este valor no tiene significado cuando la etiqueta no está inhabilitada.
disableTime

string (Timestamp format)

Solo salida. La hora en la que se inhabilitó esta etiqueta. Este valor no tiene sentido cuando la etiqueta no está inhabilitada.
customer

string

Solo salida. El cliente al que pertenece esta etiqueta. Por ejemplo, "customers/123abc789".
properties

object (Properties)

Obligatorio. Las propiedades básicas de la etiqueta.
lifecycle

object (Lifecycle)

Solo salida. El estado del ciclo de vida de la etiqueta, incluido si está publicada, obsoleta y si tiene cambios en el borrador
displayHints

object (DisplayHints)

Solo salida. Sugerencias de visualización de la IU para renderizar la etiqueta
appliedCapabilities

object (AppliedCapabilities)

Solo salida. Las capacidades relacionadas con esta etiqueta en los metadatos aplicados
schemaCapabilities

object (SchemaCapabilities)

Solo salida. Las capacidades que tiene el usuario en esta etiqueta.
appliedLabelPolicy

object (AppliedLabelPolicy)

Solo salida. Comportamiento de esta etiqueta cuando se aplica a elementos de Drive.
fields[]

object (Field)

Es una lista de campos en orden de prioridad descendente.
learnMoreUri

string

Es una URL personalizada que se presenta a los usuarios para que puedan obtener más información sobre esta etiqueta y cómo se debe usar.
lockStatus

object (LockStatus)

Solo salida. El LockStatus de esta etiqueta.
enabledAppSettings

object (EnabledAppSettings)

Opcional. El EnabledAppSettings para esta etiqueta.

LabelType

Es el tipo de esta etiqueta.

Enumeraciones
LABEL_TYPE_UNSPECIFIED Tipo de etiqueta desconocido.
SHARED Las etiquetas compartidas se pueden compartir con los usuarios para aplicarlas a los elementos de Drive.
ADMIN Etiqueta propiedad del administrador. Solo los administradores pueden crearlos y editarlos. Admite algunas funciones adicionales solo para administradores.
GOOGLE_APP Es una etiqueta que pertenece a una aplicación interna de Google en lugar de a un cliente. Estas etiquetas son de solo lectura.

UserInfo

Información sobre un usuario.

Representación JSON 
{
  "person": string
}
Campos
person

string

Es el identificador de este usuario que se puede usar con la API de People para obtener más información. Por ejemplo, personas/12345678.

Propiedades

Son las propiedades básicas de la etiqueta.

Representación JSON 
{
  "title": string,
  "description": string
}
Campos
title

string

Obligatorio. Es el título de la etiqueta.
description

string

Es la descripción de la etiqueta.

Lifecycle

El estado del ciclo de vida de un objeto, como una etiqueta, un campo o una opción. El ciclo de vida aplica las siguientes transiciones:

  • UNPUBLISHED_DRAFT (estado inicial)
  • UNPUBLISHED_DRAFT -> PUBLISHED
  • UNPUBLISHED_DRAFT -> (Deleted)
  • PUBLISHED -> DISABLED
  • DISABLED -> PUBLISHED
  • DISABLED -> (Deleted)

Los estados publicados y desactivados tienen algunas características distintivas:

  • Publicado: Se pueden realizar algunos tipos de cambios en un objeto en este estado, en cuyo caso hasUnpublishedChanges será verdadero. Además, no se permiten algunos tipos de cambios. Por lo general, se rechaza cualquier cambio que invalide o cause nuevas restricciones en los metadatos existentes relacionados con la etiqueta.
  • Inhabilitado: Cuando está inhabilitado, se aplica el DisabledPolicy configurado.
Representación JSON 
{
  "state": enum (State),
  "hasUnpublishedChanges": boolean,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
Campos
state

enum (State)

Solo salida. Es el estado del objeto asociado con este ciclo de vida.
hasUnpublishedChanges

boolean

Solo salida. Indica si el objeto asociado con este ciclo de vida tiene cambios sin publicar.
disabledPolicy

object (DisabledPolicy)

Es la política que rige cómo mostrar una etiqueta, un campo o una opción de selección inhabilitados.

Estado

El estado del objeto asociado con este ciclo de vida.

Enumeraciones
STATE_UNSPECIFIED Estado desconocido.
UNPUBLISHED_DRAFT Es el estado inicial de un objeto. Una vez publicado, el objeto nunca puede volver a este estado. Una vez que se publica un objeto, ya no se permiten ciertos tipos de cambios.
PUBLISHED Se publicó el objeto. Es posible que el objeto tenga cambios de borrador no publicados, como lo indica hasUnpublishedChanges.
DISABLED El objeto se publicó y, luego, se inhabilitó. Es posible que el objeto tenga cambios de borrador no publicados, como lo indica hasUnpublishedChanges.
DELETED Se borró el objeto.

DisabledPolicy

Es la política que rige cómo se debe tratar una etiqueta, un campo o una opción de selección inhabilitados en diferentes contextos.

Representación JSON 
{
  "hideInSearch": boolean,
  "showInApply": boolean
}
Campos
showInApply

boolean

Indica si se debe mostrar este objeto inhabilitado en el menú Aplicar en los elementos de Drive.

  • Cuando es true, el objeto generalmente se muestra en la IU como inhabilitado y no se puede seleccionar.
  • Cuando es false, el objeto suele estar oculto en la IU.

DisplayHints

Sugerencias de visualización de la IU para renderizar la etiqueta

Representación JSON 
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "priority": string
}
Campos
disabled

boolean

Indica si la etiqueta se debe mostrar en la IU como inhabilitada.
shownInApply

boolean

Esta etiqueta debe mostrarse en el menú Aplicar cuando se aplican valores a un elemento de Drive.
priority

string (int64 format)

Es el orden para mostrar la etiqueta en una lista.

AppliedCapabilities

Las capacidades que tiene un usuario sobre los metadatos aplicados a esta etiqueta.

Representación JSON 
{
  "canRead": boolean,
  "canApply": boolean,
  "canRemove": boolean
}
Campos
canRead

boolean

Indica si el usuario puede leer los metadatos aplicados relacionados con esta etiqueta.
canApply

boolean

Indica si el usuario puede aplicar esta etiqueta a los elementos.
canRemove

boolean

Indica si el usuario puede quitar esta etiqueta de los elementos.

SchemaCapabilities

Las capacidades relacionadas con esta etiqueta cuando la editas.

Representación JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Campos
canUpdate

boolean

Indica si el usuario puede cambiar esta etiqueta.
canDelete

boolean

Indica si el usuario puede borrar esta etiqueta. El usuario debe tener permiso y la etiqueta debe estar inhabilitada.
canDisable

boolean

Indica si el usuario puede inhabilitar esta etiqueta. El usuario debe tener permiso, y esta etiqueta no debe estar inhabilitada.
canEnable

boolean

Indica si el usuario puede habilitar esta etiqueta. El usuario debe tener permiso y esta etiqueta debe estar inhabilitada.

AppliedLabelPolicy

Comportamiento de esta etiqueta cuando se aplica a elementos de Drive.

Representación JSON 
{
  "copyMode": enum (CopyMode)
}
Campos
copyMode

enum (CopyMode)

Indica cómo se deben copiar la etiqueta aplicada y los valores de campo cuando se copia un elemento de Drive.

CopyMode

Indica cómo se deben copiar la etiqueta aplicada y los valores de campo cuando se copia un elemento de Drive.

Enumeraciones
COPY_MODE_UNSPECIFIED No se especificó el modo de copia.
DO_NOT_COPY La etiqueta aplicada y los valores de los campos no se copian de forma predeterminada cuando se copia el elemento de Drive al que se aplican.
ALWAYS_COPY La etiqueta aplicada y los valores de campo siempre se copian cuando se copia el elemento de Drive al que se aplican. Solo los administradores pueden usar este modo.
COPY_APPLIABLE La etiqueta aplicada y los valores de campo se copian si el usuario que realiza la copia puede aplicar la etiqueta.

Campo

Define un campo que tiene un nombre visible, un tipo de datos y otras opciones de configuración. Este campo define el tipo de metadatos que se pueden establecer en un elemento de Drive.

Representación 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.
}
Campos
id

string

Solo salida. Es la clave de un campo, única dentro de una etiqueta o biblioteca.

Este valor se genera automáticamente. Coincide con la regex: ([a-zA-Z0-9])+
queryKey

string

Solo salida. Es la clave que se debe usar cuando se construyen consultas de búsqueda de Drive para encontrar archivos según los valores definidos para este campo en los archivos. Por ejemplo, "{queryKey} > 2001-01-01".
properties

object (Properties)

Las propiedades básicas del campo
lifecycle

object (Lifecycle)

Solo salida. El ciclo de vida de este campo
displayHints

object (DisplayHints)

Solo salida. Sugerencias de visualización de la IU para renderizar un campo
schemaCapabilities

object (SchemaCapabilities)

Solo salida. Son las capacidades que tiene este usuario cuando edita este campo.
appliedCapabilities

object (AppliedCapabilities)

Solo salida. Las capacidades que tiene este usuario en este campo y su valor cuando se aplica la etiqueta en los elementos de Drive.
creator

object (UserInfo)

Solo salida. Es el usuario que creó este campo.
createTime

string (Timestamp format)

Solo salida. Es la hora en la que se creó este campo.
updater

object (UserInfo)

Solo salida. Es el usuario que modificó este campo.
updateTime

string (Timestamp format)

Solo salida. La hora en la que se actualizó este campo.
publisher

object (UserInfo)

Solo salida. Es el usuario que publicó este campo. Este valor no tiene sentido cuando el campo no está publicado.
disabler

object (UserInfo)

Solo salida. El usuario que inhabilitó este campo. Este valor no tiene sentido cuando el campo no está inhabilitado.
disableTime

string (Timestamp format)

Solo salida. La hora en la que se inhabilitó este campo. Este valor no tiene sentido cuando el campo no está inhabilitado.
lockStatus

object (LockStatus)

Solo salida. El LockStatus de este campo.
Campo de unión type. El tipo de datos y las opciones de este campo. Una vez publicado, el tipo de datos no se puede cambiar. Las direcciones (type) solo pueden ser una de las siguientes opciones:
textOptions

object (TextOptions)

Opciones del campo de texto.
integerOptions

object (IntegerOptions)

Opciones de campos de número entero.
dateOptions

object (DateOptions)

Opciones del campo de fecha.
selectionOptions

object (SelectionOptions)

Opciones del campo de selección.
userOptions

object (UserOptions)

Opciones de campos de usuario.

TextOptions

Son opciones para el tipo de campo de texto.

Representación JSON 
{
  "minLength": integer,
  "maxLength": integer
}
Campos
minLength

integer

Solo salida. Es la longitud mínima válida de los valores para el campo de texto.
maxLength

integer

Solo salida. Es la longitud máxima válida de los valores para el campo de texto.

IntegerOptions

Son opciones para el tipo de campo Integer.

Representación JSON 
{
  "minValue": string,
  "maxValue": string
}
Campos
minValue

string (int64 format)

Solo salida. Es el valor mínimo válido para el campo de número entero.
maxValue

string (int64 format)

Solo salida. Es el valor máximo válido para el campo de número entero.

DateOptions

Son opciones para el tipo de campo de fecha.

Representación JSON 
{
  "dateFormatType": enum (DateFormat),
  "dateFormat": string,
  "minValue": {
    object (Date)
  },
  "maxValue": {
    object (Date)
  }
}
Campos
dateFormatType

enum (DateFormat)

Es la opción de formato de fecha localizado. Los valores de los campos se renderizan en este formato según su configuración regional.
dateFormat

string

Solo salida. Formato de fecha de ICU.
minValue

object (Date)

Solo salida. Es el valor mínimo válido (año, mes y día).
maxValue

object (Date)

Solo salida. Es el valor máximo válido (año, mes y día).

DateFormat

Opciones de formato de fecha localizadas

Enumeraciones
DATE_FORMAT_UNSPECIFIED No se especificó el formato de fecha.
LONG_DATE Incluye el nombre completo del mes. Por ejemplo, 12 de enero de 1999 (d de MMMM, a)
SHORT_DATE Representación numérica breve. Por ejemplo, 13/12/99 (dd/mm/aaaa)

Fecha

Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:

  • Una fecha completa con valores para el año, mes y día que no sean cero.
  • Un mes y un día, con cero año (por ejemplo, un aniversario).
  • Un año por sí solo, con un mes cero y un día cero.
  • Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).

Tipos relacionados:

Representación JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año.
month

integer

Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día.
day

integer

Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo.

SelectionOptions

Son las opciones para el tipo de campo de selección.

Representación JSON 
{
  "listOptions": {
    object (ListOptions)
  },
  "choices": [
    {
      object (Choice)
    }
  ]
}
Campos
listOptions

object (ListOptions)

Cuando se especifica, indica que este campo admite una lista de valores. Una vez que se publique el campo, no se podrá cambiar.
choices[]

object (Choice)

Son las opciones disponibles para este campo de selección. El orden de la lista es coherente y se modifica con insertBeforeChoice.

ListOptions

Son opciones para una variante de varios valores de un tipo de campo asociado.

Representación JSON 
{
  "maxEntries": integer
}
Campos
maxEntries

integer

Cantidad máxima de entradas permitidas.

Opciones

Selección del campo de selección.

Representación 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)
  }
}
Campos
id

string

Es el valor único de la elección. Este ID se genera automáticamente. Coincide con la regex: ([a-zA-Z0-9_])+.
properties

object (Properties)

Son las propiedades básicas de la opción.
lifecycle

object (Lifecycle)

Solo salida. Ciclo de vida de la opción.
displayHints

object (DisplayHints)

Solo salida. Sugerencias de visualización de la IU para renderizar una opción.
schemaCapabilities

object (SchemaCapabilities)

Solo salida. Las capacidades relacionadas con esta opción cuando se edita.
appliedCapabilities

object (AppliedCapabilities)

Solo salida. Las funciones relacionadas con esta opción en los metadatos aplicados
creator

object (UserInfo)

Solo salida. El usuario que creó esta opción.
createTime

string (Timestamp format)

Solo salida. La hora en la que se creó esta opción.
updater

object (UserInfo)

Solo salida. El usuario que actualizó esta opción por última vez.
updateTime

string (Timestamp format)

Solo salida. La hora en la que se actualizó esta opción por última vez.
publisher

object (UserInfo)

Solo salida. El usuario que publicó esta opción. Este valor no tiene sentido cuando la opción no está publicada.
publishTime

string (Timestamp format)

Solo salida. La hora en que se publicó esta opción. Este valor no tiene sentido cuando la opción no está publicada.
disabler

object (UserInfo)

Solo salida. El usuario que inhabilitó esta opción Este valor no tiene sentido cuando la opción no está inhabilitada.
disableTime

string (Timestamp format)

Solo salida. La hora en que se inhabilitó esta opción Este valor no tiene sentido cuando la opción no está inhabilitada.
lockStatus

object (LockStatus)

Solo salida. El LockStatus de esta opción.

Propiedades

Son las propiedades básicas de la opción.

Representación JSON 
{
  "displayName": string,
  "description": string,
  "badgeConfig": {
    object (BadgeConfig)
  },
  "insertBeforeChoice": string
}
Campos
displayName

string

Obligatorio. Es el texto que se mostrará en la IU para identificar este campo.
description

string

Es la descripción de esta etiqueta.
badgeConfig

object (BadgeConfig)

Es la configuración de la insignia para esta opción. Cuando se establece, la etiqueta a la que pertenece esta opción se considera una "etiqueta con insignia".
insertBeforeChoice

string

Solo entrada. Inserta o mueve esta opción antes de la opción indicada. Si está vacío, la opción se coloca al final de la lista.

BadgeConfig

Estado de la insignia de la etiqueta.

Representación JSON 
{
  "color": {
    object (Color)
  },
  "priorityOverride": string
}
Campos
color

object (Color)

Es el color de la insignia. Si no se especifica, no se renderiza ninguna insignia. Los colores de fondo, primer plano y solo (modo oscuro y claro) que se establecen aquí se cambian en la IU de Drive al color compatible recomendado más cercano.
priorityOverride

string (int64 format)

Anula la prioridad global predeterminada de esta insignia. Cuando se establece en 0, se usa la heurística de prioridad predeterminada.

Color

Representa un color en el espacio de color RGBA. Esta representación está diseñada para simplificar la conversión de representaciones de colores a otros idiomas y viceversa, en lugar de la compacidad. Por ejemplo, los campos de esta representación se pueden proporcionar de forma trivial al constructor de java.awt.Color en Java; también se pueden proporcionar de forma trivial al método +colorWithRed:green:blue:alpha de UIColor en iOS y, con un poco de trabajo, se pueden dar fácilmente formato a una cadena rgba() de CSS en JavaScript.

Esta página de referencia no tiene información sobre el espacio de color absoluto que se debe usar para interpretar el valor RGB, por ejemplo, sRGB, Adobe RGB, DCI-P3 y BT.2020. De forma predeterminada, las aplicaciones deben tener el espacio de color sRGB.

Cuando se debe decidir la igualdad de colores, las implementaciones, a menos que se documente lo contrario, tratan dos colores como iguales si todos sus valores de rojo, verde, azul y alfa difieren en un máximo de 1e-5.

Ejemplo (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();
 }
 // ...

Ejemplo (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;
}
// ...

Ejemplo (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('');
};

// ...
Representación JSON 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Campos
red

number

La cantidad de rojo en el color como un valor en el intervalo [0, 1].
green

number

La cantidad de verde en el color como un valor en el intervalo [0, 1].
blue

number

La cantidad de azul en el color como un valor en el intervalo [0, 1].
alpha

number

La fracción de este color que se debe aplicar al píxel. Es decir, el color del píxel final se define mediante la siguiente ecuación:

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

Esto significa que el valor 1.0 corresponde a un color sólido, mientras que el valor 0.0 corresponde a un color completamente transparente. Esto utiliza un mensaje de wrapper en lugar de un escalar flotante simple, para que sea posible distinguir entre un valor predeterminado y el valor que no se configura. Si se omite, este objeto de color se renderiza como un color sólido (como si el valor alfa se proporcionara de forma explícita con un valor de 1.0).

DisplayHints

La IU muestra sugerencias para renderizar una opción.

Representación JSON 
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "badgeColors": {
    object (BadgeColors)
  },
  "darkBadgeColors": {
    object (BadgeColors)
  },
  "badgePriority": string
}
Campos
disabled

boolean

Indica si la opción se debe mostrar en la IU como inhabilitada.
shownInApply

boolean

Esta opción debería mostrarse en el menú Aplicar cuando se aplican valores a un elemento de Drive.
badgeColors

object (BadgeColors)

Son los colores que se usarán para la insignia. Se cambiaron a los colores de Material de Google según el properties.badge_config.color elegido.
darkBadgeColors

object (BadgeColors)

Es el color del modo oscuro que se usará para la insignia. Se cambiaron a los colores de Material de Google según el properties.badge_config.color elegido.
badgePriority

string (int64 format)

Es la prioridad de esta insignia. Se usa para comparar y ordenar varias insignias. Un número más bajo significa que la insignia debe mostrarse primero. Cuando no haya una configuración de insignias, este valor será 0. De lo contrario, se establecerá en BadgeConfig.priority_override o en la heurística predeterminada que prefiere la fecha de creación de la etiqueta y la prioridad del campo y la opción.

BadgeColors

El color derivado de BadgeConfig y cambiado al color compatible recomendado más cercano.

Representación JSON 
{
  "backgroundColor": {
    object (Color)
  },
  "foregroundColor": {
    object (Color)
  },
  "soloColor": {
    object (Color)
  }
}
Campos
backgroundColor

object (Color)

Solo salida. Es el fondo de la insignia que se combina con el primer plano.
foregroundColor

object (Color)

Solo salida. Primer plano de la insignia que se combina con el fondo.
soloColor

object (Color)

Solo salida. Es el color que se puede usar para el texto sin fondo.

SchemaCapabilities

Las capacidades relacionadas con esta opción cuando la editas.

Representación JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Campos
canUpdate

boolean

Indica si el usuario puede actualizar esta opción.
canDelete

boolean

Indica si el usuario puede borrar esta opción.
canDisable

boolean

Indica si el usuario puede inhabilitar esta opción.
canEnable

boolean

Indica si el usuario puede habilitar esta opción.

AppliedCapabilities

Las funciones relacionadas con esta opción en los metadatos aplicados

Representación JSON 
{
  "canRead": boolean,
  "canSearch": boolean,
  "canSelect": boolean
}
Campos
canRead

boolean

Indica si el usuario puede leer los metadatos aplicados relacionados en los elementos.
canSelect

boolean

Indica si el usuario puede seleccionar esta opción en un elemento.

LockStatus

Contiene información sobre si un componente de etiqueta debe considerarse bloqueado.

Representación JSON 
{
  "locked": boolean
}
Campos
locked

boolean

Solo salida. Indica si este componente de etiqueta es el objetivo (directo) de un LabelLock. Un componente de etiqueta se puede bloquear de forma implícita, incluso si no es el objetivo directo de un LabelLock. En ese caso, este campo se establece como "false".

UserOptions

Son opciones para el tipo de campo de usuario.

Representación JSON 
{
  "listOptions": {
    object (ListOptions)
  }
}
Campos
listOptions

object (ListOptions)

Cuando se especifica, indica que este campo admite una lista de valores. Una vez que se publique el campo, no se podrá cambiar.

Propiedades

Las propiedades básicas del campo

Representación JSON 
{
  "displayName": string,
  "required": boolean,
  "insertBeforeField": string
}
Campos
displayName

string

Obligatorio. Es el texto que se mostrará en la IU para identificar este campo.
required

boolean

Indica si el campo se debe marcar como obligatorio.
insertBeforeField

string

Solo entrada. Inserta o mueve este campo antes del campo indicado. Si está vacío, el campo se coloca al final de la lista.

DisplayHints

Sugerencias de visualización de la IU para renderizar un campo

Representación JSON 
{
  "required": boolean,
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean
}
Campos
required

boolean

Indica si el campo se debe mostrar como obligatorio en la IU.
disabled

boolean

Indica si el campo se debe mostrar en la IU como inhabilitado.
shownInApply

boolean

Este campo debe mostrarse en el menú Aplicar cuando se aplican valores a un elemento de Drive.

SchemaCapabilities

Las funciones relacionadas con este campo cuando lo editas.

Representación JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Campos
canUpdate

boolean

Indica si el usuario puede cambiar este campo.
canDelete

boolean

Indica si el usuario puede borrar este campo. El usuario debe tener permiso y el campo debe estar obsoleto.
canDisable

boolean

Indica si el usuario puede inhabilitar este campo. El usuario debe tener permiso y este campo no debe estar inhabilitado.
canEnable

boolean

Indica si el usuario puede habilitar este campo. El usuario debe tener permiso y este campo debe estar inhabilitado.

AppliedCapabilities

Las funciones relacionadas con este campo en los metadatos aplicados

Representación JSON 
{
  "canRead": boolean,
  "canSearch": boolean,
  "canWrite": boolean
}
Campos
canRead

boolean

Indica si el usuario puede leer los metadatos aplicados relacionados en los elementos.
canWrite

boolean

Indica si el usuario puede configurar este campo en los elementos de Drive.

EnabledAppSettings

Describe las apps de Workspace en las que se puede usar la etiqueta.

Representación JSON 
{
  "enabledApps": [
    {
      object (EnabledApp)
    }
  ]
}
Campos
enabledApps[]

object (EnabledApp)

Opcional. Es la lista de apps en las que se puede usar la etiqueta.

EnabledApp

Una app en la que se puede usar la etiqueta.

Representación JSON 
{
  "app": enum (App)
}
Campos
app

enum (App)

Opcional. Es el nombre de la app.

Aplicación

Es el conjunto de apps de Workspace posibles en las que se pueden usar las etiquetas.

Enumeraciones
APP_UNSPECIFIED Sin especificar
DRIVE Drive;
GMAIL Gmail

Métodos

create

 Crea una etiqueta nueva.

delete

 Borra de forma permanente una etiqueta y los metadatos relacionados en los elementos de Drive.

delta

 Actualiza una sola etiqueta aplicando un conjunto de solicitudes de actualización que generan una nueva revisión de borrador.

disable

 Inhabilitar una etiqueta publicada

enable

 Habilita una etiqueta inhabilitada y restablece su estado publicado.

get

 Obtén una etiqueta por su nombre de recurso.

list

 Etiquetas de lista.

publish

 Publica todos los cambios del borrador en la etiqueta.

updateLabelCopyMode

 Actualiza el CopyMode de una etiqueta.

updateLabelEnabledAppSettings

 Actualiza EabledAppSettings de una etiqueta.

updatePermissions

 Actualiza los permisos de una etiqueta.