Esta página foi traduzida pela API Cloud Translation.

Other

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 de forma simples ao construtor de java.awt.Color em Java. Eles também podem ser fornecidos de forma simples ao método +colorWithRed:green:blue:alpha do UIColor no iOS. Com um pouco de trabalho, eles podem ser formatados facilmente em uma string rgba() do CSS no 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(rgbColor) {
   var redFrac = rgbColor.red || 0.0;
   var greenFrac = rgbColor.green || 0.0;
   var blueFrac = rgbColor.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

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

   var alphaFrac = rgbColor.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 tivesse sido explicitamente informado com um valor de 1,0.

ColorStyle

Um valor de cor.

Representação JSON
{ // Union field `kind` can be only one of the following: "rgbColor": { object (`Color`) }, "themeColor": enum (`ThemeColorType`) // End of list of possible types for union field `kind`. }

Campos

Campos
Campo de união `kind`. O tipo de valor de cor. `kind` pode ser apenas um dos seguintes:
`rgbColor`	`object (Color)` Cor RGB. O valor `alpha` no objeto `Color` geralmente não é aceito.
`themeColor`	`enum (ThemeColorType)` Cor do tema.

Campo de união kind. O tipo de valor de cor. kind pode ser apenas um dos seguintes:

rgbColor

object (Color)

Cor RGB. O valor alpha no objeto Color geralmente não é aceito.

themeColor

enum (ThemeColorType)

Cor do tema.

ThemeColorType

Tipos de cores do tema.

SpreadsheetProperties contêm um SpreadsheetTheme que define um mapeamento desses tipos de cores de tema para cores concretas.

Enums
`THEME_COLOR_TYPE_UNSPECIFIED`	Cor do tema não especificada
`TEXT`	Representa a cor do texto principal
`BACKGROUND`	Representa a cor de plano de fundo principal
`ACCENT1`	Representa a primeira cor de destaque
`ACCENT2`	Representa a segunda cor de destaque
`ACCENT3`	Representa a terceira cor de destaque
`ACCENT4`	Representa a quarta cor de destaque
`ACCENT5`	Representa a quinta cor de destaque
`ACCENT6`	Representa a sexta cor de destaque
`LINK`	Representa a cor a ser usada para hiperlinks

HorizontalAlign

O alinhamento horizontal do texto em uma célula.

Enums
`HORIZONTAL_ALIGN_UNSPECIFIED`	O alinhamento horizontal não foi especificado. Não use isso.
`LEFT`	O texto é alinhado explicitamente à esquerda da célula.
`CENTER`	O texto é explicitamente alinhado ao centro da célula.
`RIGHT`	O texto é alinhado explicitamente à direita da célula.

TextFormat

O formato de uma sequência de texto em uma célula. Valores ausentes indicam que o campo não foi especificado.

Representação JSON

Representação JSON
{ "foregroundColor": { object (`Color`) }, "foregroundColorStyle": { object (`ColorStyle`) }, "fontFamily": string, "fontSize": integer, "bold": boolean, "italic": boolean, "strikethrough": boolean, "underline": boolean, "link": { object (`Link`) } }

{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}

Campos
`foregroundColor (deprecated)`	`object (Color)` Este item está obsoleto. A cor do primeiro plano do texto. Descontinuado: use `foregroundColorStyle`.
`foregroundColorStyle`	`object (ColorStyle)` A cor do primeiro plano do texto. Se `foregroundColor` também estiver definido, esse campo terá precedência.
`fontFamily`	`string` A família de fontes.
`fontSize`	`integer` O tamanho da fonte.
`bold`	`boolean` Verdadeiro se o texto estiver em negrito.
`italic`	`boolean` Verdadeiro se o texto estiver em itálico.
`strikethrough`	`boolean` Verdadeiro se o texto tiver uma tachado.
`underline`	`boolean` Verdadeiro se o texto estiver sublinhado.
`link`	`object (Link)` O destino do link do texto, se houver. A definição do campo de link em um `TextFormatRun` vai limpar os links existentes da célula ou um link definido no nível da célula na mesma solicitação. Quando um link é definido, a cor de primeiro plano do texto é definida como a cor padrão do link e o texto é sublinhado. Se esses campos forem modificados na mesma solicitação, esses valores serão usados em vez dos padrões do link.

Link

Uma referência externa ou local.

Representação JSON
{ // Union field `destination` can be only one of the following: "uri": string // End of list of possible types for union field `destination`. }

Campos

Campos
Campo de união `destination`. O destino do link. `destination` pode ser apenas um dos seguintes:
`uri`	`string` O identificador do link.

Campo de união destination. O destino do link. destination pode ser apenas um dos seguintes:

uri

string

O identificador do link.

DataSourceColumn

Uma coluna em uma fonte de dados.

Representação JSON
{ "reference": { object (`DataSourceColumnReference`) }, "formula": string }

Campos

Campos
`reference`	`object (DataSourceColumnReference)` A referência da coluna.
`formula`	`string` A fórmula da coluna calculada.

reference

object (DataSourceColumnReference)

A referência da coluna.

formula

string

A fórmula da coluna calculada.

DataSourceColumnReference

Um identificador exclusivo que faz referência a uma coluna da fonte de dados.

Representação JSON
{ "name": string }

Campos

Campos
`name`	`string` Nome de exibição da coluna. Ele precisa ser exclusivo em uma fonte de dados.

name

string

Nome de exibição da coluna. Ele precisa ser exclusivo em uma fonte de dados.

DataExecutionStatus

O status de execução dos dados.

Uma execução de dados é criada para sincronizar um objeto de fonte de dados com os dados mais recentes de um DataSource. Ele geralmente é programado para ser executado em segundo plano. Você pode verificar o state para saber se uma execução foi concluída.

Há vários cenários em que uma execução de dados é acionada para ser executada:

Adding a data source cria uma planilha de origem de dados associada e uma execução de dados para sincronizar os dados da fonte com a planilha.
Updating a data source cria uma execução de dados para atualizar a planilha de origem de dados associada de maneira semelhante.
É possível enviar refresh request para atualizar explicitamente um ou vários objetos de fonte de dados.

Representação JSON
{ "state": enum (`DataExecutionState`), "errorCode": enum (`DataExecutionErrorCode`), "errorMessage": string, "lastRefreshTime": string }

Campos
`state`	`enum (DataExecutionState)` O estado da execução dos dados.
`errorCode`	`enum (DataExecutionErrorCode)` O código do erro.
`errorMessage`	`string` A mensagem de erro, que pode estar vazia.
`lastRefreshTime`	`string (Timestamp format)` Recebe o horário da última atualização bem-sucedida dos dados.

DataExecutionState

Uma enumeração de estados de execução de dados.

Enums
`DATA_EXECUTION_STATE_UNSPECIFIED`	Valor padrão. Não use.
`NOT_STARTED`	A execução de dados não foi iniciada.
`RUNNING`	A execução dos dados foi iniciada.
`CANCELLING`	A execução de dados está sendo cancelada.
`SUCCEEDED`	A execução de dados foi concluída.
`FAILED`	A execução dos dados foi concluída com erros.

DataExecutionErrorCode

Uma enumeração de código de erro de execução de dados.

Enums
`DATA_EXECUTION_ERROR_CODE_UNSPECIFIED`	Valor padrão. Não use.
`TIMED_OUT`	A execução dos dados expirou.
`TOO_MANY_ROWS`	A execução dos dados retorna mais linhas do que o limite.
`TOO_MANY_COLUMNS`	A execução dos dados retorna mais colunas do que o limite.
`TOO_MANY_CELLS`	A execução dos dados retorna mais células do que o limite.
`ENGINE`	O erro é recebido do mecanismo de execução de dados de back-end (por exemplo, BigQuery). Confira `errorMessage` para mais detalhes.
`PARAMETER_INVALID`	Um ou alguns dos parâmetros da fonte de dados fornecidos são inválidos.
`UNSUPPORTED_DATA_TYPE`	A execução dos dados retorna um tipo de dados não aceito.
`DUPLICATE_COLUMN_NAMES`	A execução dos dados retorna nomes ou aliases duplicados de colunas.
`INTERRUPTED`	A execução de dados é interrompida. Atualize mais tarde.
`CONCURRENT_QUERY`	A execução de dados está em andamento e não pode ser atualizada até que seja concluída.
`OTHER`	Outros erros.
`TOO_MANY_CHARS_PER_CELL`	A execução dos dados retorna valores que excedem o número máximo de caracteres permitidos em uma única célula.
`DATA_NOT_FOUND`	O banco de dados referenciado pela fonte de dados não foi encontrado. */
`PERMISSION_DENIED`	O usuário não tem acesso ao banco de dados referenciado pela fonte de dados.
`MISSING_COLUMN_ALIAS`	A execução dos dados retorna colunas sem alias.
`OBJECT_NOT_FOUND`	O objeto da origem de dados não existe.
`OBJECT_IN_ERROR_STATE`	O objeto da fonte de dados está em estado de erro. Para forçar a atualização, defina `force` em `RefreshDataSourceRequest`.
`OBJECT_SPEC_INVALID`	A especificação do objeto da fonte de dados é inválida.
`DATA_EXECUTION_CANCELLED`	A execução de dados foi cancelada.

ExtendedValue

Os tipos de valor que uma célula em uma planilha pode ter.

Representação JSON

Representação JSON
{ // Union field `value` can be only one of the following: "numberValue": number, "stringValue": string, "boolValue": boolean, "formulaValue": string, "errorValue": { object (`ErrorValue`) } // End of list of possible types for union field `value`. }

{

  // Union field value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}

Campos
Campo de união `value`. O tipo de valor em uma célula. Se nenhum campo for definido, a célula não terá dados. `value` pode ser apenas um dos seguintes:
`numberValue`	`number` Representa um valor duplo. Observação: datas, horários e datas e horas são representados como números reais no formato `SERIAL_NUMBER`.
`stringValue`	`string` Representa um valor de string. As aspas simples iniciais não são incluídas. Por exemplo, se o usuário digitar `'123` na interface, isso será representado como um `stringValue` de `"123"`.
`boolValue`	`boolean` Representa um valor booleano.
`formulaValue`	`string` Representa uma fórmula.
`errorValue`	`object (ErrorValue)` Representa um erro. Este campo é somente leitura.

ErrorValue

Um erro em uma célula.

Representação JSON
{ "type": enum (`ErrorType`), "message": string }

Campos

Campos
`type`	`enum (ErrorType)` O tipo de erro.
`message`	`string` Uma mensagem com mais informações sobre o erro (no idioma da planilha).

type

enum (ErrorType)

O tipo de erro.

message

string

Uma mensagem com mais informações sobre o erro (no idioma da planilha).

ErrorType

O tipo de erro.

Enums
`ERROR_TYPE_UNSPECIFIED`	O tipo de erro padrão, não use isso.
`ERROR`	Corresponde ao erro `#ERROR!`.
`NULL_VALUE`	Corresponde ao erro `#NULL!`.
`DIVIDE_BY_ZERO`	Corresponde ao erro `#DIV/0`.
`VALUE`	Corresponde ao erro `#VALUE!`.
`REF`	Corresponde ao erro `#REF!`.
`NAME`	Corresponde ao erro `#NAME?`.
`NUM`	Corresponde ao erro `#NUM!`.
`N_A`	Corresponde ao erro `#N/A`.
`LOADING`	Corresponde ao estado `Loading...`.

BooleanCondition

Uma condição que pode ser avaliada como verdadeira ou falsa. As condições booleanas são usadas pela formatação condicional, pela validação de dados e pelos critérios nos filtros.

Representação JSON
{ "type": enum (`ConditionType`), "values": [ { object (`ConditionValue`) } ] }

Campos

Campos
`type`	`enum (ConditionType)` O tipo de condição.
`values[]`	`object (ConditionValue)` Os valores da condição. O número de valores aceitos depende do `condition type`. Alguns aceitam zero valores, outros um ou dois valores, e `ConditionType.ONE_OF_LIST` aceita um número arbitrário de valores.

type

enum (ConditionType)

O tipo de condição.

values[]

object (ConditionValue)

Os valores da condição. O número de valores aceitos depende do condition type. Alguns aceitam zero valores, outros um ou dois valores, e ConditionType.ONE_OF_LIST aceita um número arbitrário de valores.

ConditionType

O tipo de condição.

Enums
`CONDITION_TYPE_UNSPECIFIED`	O valor padrão, não use.
`NUMBER_GREATER`	O valor da célula precisa ser maior que o da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue`.
`NUMBER_GREATER_THAN_EQ`	O valor da célula precisa ser maior ou igual ao valor da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue`.
`NUMBER_LESS`	O valor da célula precisa ser menor que o valor da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue`.
`NUMBER_LESS_THAN_EQ`	O valor da célula precisa ser menor ou igual ao valor da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue`.
`NUMBER_EQ`	O valor da célula precisa ser igual ao da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue` para validação de dados, formatação condicional e filtros em objetos que não são de origem de dados e pelo menos um `ConditionValue` para filtros em objetos de origem de dados.
`NUMBER_NOT_EQ`	O valor da célula não pode ser igual ao da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue` para validação de dados, formatação condicional e filtros em objetos que não são de origem de dados e pelo menos um `ConditionValue` para filtros em objetos de origem de dados.
`NUMBER_BETWEEN`	O valor da célula precisa estar entre os dois valores da condição. Suporte de validação de dados, formatação condicional e filtros. Requer exatamente duas `ConditionValues`.
`NUMBER_NOT_BETWEEN`	O valor da célula não pode estar entre os dois valores da condição. Suporte de validação de dados, formatação condicional e filtros. Requer exatamente duas `ConditionValues`.
`TEXT_CONTAINS`	O valor da célula precisa conter o valor da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue`.
`TEXT_NOT_CONTAINS`	O valor da célula não pode conter o valor da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue`.
`TEXT_STARTS_WITH`	O valor da célula precisa começar com o valor da condição. Suporte para formatação condicional e filtros. Requer um único `ConditionValue`.
`TEXT_ENDS_WITH`	O valor da célula precisa terminar com o valor da condição. Suporte para formatação condicional e filtros. Requer um único `ConditionValue`.
`TEXT_EQ`	O valor da célula precisa ser exatamente o valor da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue` para validação de dados, formatação condicional e filtros em objetos que não são de origem de dados e pelo menos um `ConditionValue` para filtros em objetos de origem de dados.
`TEXT_IS_EMAIL`	O valor da célula precisa ser um endereço de e-mail válido. Suporte à validação de dados. Não requer `ConditionValues`.
`TEXT_IS_URL`	O valor da célula precisa ser um URL válido. Suporte à validação de dados. Não requer `ConditionValues`.
`DATE_EQ`	O valor da célula precisa ser a mesma data do valor da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue` para validação de dados, formatação condicional e filtros em objetos que não são de origem de dados e pelo menos um `ConditionValue` para filtros em objetos de origem de dados.
`DATE_BEFORE`	O valor da célula precisa ser anterior à data do valor da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue` que pode ser um `relative date`.
`DATE_AFTER`	O valor da célula precisa ser posterior à data do valor da condição. Suporte de validação de dados, formatação condicional e filtros. Requer um único `ConditionValue` que pode ser um `relative date`.
`DATE_ON_OR_BEFORE`	O valor da célula precisa ser igual ou anterior à data do valor da condição. Suporte à validação de dados. Requer um único `ConditionValue` que pode ser um `relative date`.
`DATE_ON_OR_AFTER`	O valor da célula precisa ser igual ou posterior à data do valor da condição. Suporte à validação de dados. Requer um único `ConditionValue` que pode ser um `relative date`.
`DATE_BETWEEN`	O valor da célula precisa estar entre as datas dos dois valores de condição. Suporte à validação de dados. Requer exatamente duas `ConditionValues`.
`DATE_NOT_BETWEEN`	O valor da célula precisa estar fora das datas dos dois valores da condição. Suporte à validação de dados. Requer exatamente duas `ConditionValues`.
`DATE_IS_VALID`	O valor da célula precisa ser uma data. Suporte à validação de dados. Não requer `ConditionValues`.
`ONE_OF_RANGE`	O valor da célula precisa estar listado na grade no intervalo do valor da condição. Suporte à validação de dados. Requer um único `ConditionValue`, e o valor precisa ser um intervalo válido na notação A1.
`ONE_OF_LIST`	O valor da célula precisa estar na lista de valores de condição. Suporte à validação de dados. Oferece suporte a qualquer número de `condition values`, um por item na lista. Os valores não têm suporte a fórmulas.
`BLANK`	O valor da célula precisa estar vazio. Suporte para formatação condicional e filtros. Não requer `ConditionValues`.
`NOT_BLANK`	O valor da célula não pode estar vazio. Suporte para formatação condicional e filtros. Não requer `ConditionValues`.
`CUSTOM_FORMULA`	A fórmula da condição precisa ser avaliada como verdadeira. Suporte de validação de dados, formatação condicional e filtros. Não é compatível com filtros de planilha de fonte de dados. Requer um único `ConditionValue`.
`BOOLEAN`	O valor da célula precisa ser VERDADEIRO/FALSO ou estar na lista de valores de condição. Suporte à validação de dados. Renderiza como uma caixa de seleção de célula. Oferece suporte a zero, um ou dois `ConditionValues`. Nenhum valor indica que a célula precisa ser VERDADEIRO ou FALSO, em que VERDADEIRO é renderizado como marcado e FALSO é renderizado como desmarcado. Um valor indica que a célula será renderizada como marcada quando conter esse valor e desmarcada quando estiver em branco. Dois valores indicam que a célula será renderizada como marcada quando contiver o primeiro valor e desmarcada quando contiver o segundo valor. Por exemplo, ["Sim","Não"] indica que a célula vai renderizar uma caixa marcada quando tiver o valor "Sim" e uma caixa desmarcada quando tiver o valor "Não".
`TEXT_NOT_EQ`	O valor da célula precisa ser exatamente diferente do valor da condição. Suporte de filtros em objetos de fonte de dados. É necessário ter pelo menos um `ConditionValue`.
`DATE_NOT_EQ`	O valor da célula precisa ser exatamente diferente do valor da condição. Suporte de filtros em objetos de fonte de dados. É necessário ter pelo menos um `ConditionValue`.
`FILTER_EXPRESSION`	O valor da célula precisa seguir o padrão especificado. Requer um único `ConditionValue`.

ConditionValue

O valor da condição.

Representação JSON
{ // Union field `value` can be only one of the following: "relativeDate": enum (`RelativeDate`), "userEnteredValue": string // End of list of possible types for union field `value`. }

Campos

Campos
Campo de união `value`. O valor da condição, exatamente um precisa ser definido. `value` pode ser apenas um dos seguintes:
`relativeDate`	`enum (RelativeDate)` Uma data relativa (com base na data atual). Válido apenas se o `type` for `DATE_BEFORE`, `DATE_AFTER`, `DATE_ON_OR_BEFORE` ou `DATE_ON_OR_AFTER`. As datas relativas não são compatíveis com a validação de dados. Elas são compatíveis apenas com a formatação e os filtros condicionais.
`userEnteredValue`	`string` Um valor em que a condição se baseia. O valor é analisado como se o usuário tivesse digitado em uma célula. As fórmulas são aceitas e precisam começar com `=` ou um "+".

Campo de união value. O valor da condição, exatamente um precisa ser definido. value pode ser apenas um dos seguintes:

relativeDate

enum (RelativeDate)

Uma data relativa (com base na data atual). Válido apenas se o type for DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE ou DATE_ON_OR_AFTER.

As datas relativas não são compatíveis com a validação de dados. Elas são compatíveis apenas com a formatação e os filtros condicionais.

userEnteredValue

string

Um valor em que a condição se baseia. O valor é analisado como se o usuário tivesse digitado em uma célula. As fórmulas são aceitas e precisam começar com = ou um "+".

RelativeDate

Controla como uma condição de data é avaliada.

Enums
`RELATIVE_DATE_UNSPECIFIED`	Valor padrão. Não use.
`PAST_YEAR`	O valor é de um ano antes de hoje.
`PAST_MONTH`	O valor é de um mês antes de hoje.
`PAST_WEEK`	O valor é de uma semana antes de hoje.
`YESTERDAY`	O valor é de ontem.
`TODAY`	O valor é hoje.
`TOMORROW`	O valor é amanhã.

GridRange

Um intervalo em uma planilha. Todos os índices são baseados em zero. Os índices são semiabertos, ou seja, o índice inicial é inclusivo e o final é exclusivo: [startIndex, endIndex]. Índices ausentes indicam que o intervalo não tem limite nesse lado.

Por exemplo, se "Sheet1" for o ID da planilha 123456, então:

Sheet1!A1:A1 == sheetId: 123456, startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 1

Sheet1!A3:B4 == sheetId: 123456, startRowIndex: 2, endRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A:B == sheetId: 123456, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A5:B == sheetId: 123456, startRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1 == sheetId: 123456

O índice inicial precisa ser sempre menor ou igual ao índice final. Se o índice inicial for igual ao índice final, o intervalo estará vazio. Os intervalos vazios geralmente não são significativos e são renderizados na interface como #REF!.

Representação JSON
{ "sheetId": integer, "startRowIndex": integer, "endRowIndex": integer, "startColumnIndex": integer, "endColumnIndex": integer }

Campos
`sheetId`	`integer` A planilha em que o intervalo está.
`startRowIndex`	`integer` A linha inicial (incluindo) do intervalo ou não definida se não tiver limite.
`endRowIndex`	`integer` A linha final (exclusiva) do intervalo ou não definida se não tiver limite.
`startColumnIndex`	`integer` A coluna inicial (inclusive) do intervalo ou não definida se não tiver limite.
`endColumnIndex`	`integer` A coluna final (exclusiva) do intervalo ou não definida se for ilimitado.

SortOrder

Uma ordem de classificação.

Enums
`SORT_ORDER_UNSPECIFIED`	Valor padrão. Não use.
`ASCENDING`	Classificar em ordem crescente.
`DESCENDING`	Classificar em ordem decrescente.

FilterSpec

Os critérios de filtro associados a uma coluna específica.

Representação JSON

Representação JSON
{ "filterCriteria": { object (`FilterCriteria`) }, // Union field `reference` can be only one of the following: "columnIndex": integer, "dataSourceColumnReference": { object (`DataSourceColumnReference`) } // End of list of possible types for union field `reference`. }

{
  "filterCriteria": {
    object (FilterCriteria)
  },

  // Union field reference can be only one of the following:
  "columnIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}

Campos
`filterCriteria`	`object (FilterCriteria)` Os critérios da coluna.
Campo de união `reference`. Referência à coluna filtrada. `reference` pode ser apenas um dos seguintes:
`columnIndex`	`integer` O índice de colunas com base em zero.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` Referência a uma coluna da origem de dados.

FilterCriteria

Critérios para mostrar/ocultar linhas em um filtro ou visualização de filtro.

Representação JSON

Representação JSON
{ "hiddenValues": [ string ], "condition": { object (`BooleanCondition`) }, "visibleBackgroundColor": { object (`Color`) }, "visibleBackgroundColorStyle": { object (`ColorStyle`) }, "visibleForegroundColor": { object (`Color`) }, "visibleForegroundColorStyle": { object (`ColorStyle`) } }

{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}

Campos
`hiddenValues[]`	`string` Valores que precisam ser ocultos.
`condition`	`object (BooleanCondition)` Uma condição que precisa ser verdadeira para que os valores sejam mostrados. Isso não substitui `hiddenValues` -- se um valor estiver listado lá, ele ainda estará oculto.
`visibleBackgroundColor (deprecated)`	`object (Color)` Este item está obsoleto. A cor de preenchimento de plano de fundo para filtrar. Somente as células com essa cor de preenchimento são mostradas. Mutuamente exclusivo com `visibleForegroundColor`. Descontinuado: use `visibleBackgroundColorStyle`.
`visibleBackgroundColorStyle`	`object (ColorStyle)` A cor de preenchimento de plano de fundo para filtrar. Somente as células com essa cor de preenchimento são mostradas. Esse campo é mutuamente exclusivo com `visibleForegroundColor` e precisa ser definido como uma cor do tipo RGB. Se `visibleBackgroundColor` também estiver definido, esse campo terá precedência.
`visibleForegroundColor (deprecated)`	`object (Color)` Este item está obsoleto. A cor do primeiro plano a ser usada para filtrar. Somente as células com essa cor do primeiro plano são mostradas. Mutuamente exclusivo com `visibleBackgroundColor`. Descontinuado: use `visibleForegroundColorStyle`.
`visibleForegroundColorStyle`	`object (ColorStyle)` A cor do primeiro plano a ser usada para filtrar. Somente as células com essa cor do primeiro plano são mostradas. Esse campo é mutuamente exclusivo com `visibleBackgroundColor` e precisa ser definido como uma cor do tipo RGB. Se `visibleForegroundColor` também estiver definido, esse campo terá precedência.

SortSpec

Uma ordem de classificação associada a uma linha ou coluna específica.

Representação JSON

Representação JSON
{ "sortOrder": enum (`SortOrder`), "foregroundColor": { object (`Color`) }, "foregroundColorStyle": { object (`ColorStyle`) }, "backgroundColor": { object (`Color`) }, "backgroundColorStyle": { object (`ColorStyle`) }, // Union field `reference` can be only one of the following: "dimensionIndex": integer, "dataSourceColumnReference": { object (`DataSourceColumnReference`) } // End of list of possible types for union field `reference`. }

{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

  // Union field reference can be only one of the following:
  "dimensionIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}

Campos
`sortOrder`	`enum (SortOrder)` Os dados do pedido precisam ser ordenados.
`foregroundColor (deprecated)`	`object (Color)` Este item está obsoleto. A cor de primeiro plano pela qual você quer classificar. As células com essa cor são classificadas na parte de cima. Mutuamente exclusivo com `backgroundColor`. Descontinuado: use `foregroundColorStyle`.
`foregroundColorStyle`	`object (ColorStyle)` A cor de primeiro plano pela qual você quer classificar. As células com essa cor são classificadas na parte de cima. Mutuamente exclusivo com `backgroundColor` e precisa ser uma cor do tipo RGB. Se `foregroundColor` também estiver definido, esse campo terá precedência.
`backgroundColor (deprecated)`	`object (Color)` Este item está obsoleto. A cor de preenchimento de plano de fundo para classificar. As células com essa cor de preenchimento são classificadas na parte de cima. Mutuamente exclusivo com `foregroundColor`. Descontinuado: use `backgroundColorStyle`.
`backgroundColorStyle`	`object (ColorStyle)` A cor de preenchimento de plano de fundo para classificar. As células com essa cor de preenchimento são classificadas na parte de cima. Mutuamente exclusivo com `foregroundColor` e precisa ser uma cor do tipo RGB. Se `backgroundColor` também estiver definido, esse campo terá precedência.
Campo de união `reference`. Referência à dimensão classificada. `reference` pode ser apenas um dos seguintes:
`dimensionIndex`	`integer` A dimensão em que a ordenação será aplicada.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` Referência a uma coluna da origem de dados.

EmbeddedObjectPosition

A posição de um objeto incorporado, como um gráfico.

Representação JSON

Representação JSON
{ // Union field `location` can be only one of the following: "sheetId": integer, "overlayPosition": { object (`OverlayPosition`) }, "newSheet": boolean // End of list of possible types for union field `location`. }

{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}

Campos
Campo de união `location`. O local do objeto. É necessário definir exatamente um valor. `location` pode ser apenas um dos seguintes:
`sheetId`	`integer` A planilha em que ele está. Defina apenas se o objeto incorporado estiver na própria planilha. Não podem ser negativas.
`overlayPosition`	`object (OverlayPosition)` A posição em que o objeto é sobreposto a uma grade.
`newSheet`	`boolean` Se for true, o objeto incorporado será colocado em uma nova planilha com o ID escolhido para você. Usado apenas ao gravar.

OverlayPosition

O local em que um objeto é sobreposto a uma grade.

Representação JSON
{ "anchorCell": { object (`GridCoordinate`) }, "offsetXPixels": integer, "offsetYPixels": integer, "widthPixels": integer, "heightPixels": integer }

Campos
`anchorCell`	`object (GridCoordinate)` A célula em que o objeto está ancorado.
`offsetXPixels`	`integer` O deslocamento horizontal, em pixels, do objeto em relação à célula de âncora.
`offsetYPixels`	`integer` O deslocamento vertical, em pixels, do objeto em relação à célula de âncora.
`widthPixels`	`integer` É a largura do objeto, em pixels. O padrão é 600.
`heightPixels`	`integer` A altura do objeto, em pixels. O padrão é 371.

GridCoordinate

Uma coordenada em uma página. Todos os índices são baseados em zero.

Representação JSON
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer }

Campos

Campos
`sheetId`	`integer` A planilha em que a coordenada está.
`rowIndex`	`integer` O índice da linha da coordenada.
`columnIndex`	`integer` O índice da coluna da coordenada.

sheetId

integer

A planilha em que a coordenada está.

rowIndex

integer

O índice da linha da coordenada.

columnIndex

integer

O índice da coluna da coordenada.

Other Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Cor

ColorStyle

ThemeColorType

HorizontalAlign

TextFormat

Link

DataSourceColumn

DataSourceColumnReference

DataExecutionStatus

DataExecutionState

DataExecutionErrorCode

ExtendedValue

ErrorValue

ErrorType

BooleanCondition

ConditionType

ConditionValue

RelativeDate

GridRange

SortOrder

FilterSpec

FilterCriteria

SortSpec

EmbeddedObjectPosition

OverlayPosition

GridCoordinate

Other