Esta página foi traduzida pela API Cloud Translation.

Other

Cor

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

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

Quando a igualdade de cores precisa ser decidida, as implementações, a menos que documentados de outra forma, tratam duas cores como iguais, se todos os valores vermelho, verde, azul e alfa forem diferentes, 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á processado como uma cor sólida (como se o valor alfa tivesse sido explicitamente atribuído a 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 uma das seguintes opções:
`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 uma das seguintes opções:

rgbColor

object (Color)

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

themeColor

enum (ThemeColorType)

Cor do tema.

Tipo de cor do tema

Tipos de cores do tema.

SpreadsheetProperties contém um SpreadsheetTheme que define um mapeamento desses tipos de cores do 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 primária do plano de fundo
`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

Alinhar na horizontal

O alinhamento horizontal do texto em uma célula.

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

Formato de texto

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 de primeiro plano do texto. Obsoleto: use `foregroundColorStyle`.
`foregroundColorStyle`	`object (ColorStyle)` A cor de primeiro plano do texto. Se `foregroundColor` também estiver definido, este campo terá precedência.
`fontFamily`	`string` A família de fontes.
`fontSize`	`integer` O tamanho da fonte.
`bold`	`boolean` True se o texto estiver em negrito.
`italic`	`boolean` True se o texto estiver em itálico.
`strikethrough`	`boolean` Verdadeiro se o texto tiver um tachado.
`underline`	`boolean` True se o texto estiver sublinhado.
`link`	`object (Link)` O destino do link do texto, se houver. Definir o campo de link em uma `TextFormatRun` limpará os links existentes da célula ou um link no nível da célula definido na mesma solicitação. Quando um link for definido, a cor de primeiro plano do texto será definida para a cor de link padrão e o texto será sublinhado. Se esses campos forem modificados na mesma solicitação, esses valores serão usados no lugar 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 uma das seguintes opções:
`uri`	`string` O identificador do link.

Campo de união destination. O destino do link. destination pode ser apenas uma das seguintes opções:

uri

string

O identificador do link.

Coluna de DataSource

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.

Referência de coluna

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 dentro de uma fonte de dados.

name

string

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

Status de execução de dados

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 uma DataSource. Normalmente, a execução é em segundo plano. Verifique 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 execução:

Adding a data source cria uma página de fonte de dados associada, bem como uma execução de dados para sincronizar os dados da fonte com a página.
Updating a data source cria uma execução de dados para atualizar a página de fonte de dados associada de maneira semelhante.
É possível enviar refresh request para atualizar explicitamente um ou vários objetos da 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)` Obtém a hora em que os dados foram atualizados pela última vez com sucesso.

Estado de execução de dados

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

Enums
`DATA_EXECUTION_STATE_UNSPECIFIED`	Valor padrão, não use.
`NOT_STARTED`	A execução dos dados não foi iniciada.
`RUNNING`	A execução dos dados foi iniciada e está em execução.
`SUCCEEDED`	A execução dos dados foi concluída.
`FAILED`	A execução dos dados foi concluída com erros.

Código de erro de execução de dados

Uma enumeração do 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). Consulte `errorMessage` para mais detalhes.
`PARAMETER_INVALID`	Um ou alguns dos parâmetros de fonte de dados fornecidos são inválidos.
`UNSUPPORTED_DATA_TYPE`	A execução dos dados retorna um tipo de dados não compatível.
`DUPLICATE_COLUMN_NAMES`	A execução dos dados retorna aliases ou nomes de coluna duplicados.
`INTERRUPTED`	A execução dos dados é interrompida. Atualize mais tarde.
`CONCURRENT_QUERY`	A execução dos dados está em andamento. Não é possível atualizá-la até que ela 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 permitido 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 com aliases ausentes.
`OBJECT_NOT_FOUND`	O objeto da fonte 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.

Valor estendido

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

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 uma das seguintes opções:
`numberValue`	`number` Representa um valor duplo. Observação: datas, horários e datas e horas são representados como duplas no formato `SERIAL_NUMBER`.
`stringValue`	`string` Representa um valor de string. Aspas simples iniciais não estão incluídas. Por exemplo, se o usuário digitou `'123` na IU, 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.

Valor de erro

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 (na localidade da planilha).

type

enum (ErrorType)

O tipo de erro.

message

string

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

ErrorType

O tipo de erro.

Enums
`ERROR_TYPE_UNSPECIFIED`	O tipo de erro padrão, não o use.
`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...`.

Condição booleana

Condição que pode ser avaliada como verdadeira ou falsa. BooleanConditions são usados por formatação condicional, validação de dados e critérios em 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 compatíveis depende do `condition type`. Alguns são compatíveis com 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 compatíveis depende do condition type. Alguns são compatíveis com zero valores, outros um ou dois valores e ConditionType.ONE_OF_LIST aceita um número arbitrário de valores.

Tipo de condição

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. Compatível com 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. Compatível com 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 da condição. Compatível com 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. Compatível com 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. Compatível com 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 sejam de fonte de dados e pelo menos um `ConditionValue` para filtros em objetos de fonte de dados.
`NUMBER_NOT_EQ`	O valor da célula não pode ser igual ao da condição. Compatível com 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 sejam de fonte de dados e pelo menos um `ConditionValue` para filtros em objetos de fonte de dados.
`NUMBER_BETWEEN`	O valor da célula precisa estar entre os dois valores de condição. Compatível com validação de dados, formatação condicional e filtros. Requer exatamente dois `ConditionValues`.
`NUMBER_NOT_BETWEEN`	O valor da célula não pode ficar entre os dois valores de condição. Compatível com validação de dados, formatação condicional e filtros. Requer exatamente dois `ConditionValues`.
`TEXT_CONTAINS`	O valor da célula precisa conter o valor da condição. Compatível com 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. Compatível com 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. Compatível com formatação e filtros condicionais. Requer um único `ConditionValue`.
`TEXT_ENDS_WITH`	O valor da célula deve terminar com o valor da condição. Compatível com formatação e filtros condicionais. Requer um único `ConditionValue`.
`TEXT_EQ`	O valor da célula precisa ser exatamente igual ao da condição. Compatível com 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 sejam de fonte de dados e pelo menos um `ConditionValue` para filtros em objetos de fonte de dados.
`TEXT_IS_EMAIL`	O valor da célula precisa ser um endereço de e-mail válido. Compatível com validação de dados. Não requer `ConditionValues`.
`TEXT_IS_URL`	O valor da célula precisa ser um URL válido. Compatível com validação de dados. Não requer `ConditionValues`.
`DATE_EQ`	O valor da célula precisa ser a mesma que o valor da condição. Compatível com 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 sejam de fonte de dados e pelo menos um `ConditionValue` para filtros em objetos de fonte de dados.
`DATE_BEFORE`	O valor da célula deve ser anterior à data do valor da condição. Compatível com 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 deve ser posterior à data do valor da condição. Compatível com 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. Compatível com 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. Compatível com validação de dados. Requer um único `ConditionValue` que pode ser um `relative date`.
`DATE_BETWEEN`	O valor da célula deve estar entre as datas dos dois valores de condição. Compatível com validação de dados. Requer exatamente dois `ConditionValues`.
`DATE_NOT_BETWEEN`	O valor da célula deve estar fora das datas dos dois valores de condição. Compatível com validação de dados. Requer exatamente dois `ConditionValues`.
`DATE_IS_VALID`	O valor da célula deve ser uma data. Compatível com 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. Compatível com 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. Compatível com validação de dados. Aceita qualquer número de `condition values`, um por item na lista. Não é possível usar fórmulas nos valores.
`BLANK`	O valor da célula precisa estar vazio. Compatível com formatação e filtros condicionais. Não requer `ConditionValues`.
`NOT_BLANK`	O valor da célula não pode ficar em branco. Compatível com formatação e filtros condicionais. Não requer `ConditionValues`.
`CUSTOM_FORMULA`	A fórmula da condição precisa ser avaliada como verdadeira. Compatível com validação de dados, formatação condicional e filtros. Incompatível com filtros de página da fonte de dados. Requer um único `ConditionValue`.
`BOOLEAN`	O valor da célula precisa ser VERDADEIRO/FALSO ou na lista de valores de condição. Compatível com validação de dados. Renderiza como uma caixa de seleção de célula. Aceita zero, um ou dois `ConditionValues`. Nenhum valor indica que a célula precisa ser VERDADEIRO ou FALSO, em que VERDADEIRO é processado como verificado e FALSO é renderizado como desmarcado. Um valor indica que a célula será processada como marcada quando contiver esse valor e desmarcada quando estiver em branco. Dois valores indicam que a célula será processada como verificada quando contiver o primeiro valor e desmarcada quando contiver o segundo valor. Por exemplo, ["Sim","Não"] indica que a célula 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 não pode ser igual ao da condição. Compatível com filtros em objetos da fonte de dados. Requer pelo menos um `ConditionValue`.
`DATE_NOT_EQ`	O valor da célula não pode ser igual ao da condição. Compatível com filtros em objetos da fonte de dados. Requer pelo menos um `ConditionValue`.
`FILTER_EXPRESSION`	O valor da célula precisa seguir o padrão especificado. Requer um único `ConditionValue`.

Valor de condição

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 deve ser definido. `value` pode ser apenas uma das seguintes opções:
`relativeDate`	`enum (RelativeDate)` Uma data relativa (com base na data atual). Válido apenas se `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. Eles são compatíveis apenas com formatação condicional e filtros condicionais.
`userEnteredValue`	`string` Um valor no qual a condição é baseada. O valor é analisado como se o usuário tivesse digitado uma célula. As fórmulas são compatíveis e precisam começar com `=` ou "+".

Campo de união value. O valor da condição. Exatamente um deve ser definido. value pode ser apenas uma das seguintes opções:

relativeDate

enum (RelativeDate)

Uma data relativa (com base na data atual). Válido apenas se 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. Eles são compatíveis apenas com formatação condicional e filtros condicionais.

userEnteredValue

string

Um valor no qual a condição é baseada. O valor é analisado como se o usuário tivesse digitado uma célula. As fórmulas são compatíveis e precisam começar com = ou "+".

RelativeDate

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

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

Grade

Um intervalo em uma página. Todos os índices são baseados em zero. Os índices estão parcialmente abertos, isto é, o índice inicial é inclusivo e o índice final é exclusivo -- [startIndex, endIndex). Índices ausentes indicam que o intervalo é ilimitado nesse lado.

Por exemplo, se "Sheet1" for o código da página 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 geralmente são renderizados na IU como #REF!.

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

Campos
`sheetId`	`integer` A página na qual esse intervalo está.
`startRowIndex`	`integer` A linha inicial (inclusive) do intervalo, ou não é definida se for ilimitada.
`endRowIndex`	`integer` A linha final (exclusiva) do intervalo, ou não é definida se for ilimitada.
`startColumnIndex`	`integer` A coluna de início (inclusive) do intervalo ou não é definida se for ilimitada.
`endColumnIndex`	`integer` A coluna final (exclusiva) do intervalo ou não é definida se for ilimitada.

SortOrder

Uma ordem de classificação.

Enums
`SORT_ORDER_UNSPECIFIED`	Valor padrão, não use.
`ASCENDING`	Ordenar por ordem crescente.
`DESCENDING`	Classificar por 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 uma das seguintes opções:
`columnIndex`	`integer` O índice de coluna com base em zero.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` Referência a uma coluna de fonte de dados.

Critérios de filtro

Critérios para mostrar/ocultar linhas em um filtro ou uma visualização com 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 devem ser ocultados.
`condition`	`object (BooleanCondition)` Uma condição que precisa ser verdadeira para os valores serem mostrados. Isso não substitui `hiddenValues`. Se um valor for listado, ele ainda ficará oculto.
`visibleBackgroundColor (deprecated)`	`object (Color)` Este item está obsoleto. A cor de preenchimento do plano de fundo para filtrar. Somente as células com essa cor são exibidas. Mutuamente exclusivo com `visibleForegroundColor`. Obsoleto: use `visibleBackgroundColorStyle`.
`visibleBackgroundColorStyle`	`object (ColorStyle)` A cor de preenchimento do plano de fundo para filtrar. Somente as células com essa cor são exibidas. Este campo é mutuamente exclusivo com `visibleForegroundColor` e precisa ser definido como uma cor do tipo RGB. Se `visibleBackgroundColor` também estiver definido, este campo terá precedência.
`visibleForegroundColor (deprecated)`	`object (Color)` Este item está obsoleto. A cor de primeiro plano a ser filtrada. Somente as células com essa cor são exibidas. Mutuamente exclusivo com `visibleBackgroundColor`. Obsoleto: use `visibleForegroundColorStyle`.
`visibleForegroundColorStyle`	`object (ColorStyle)` A cor de primeiro plano a ser filtrada. Somente as células com essa cor são exibidas. Este campo é mutuamente exclusivo com `visibleBackgroundColor` e precisa ser definido como uma cor do tipo RGB. Se `visibleForegroundColor` também estiver definido, este campo terá precedência.

Classificar

Uma ordem de classificação associada a uma coluna ou linha 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 devem ser classificados.
`foregroundColor (deprecated)`	`object (Color)` Este item está obsoleto. A cor de primeiro plano a ser classificada. As células com essa cor em primeiro plano são classificadas na parte superior. Mutuamente exclusivo com `backgroundColor`. Obsoleto: use `foregroundColorStyle`.
`foregroundColorStyle`	`object (ColorStyle)` A cor de primeiro plano a ser classificada. As células com essa cor em primeiro plano são classificadas na parte superior. Mutuamente exclusivo com `backgroundColor` e precisa ser uma cor do tipo RGB. Se `foregroundColor` também estiver definido, este campo terá precedência.
`backgroundColor (deprecated)`	`object (Color)` Este item está obsoleto. A cor de preenchimento do plano de fundo para classificação. As células com essa cor são classificadas na parte superior. Mutuamente exclusivo com `foregroundColor`. Obsoleto: use `backgroundColorStyle`.
`backgroundColorStyle`	`object (ColorStyle)` A cor de preenchimento do plano de fundo para classificação. As células com essa cor são classificadas na parte superior. Mutuamente exclusivo com `foregroundColor` e precisa ser uma cor do tipo RGB. Se `backgroundColor` também estiver definido, este campo terá precedência.
Campo de união `reference`. Referência à dimensão classificada. `reference` pode ser apenas uma das seguintes opções:
`dimensionIndex`	`integer` A dimensão à qual a classificação deve ser aplicada.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` Referência a uma coluna de fonte 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. É preciso definir exatamente um valor. `location` pode ser apenas uma das seguintes opções:
`sheetId`	`integer` Esta é a planilha. Definido apenas se o objeto incorporado estiver em sua própria página. Não podem ser negativas.
`overlayPosition`	`object (OverlayPosition)` A posição na qual o objeto é sobreposto em uma grade.
`newSheet`	`boolean` Se verdadeiro, o objeto incorporado será colocado em uma nova página cujo ID será escolhido para você. Usado apenas ao escrever.

SobreposiçãoPosição

O local sobre o qual um objeto é sobreposto em uma grade.

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

Campos
`anchorCell`	`object (GridCoordinate)` A célula à qual o objeto está ancorado.
`offsetXPixels`	`integer` O deslocamento horizontal, em pixels, em que o objeto é deslocado da célula âncora.
`offsetYPixels`	`integer` O deslocamento vertical, em pixels, em que o objeto é deslocado da célula â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.

Coordenada em grade

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 página na qual esta coordenada está.
`rowIndex`	`integer` O índice da linha da coordenada.
`columnIndex`	`integer` O índice de colunas da coordenada.

sheetId

integer

A página na qual esta coordenada está.

rowIndex

integer

O índice da linha da coordenada.

columnIndex

integer

O índice de colunas da coordenada.