REST Resource: labels

Recurso: rótulo

Um marcador define uma taxonomia que pode ser aplicada a itens do Drive para organizar e pesquisar entre eles. Os marcadores podem ser strings simples ou conter campos que descrevem outros metadados que podem ser usados para organizar e pesquisar itens do Drive.

Representação 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

Apenas saída. Nome do recurso do rótulo. Eles estarão no formato labels/{id} ou labels/{id}@{revisionId}, dependendo da solicitação. Consulte id e revisionId abaixo.
id

string

Apenas saída. Identificador globalmente exclusivo deste rótulo. O ID faz parte do rótulo name, mas, ao contrário de name, ele é consistente entre as revisões. Corresponde à regex: ([a-zA-Z0-9])+.
revisionId

string

Apenas saída. ID da revisão do rótulo. O ID da revisão pode fazer parte do rótulo name, dependendo da solicitação emitida. Uma nova revisão é criada sempre que as propriedades revisadas de um rótulo são alteradas. Corresponde à regex: ([a-zA-Z0-9])+.
labelType

enum (LabelType)

Obrigatório. O tipo de rótulo.
creator

object (UserInfo)

Apenas saída. O usuário que criou o rótulo.
createTime

string (Timestamp format)

Apenas saída. A hora em que o rótulo foi criado.
revisionCreator

object (UserInfo)

Apenas saída. O usuário que criou esta revisão de rótulo.
revisionCreateTime

string (Timestamp format)

Apenas saída. O horário em que esta revisão de rótulo foi criada.
publisher

object (UserInfo)

Apenas saída. O usuário que publicou este rótulo. Esse valor não tem significado quando o marcador não é publicado.
publishTime

string (Timestamp format)

Apenas saída. A hora em que este rótulo foi publicado. Esse valor não tem significado quando o marcador não é publicado.
disabler

object (UserInfo)

Apenas saída. O usuário que desativou o marcador. Esse valor não tem significado quando o rótulo não está desativado.
disableTime

string (Timestamp format)

Apenas saída. O momento em que o rótulo foi desativado. Esse valor não tem significado quando o rótulo não está desativado.
customer

string

Apenas saída. O cliente a que este rótulo pertence. Por exemplo, customers/123abc789.
properties

object (Properties)

Obrigatório. As propriedades básicas do rótulo.
lifecycle

object (Lifecycle)

Apenas saída. O estado do ciclo de vida do rótulo, incluindo se ele foi publicado, está descontinuado e tem mudanças em rascunho.
displayHints

object (DisplayHints)

Apenas saída. Dicas de exibição da interface para renderizar o rótulo.
appliedCapabilities

object (AppliedCapabilities)

Apenas saída. Os recursos relacionados a esse rótulo nos metadados aplicados.
schemaCapabilities

object (SchemaCapabilities)

Apenas saída. Os recursos que o usuário tem nesse marcador.
appliedLabelPolicy

object (AppliedLabelPolicy)

Apenas saída. Comportamento desse marcador quando ele é aplicado a itens do Drive.
fields[]

object (Field)

Lista de campos em ordem decrescente de prioridade.
learnMoreUri

string

URL personalizado para apresentar aos usuários e permitir que eles saibam mais sobre esse rótulo e como ele deve ser usado.
lockStatus

object (LockStatus)

Apenas saída. O LockStatus deste rótulo.
enabledAppSettings

object (EnabledAppSettings)

Opcional. O EnabledAppSettings deste rótulo.

LabelType

O tipo deste rótulo.

Enums
LABEL_TYPE_UNSPECIFIED Tipo de marcador desconhecido.
SHARED Os marcadores compartilhados podem ser compartilhados com usuários para serem aplicados a itens do Drive.
ADMIN Rótulo de propriedade do administrador. Só podem ser criados e editados por administradores. Oferece suporte a alguns recursos adicionais somente para administradores.
GOOGLE_APP Um rótulo pertencente a um aplicativo interno do Google, e não a um cliente. Esses rótulos são somente leitura.

UserInfo

Informações sobre um usuário.

Representação JSON 
{
  "person": string
}
Campos
person

string

O identificador desse usuário que pode ser usado com a API People para mais informações. Por exemplo, people/12345678.

Propriedades

Propriedades básicas do rótulo.

Representação JSON 
{
  "title": string,
  "description": string
}
Campos
title

string

Obrigatório. Título do rótulo.
description

string

A descrição do rótulo.

Ciclo de vida

O estado do ciclo de vida de um objeto, como rótulo, campo ou opção. Para mais informações, consulte Ciclo de vida do rótulo.

O ciclo de vida impõe as seguintes transições:

  • UNPUBLISHED_DRAFT (estado inicial)
  • UNPUBLISHED_DRAFT -> PUBLISHED
  • UNPUBLISHED_DRAFT -> (excluído)
  • PUBLISHED -> DISABLED
  • DISABLED -> PUBLISHED
  • DISABLED -> (excluído)

Os estados publicado e desativado têm algumas características distintas:

  • Published: alguns tipos de mudanças podem ser feitos em um objeto nesse estado. Nesse caso, hasUnpublishedChanges será verdadeiro. Além disso, alguns tipos de mudanças não são permitidos. Em geral, qualquer mudança que invalide ou cause novas restrições nos metadados relacionados ao rótulo é rejeitada.
  • Disabled: quando desativado, o DisabledPolicy configurado entra em vigor.
Representação JSON 
{
  "state": enum (State),
  "hasUnpublishedChanges": boolean,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
Campos
state

enum (State)

Apenas saída. O estado do objeto associado a esse ciclo de vida.
hasUnpublishedChanges

boolean

Apenas saída. Indica se o objeto associado a esse ciclo de vida tem mudanças não publicadas.
disabledPolicy

object (DisabledPolicy)

A política que rege como mostrar um rótulo, campo ou opção de seleção desativada.

Estado

O estado do objeto associado a esse ciclo de vida.

Enums
STATE_UNSPECIFIED Estado desconhecido.
UNPUBLISHED_DRAFT O estado inicial de um objeto. Depois de publicado, o objeto nunca mais poderá voltar a esse estado. Depois que um objeto é publicado, alguns tipos de mudanças não são mais permitidos.
PUBLISHED O objeto foi publicado. O objeto pode ter mudanças de rascunho não publicadas, conforme indicado por hasUnpublishedChanges.
DISABLED O objeto foi publicado e desativado. O objeto pode ter mudanças de rascunho não publicadas, conforme indicado por hasUnpublishedChanges.
DELETED O objeto foi excluído.

DisabledPolicy

A política que rege como tratar um marcador, campo ou opção de seleção desativada em diferentes contextos.

Representação JSON 
{
  "hideInSearch": boolean,
  "showInApply": boolean
}
Campos
showInApply

boolean

Indica se o objeto desativado será mostrado no menu "Aplicar" dos itens do Drive.

  • Quando true, o objeto geralmente é mostrado na interface como desativado e não pode ser selecionado.
  • Quando false, o objeto geralmente fica oculto na interface.

DisplayHints

A interface mostra dicas para renderizar o rótulo.

Representação JSON 
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "priority": string
}
Campos
disabled

boolean

Se o rótulo deve ser mostrado na interface como desativado.
shownInApply

boolean

Esse rótulo precisa ser mostrado no menu "Aplicar" ao aplicar valores a um item do Drive.
priority

string (int64 format)

A ordem para mostrar rótulos em uma lista.

AppliedCapabilities

Os recursos que um usuário tem nos metadados aplicados do marcador.

Representação JSON 
{
  "canRead": boolean,
  "canApply": boolean,
  "canRemove": boolean
}
Campos
canRead

boolean

Indica se o usuário pode ler os metadados aplicados relacionados a esse marcador.
canApply

boolean

Indica se o usuário pode aplicar esse marcador aos itens.
canRemove

boolean

Indica se o usuário pode remover esse marcador dos itens.

SchemaCapabilities

As funcionalidades relacionadas a esse marcador ao editar o marcador.

Representação JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Campos
canUpdate

boolean

Indica se o usuário pode mudar esse marcador.
canDelete

boolean

Indica se o usuário pode excluir esse marcador. O usuário precisa ter permissão, e o marcador precisa estar desativado.
canDisable

boolean

Indica se o usuário pode desativar esse rótulo. O usuário precisa ter permissão, e o marcador não pode estar desativado.
canEnable

boolean

Indica se o usuário pode ativar esse rótulo. O usuário precisa ter permissão, e o marcador precisa estar desativado.

AppliedLabelPolicy

Comportamento desse marcador quando ele é aplicado a itens do Drive.

Representação JSON 
{
  "copyMode": enum (CopyMode)
}
Campos
copyMode

enum (CopyMode)

Indica como o marcador aplicado e os valores de campo devem ser copiados quando um item do Drive é copiado.

CopyMode

Indica como o marcador aplicado e os valores de campo devem ser copiados quando um item do Drive é copiado.

Enums
COPY_MODE_UNSPECIFIED Modo de cópia não especificado.
DO_NOT_COPY O marcador aplicado e os valores de campo não são copiados por padrão quando o item do Drive a que ele está aplicado é copiado.
ALWAYS_COPY O marcador e os valores de campo aplicados são sempre copiados quando o item do Drive a que eles estão associados é copiado. Somente administradores podem usar esse modo.
COPY_APPLIABLE O marcador e os valores de campos aplicados serão copiados se o usuário que fizer a cópia puder aplicar o marcador.

Campo

Define um campo que tem um nome de exibição, um tipo de dados e outras opções de configuração. Esse campo define o tipo de metadados que podem ser definidos em um item do Drive.

Representação 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

Apenas saída. A chave de um campo, exclusiva em um rótulo ou biblioteca.

Esse valor é gerado automaticamente. Corresponde à regex: ([a-zA-Z0-9])+.
queryKey

string

Apenas saída. A chave a ser usada ao criar consultas de pesquisa do Drive para encontrar arquivos com base nos valores definidos para esse campo. Por exemplo, "{queryKey} > 2001-01-01".
properties

object (Properties)

As propriedades básicas do campo.
lifecycle

object (Lifecycle)

Apenas saída. O ciclo de vida deste campo.
displayHints

object (DisplayHints)

Apenas saída. Dicas de exibição da interface para renderizar um campo.
schemaCapabilities

object (SchemaCapabilities)

Apenas saída. Os recursos que esse usuário tem ao editar esse campo.
appliedCapabilities

object (AppliedCapabilities)

Apenas saída. As funcionalidades que esse usuário tem nesse campo e o valor dele quando o marcador é aplicado aos itens do Drive.
creator

object (UserInfo)

Apenas saída. O usuário que criou este campo.
createTime

string (Timestamp format)

Apenas saída. O horário em que este campo foi criado.
updater

object (UserInfo)

Apenas saída. O usuário que modificou este campo.
updateTime

string (Timestamp format)

Apenas saída. A hora em que este campo foi atualizado.
publisher

object (UserInfo)

Apenas saída. O usuário que publicou este campo. Esse valor não tem significado quando o campo não é publicado.
disabler

object (UserInfo)

Apenas saída. O usuário que desativou esse campo. Esse valor não tem significado quando o campo não está desativado.
disableTime

string (Timestamp format)

Apenas saída. O momento em que esse campo foi desativado. Esse valor não tem significado quando o campo não está desativado.
lockStatus

object (LockStatus)

Apenas saída. O LockStatus deste campo.
Campo de união type. O tipo de dados e as opções desse campo. Depois de publicado, o tipo de dados não pode ser alterado. type pode ser apenas de um dos tipos a seguir:
textOptions

object (TextOptions)

Opções de campo de texto.
integerOptions

object (IntegerOptions)

Opções de campo de número inteiro.
dateOptions

object (DateOptions)

Opções de campo de data.
selectionOptions

object (SelectionOptions)

Opções de campo de seleção.
userOptions

object (UserOptions)

Opções de campo do usuário.

TextOptions

Opções para o tipo de campo "Texto".

Representação JSON 
{
  "minLength": integer,
  "maxLength": integer
}
Campos
minLength

integer

Apenas saída. O comprimento mínimo válido dos valores para o campo de texto.
maxLength

integer

Apenas saída. O comprimento máximo válido dos valores para o campo de texto.

IntegerOptions

Opções para o tipo de campo "Número inteiro".

Representação JSON 
{
  "minValue": string,
  "maxValue": string
}
Campos
minValue

string (int64 format)

Apenas saída. O valor mínimo válido para o campo de número inteiro.
maxValue

string (int64 format)

Apenas saída. O valor máximo válido para o campo de número inteiro.

DateOptions

Opções para o tipo de campo de data.

Representação JSON 
{
  "dateFormatType": enum (DateFormat),
  "dateFormat": string,
  "minValue": {
    object (Date)
  },
  "maxValue": {
    object (Date)
  }
}
Campos
dateFormatType

enum (DateFormat)

Opção de formatação de data localizada. Os valores dos campos são renderizados nesse formato de acordo com a localidade.
dateFormat

string

Apenas saída. Formato de data da ICU.
minValue

object (Date)

Apenas saída. Valor mínimo válido (ano, mês, dia).
maxValue

object (Date)

Apenas saída. Valor máximo válido (ano, mês, dia).

DateFormat

Opções de formato de data localizada.

Enums
DATE_FORMAT_UNSPECIFIED Formato de data não especificado.
LONG_DATE Inclui o nome completo do mês. Por exemplo, 12 de janeiro de 1999 (MMMM d, y)
SHORT_DATE Representação numérica curta. Por exemplo, 13/12/99 (d/M/aa)

Data

Representa uma data inteira ou parcial do calendário, como um aniversário. A hora do dia e o fuso horário são especificados em outro lugar ou são insignificantes. A data é referente ao calendário gregoriano. Isso pode representar uma das seguintes opções:

  • uma data completa, com valores de ano, mês e dia diferentes de zero;
  • um mês e dia, com um ano zero (por exemplo, uma data comemorativa);
  • um ano sozinho, com um mês zero e um dia zero;
  • um ano e mês, com um dia zero (por exemplo, uma data de validade de cartão de crédito).

Tipos relacionados:

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.
month

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.
day

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.

SelectionOptions

Opções para o tipo de campo de seleção.

Representação JSON 
{
  "listOptions": {
    object (ListOptions)
  },
  "choices": [
    {
      object (Choice)
    }
  ]
}
Campos
listOptions

object (ListOptions)

Quando especificado, indica que este campo aceita uma lista de valores. Depois que o campo é publicado, não é possível mudar isso.
choices[]

object (Choice)

As opções disponíveis para esse campo de seleção. A ordem da lista é consistente e modificada com insertBeforeChoice.

ListOptions

Opções para uma variante de vários valores de um tipo de campo associado.

Representação JSON 
{
  "maxEntries": integer
}
Campos
maxEntries

integer

Número máximo de entradas permitidas.

Escolha

Campo de seleção.

Representação 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

O valor exclusivo da escolha. Esse ID é gerado automaticamente. Corresponde à regex: ([a-zA-Z0-9_])+.
properties

object (Properties)

Propriedades básicas da escolha.
lifecycle

object (Lifecycle)

Apenas saída. Ciclo de vida da escolha.
displayHints

object (DisplayHints)

Apenas saída. Dicas de exibição da interface para renderizar uma escolha.
schemaCapabilities

object (SchemaCapabilities)

Apenas saída. Os recursos relacionados a essa opção ao editar.
appliedCapabilities

object (AppliedCapabilities)

Apenas saída. Os recursos relacionados a essa escolha nos metadados aplicados.
creator

object (UserInfo)

Apenas saída. O usuário que criou essa opção.
createTime

string (Timestamp format)

Apenas saída. O horário em que essa opção foi criada.
updater

object (UserInfo)

Apenas saída. O usuário que atualizou essa opção por último.
updateTime

string (Timestamp format)

Apenas saída. A hora em que essa opção foi atualizada pela última vez.
publisher

object (UserInfo)

Apenas saída. O usuário que publicou essa opção. Esse valor não tem significado quando a opção não é publicada.
publishTime

string (Timestamp format)

Apenas saída. O momento em que essa opção foi publicada. Esse valor não tem significado quando a opção não é publicada.
disabler

object (UserInfo)

Apenas saída. O usuário que desativou essa opção. Esse valor não tem significado quando a opção não está desativada.
disableTime

string (Timestamp format)

Apenas saída. O momento em que essa opção foi desativada. Esse valor não tem significado quando a opção não está desativada.
lockStatus

object (LockStatus)

Apenas saída. O LockStatus desta opção.

Propriedades

Propriedades básicas da escolha.

Representação JSON 
{
  "displayName": string,
  "description": string,
  "badgeConfig": {
    object (BadgeConfig)
  },
  "insertBeforeChoice": string
}
Campos
displayName

string

Obrigatório. O texto de exibição a ser mostrado na interface que identifica esse campo.
description

string

A descrição do rótulo.
badgeConfig

object (BadgeConfig)

A configuração do selo para essa opção. Quando definido, o rótulo que possui essa opção é considerado um "rótulo com selo".
insertBeforeChoice

string

Somente entrada. Insere ou move essa opção antes da opção indicada. Se estiver vazio, a opção será colocada no final da lista.

BadgeConfig

Status do selo do rótulo.

Representação JSON 
{
  "color": {
    object (Color)
  },
  "priorityOverride": string
}
Campos
color

object (Color)

É a cor do selo. Quando não especificado, nenhum indicador é renderizado. As cores de plano de fundo, primeiro plano e solo (modo claro e escuro) definidas aqui são mudadas na interface do Drive para a cor recomendada mais próxima.
priorityOverride

string (int64 format)

Substitui a prioridade global padrão deste selo. Quando definido como 0, a heurística de prioridade padrão é usada.

Cor

Representa uma cor no espaço de cores RGBA. Essa representação foi projetada para simplificar a conversão de e para representações de cores em vários idiomas, em vez de compactação. Por exemplo, os campos dessa representação podem ser fornecidos trivialmente ao construtor de java.awt.Color em Java, ao método +colorWithRed:green:blue:alpha de UIColor em iOS e, com um pouco de trabalho, podem ser formatados facilmente em uma string rgba() CSS em JavaScript.

Esta página de referência não tem informações sobre o espaço de cores absoluto que precisa ser usado para interpretar o valor RGB. Por exemplo, sRGB, Adobe RGB, DCI-P3 e BT.2020. Por padrão, os aplicativos usam o espaço de cores sRGB.

Quando a igualdade de cores precisa ser decidida, as implementações, a menos que documentadas de outra forma, tratam duas cores como iguais se todos os valores de vermelho, verde, azul e alfa diferirem em no máximo 1e-5.

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

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

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

// ...
Representação JSON 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Campos
red

number

A quantidade de vermelho na cor como um valor no intervalo [0, 1].
green

number

A quantidade de verde na cor como um valor no intervalo [0, 1].
blue

number

A quantidade de azul na cor como um valor no intervalo [0, 1].
alpha

number

A fração desta cor que deve ser aplicada ao pixel. Ou seja, a cor final do pixel é definida pela equação:

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

Isto significa que um valor de 1,0 corresponde a uma cor sólida, enquanto um valor de 0,0 corresponde a uma cor completamente transparente. Esse recurso usa uma mensagem de wrapper, em vez de um escalar flutuante simples, para que seja possível distinguir entre um valor padrão e o valor que está sendo desativado. Se omitido, esse objeto de cor será renderizado como uma cor sólida, como se o valor alfa fosse informado explicitamente com um valor de 1,0.

DisplayHints

Dicas de exibição da interface para renderizar uma opção.

Representação JSON 
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "badgeColors": {
    object (BadgeColors)
  },
  "darkBadgeColors": {
    object (BadgeColors)
  },
  "badgePriority": string
}
Campos
disabled

boolean

Se a opção deve ser mostrada na interface como desativada.
shownInApply

boolean

Essa opção precisa aparecer no menu "Aplicar" ao aplicar valores a um item do Drive.
badgeColors

object (BadgeColors)

As cores a serem usadas no selo. Mudança para cores do Google Material com base no properties.badge_config.color escolhido.
darkBadgeColors

object (BadgeColors)

A cor do modo escuro a ser usada no selo. Mudança para cores do Google Material com base no properties.badge_config.color escolhido.
badgePriority

string (int64 format)

A prioridade deste selo. Usado para comparar e classificar vários selos. Quanto menor o número, mais cedo o selo vai aparecer. Quando uma configuração de selo não está presente, esse valor é 0. Caso contrário, será definido como BadgeConfig.priority_override ou a heurística padrão, que prefere a data de criação do rótulo e a prioridade do campo e da opção.

BadgeColors

A cor derivada de BadgeConfig e mudada para a cor recomendada mais próxima.

Representação JSON 
{
  "backgroundColor": {
    object (Color)
  },
  "foregroundColor": {
    object (Color)
  },
  "soloColor": {
    object (Color)
  }
}
Campos
backgroundColor

object (Color)

Apenas saída. Fundo do selo que combina com o primeiro plano.
foregroundColor

object (Color)

Apenas saída. Primeiro plano do selo que combina com o plano de fundo.
soloColor

object (Color)

Apenas saída. Cor que pode ser usada em texto sem plano de fundo.

SchemaCapabilities

Os recursos relacionados a essa opção ao editar a escolha.

Representação JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Campos
canUpdate

boolean

Se o usuário pode atualizar essa escolha.
canDelete

boolean

Indica se o usuário pode excluir essa opção.
canDisable

boolean

Indica se o usuário pode desativar essa opção.
canEnable

boolean

Indica se o usuário pode ativar essa opção.

AppliedCapabilities

Os recursos relacionados a essa escolha nos metadados aplicados.

Representação JSON 
{
  "canRead": boolean,
  "canSearch": boolean,
  "canSelect": boolean
}
Campos
canRead

boolean

Se o usuário pode ler metadados relacionados aplicados a itens.
canSelect

boolean

Se o usuário pode selecionar essa opção em um item.

LockStatus

Contém informações sobre se um componente de rótulo deve ser considerado bloqueado.

Representação JSON 
{
  "locked": boolean
}
Campos
locked

boolean

Apenas saída. Indica se este componente de rótulo é o destino (direto) de um bloqueio de rótulo. Um componente de rótulo pode ser bloqueado implicitamente mesmo que não seja o destino direto de um bloqueio de rótulo. Nesse caso, o campo é definido como "false".

UserOptions

Opções para o tipo de campo de usuário.

Representação JSON 
{
  "listOptions": {
    object (ListOptions)
  }
}
Campos
listOptions

object (ListOptions)

Quando especificado, indica que este campo aceita uma lista de valores. Depois que o campo é publicado, não é possível mudar isso.

Propriedades

As propriedades básicas do campo.

Representação JSON 
{
  "displayName": string,
  "required": boolean,
  "insertBeforeField": string
}
Campos
displayName

string

Obrigatório. O texto de exibição a ser mostrado na interface que identifica esse campo.
required

boolean

Se o campo deve ser marcado como obrigatório.
insertBeforeField

string

Somente entrada. Insira ou mova esse campo antes do campo indicado. Se estiver vazio, o campo será colocado no final da lista.

DisplayHints

Dicas de exibição da interface para renderizar um campo.

Representação JSON 
{
  "required": boolean,
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean
}
Campos
required

boolean

Se o campo deve ser mostrado como obrigatório na interface.
disabled

boolean

Se o campo deve ser mostrado na interface como desativado.
shownInApply

boolean

Esse campo precisa ser mostrado no menu "Aplicar" ao aplicar valores a um item do Drive.

SchemaCapabilities

As funcionalidades relacionadas a esse campo ao editar.

Representação JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Campos
canUpdate

boolean

Indica se o usuário pode mudar esse campo.
canDelete

boolean

Indica se o usuário pode excluir esse campo. O usuário precisa ter permissão, e o campo precisa estar descontinuado.
canDisable

boolean

Indica se o usuário pode desativar esse campo. O usuário precisa ter permissão, e o campo não pode estar desativado.
canEnable

boolean

Indica se o usuário pode ativar esse campo. O usuário precisa ter permissão, e esse campo precisa estar desativado.

AppliedCapabilities

Os recursos relacionados a esse campo nos metadados aplicados.

Representação JSON 
{
  "canRead": boolean,
  "canSearch": boolean,
  "canWrite": boolean
}
Campos
canRead

boolean

Se o usuário pode ler metadados relacionados aplicados a itens.
canWrite

boolean

Indica se o usuário pode definir esse campo em itens do Drive.

EnabledAppSettings

Descreve os apps do Google Workspace em que o rótulo pode ser usado.

Representação JSON 
{
  "enabledApps": [
    {
      object (EnabledApp)
    }
  ]
}
Campos
enabledApps[]

object (EnabledApp)

Opcional. A lista de apps em que o rótulo pode ser usado.

EnabledApp

Um app em que o rótulo pode ser usado.

Representação JSON 
{
  "app": enum (App)
}
Campos
app

enum (App)

Opcional. O nome do app.

App

O conjunto de apps do Google Workspace em que os marcadores podem ser usados.

Enums
APP_UNSPECIFIED Não especificado
DRIVE Drive
GMAIL Gmail

Métodos

create

 Cria um marcador.

delete

 Exclui permanentemente um rótulo e os metadados relacionados nos itens do Drive.

delta

 Atualiza um único rótulo aplicando um conjunto de solicitações de atualização que resultam em uma nova revisão de rascunho.

disable

 Desativar um marcador publicado.

enable

 Ativar um rótulo desativado e restaurá-lo ao estado publicado.

get

 Recebe um rótulo pelo nome do recurso.

list

 Listar rótulos.

publish

 Publique todas as mudanças do rascunho no rótulo.

updateLabelCopyMode

 Atualiza o CopyMode de um rótulo.

updateLabelEnabledAppSettings

 Atualiza o EnabledAppSettings de um rótulo.

updatePermissions

 Atualiza as permissões de um rótulo.