Dados do celular
Dados sobre uma célula específica.
Representação JSON |
---|
{ "userEnteredValue": { object ( |
Campos | |
---|---|
userEnteredValue
|
O valor que o usuário inseriu na célula. Por exemplo,
|
effectiveValue
|
O valor efetivo da célula. Para células com fórmulas, esse é o valor calculado. Para células com literais, é igual a userEnteredValue. Este campo é somente leitura. |
formattedValue
|
O valor formatado da célula. Esse é o valor mostrado para o usuário. Este campo é somente leitura. |
userEnteredFormat
|
O formato que o usuário inseriu para a célula. Ao escrever, o novo formato será mesclado com o formato existente. |
effectiveFormat
|
O formato efetivo usado pela célula. Isso inclui os resultados da aplicação de qualquer formatação condicional e, se a célula contiver uma fórmula, o formato de número calculado. Se o formato efetivo for o padrão, ele não será gravado. Este campo é somente leitura. |
hyperlink
|
Um hiperlink para esta célula, se houver. Se a célula contiver vários hiperlinks, esse campo estará vazio. Este campo é somente leitura. Para defini-la, use uma fórmula |
note
|
Qualquer nota na célula. |
textFormatRuns[]
|
São execuções de rich text aplicadas às subseções da célula. As execuções são válidas apenas em strings inseridas pelo usuário, não em fórmulas, booleanos ou números. As propriedades de uma execução começam em um índice específico no texto e continuam até a próxima execução. As execuções herdarão as propriedades da célula, a menos que sejam explicitamente alteradas.
Ao escrever, as novas execuções substituirão as execuções anteriores. Ao gravar um novo |
dataValidation
|
Uma regra de validação de dados na célula, se houver. Durante a gravação, a nova regra de validação de dados substituirá qualquer regra anterior. |
pivotTable
|
Uma tabela dinâmica ancorada nessa célula. O tamanho da tabela dinâmica é calculado dinamicamente com base nos dados, agrupamentos, filtros, valores etc. Apenas a célula superior esquerda da tabela dinâmica contém a definição da tabela dinâmica. As outras células terão os valores calculados dos resultados da tabela dinâmica nos campos |
dataSourceTable
|
Uma tabela de fonte de dados ancorada nessa célula. O tamanho da própria tabela de fonte de dados é calculado dinamicamente com base na configuração. Apenas a primeira célula da tabela de fonte de dados contém a definição da tabela de fonte de dados. As outras células terão os valores de exibição da tabela de fonte de dados como resultado nos campos |
dataSourceFormula
|
Apenas saída. Informações sobre uma fórmula de fonte de dados na célula. O campo será definido se |
Formato de célula
O formato de uma célula.
Representação JSON |
---|
{ "numberFormat": { object ( |
Campos | |
---|---|
numberFormat
|
Um formato que descreve como os valores numéricos devem ser representados pelo usuário. |
backgroundColor
|
A cor de plano de fundo da célula. Obsoleto: use |
backgroundColorStyle
|
A cor de plano de fundo da célula. Se |
borders
|
As bordas da célula. |
padding
|
O padding da célula. |
horizontalAlignment
|
O alinhamento horizontal do valor na célula. |
verticalAlignment
|
O alinhamento vertical do valor na célula. |
wrapStrategy
|
A estratégia de ajuste do valor na célula. |
textDirection
|
A direção do texto na célula. |
textFormat
|
O formato do texto na célula (a menos que seja substituído por um formato). Definir um link no nível da célula aqui limpa os links existentes na célula. Definir o campo de link em um |
hyperlinkDisplayType
|
Se houver, como um hiperlink deverá ser exibido na célula. |
textRotation
|
A rotação aplicada ao texto na célula. |
NumberFormat
O formato de número de uma célula.
Representação JSON |
---|
{
"type": enum (
|
Campos | |
---|---|
type
|
O tipo de formato de número. Ao escrever, este campo deve ser definido. |
pattern
|
String de padrão usada para formatação. Se não for definido, um padrão padrão com base na localidade do usuário será usado, se necessário, para o tipo especificado. Consulte o guia de formatos de data e número para mais informações sobre os padrões compatíveis. |
Tipo de formato de número
O formato de número da célula. Nesta documentação, presume-se que a localidade é en_US, mas o formato real depende da localidade da planilha.
Enums | |
---|---|
NUMBER_FORMAT_TYPE_UNSPECIFIED
|
O formato de número não é especificado e é baseado no conteúdo da célula. Não use isso explicitamente. |
TEXT
|
Formatação de texto, por exemplo, 1000.12
|
NUMBER
|
Formatação de números, por exemplo, 1,000.12
|
PERCENT
|
Formatação percentual, por exemplo, 10.12%
|
CURRENCY
|
Formatação de moedas, por exemplo, $1,000.12
|
DATE
|
Formatação de data, por exemplo, 9/26/2008
|
TIME
|
Formatação de hora, por exemplo, 3:59:00 PM
|
DATE_TIME
|
Formatação de data e hora, por exemplo, 9/26/08 15:59:00
|
SCIENTIFIC
|
Formatação de números científicos, por exemplo, 1.01E+03
|
Bordas
As bordas da célula.
Representação JSON |
---|
{ "top": { object ( |
Campos | |
---|---|
top
|
A borda superior da célula. |
bottom
|
A borda inferior da célula. |
left
|
A borda esquerda da célula. |
right
|
A borda direita da célula. |
Borda
Uma borda ao longo de uma célula.
Representação JSON |
---|
{ "style": enum ( |
Campos | |
---|---|
style
|
O estilo da borda. |
width
|
A largura da borda em pixels. Obsoleto. A largura é determinada pelo campo "style". |
color
|
A cor da borda. Obsoleto: use |
colorStyle
|
A cor da borda. Se |
Estilo
O estilo de uma borda.
Enums | |
---|---|
STYLE_UNSPECIFIED
|
O estilo não foi especificado. Não use. |
DOTTED
|
A borda é pontilhada. |
DASHED
|
A borda está tracejada. |
SOLID
|
A borda é uma linha sólida fina. |
SOLID_MEDIUM
|
A borda é uma linha sólida média. |
SOLID_THICK
|
A borda é uma linha sólida grossa. |
NONE
|
Sem borda. Usado apenas para atualizar uma borda para apagá-la. |
DOUBLE
|
A borda são duas linhas sólidas. |
Padding
A quantidade de preenchimento em torno da célula, em pixels. Ao atualizar o preenchimento, todos os campos devem ser especificados.
Representação JSON |
---|
{ "top": integer, "right": integer, "bottom": integer, "left": integer } |
Campos | |
---|---|
top
|
O padding superior da célula. |
right
|
O padding direito da célula. |
bottom
|
O padding inferior da célula. |
left
|
O padding esquerdo da célula. |
Alinhar na vertical
O alinhamento vertical do texto em uma célula.
Enums | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
O alinhamento vertical não foi especificado. Não use. |
TOP
|
O texto é alinhado explicitamente à parte superior da célula. |
MIDDLE
|
O texto é explicitamente alinhado ao meio da célula. |
BOTTOM
|
O texto é explicitamente alinhado à parte inferior da célula. |
Quebra de estratégia
Como ajustar o texto em uma célula.
Enums | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
O valor padrão, não use. |
OVERFLOW_CELL
|
As linhas que forem maiores que a largura da célula serão escritas na célula seguinte, contanto que ela esteja vazia. Se a próxima célula não estiver vazia, isso se comportará da mesma forma que
|
LEGACY_WRAP
|
Essa estratégia de quebra representa a antiga estratégia de quebra de linha do Planilhas Google, em que as palavras mais longas que uma linha são cortadas em vez de quebradas. Essa estratégia não é compatível com todas as plataformas e está sendo desativada. Exemplo:
|
CLIP
|
As linhas que ultrapassarem a largura da célula serão cortadas. O texto nunca será exibido na próxima linha, a menos que o usuário insira manualmente uma nova linha. Exemplo:
|
WRAP
|
As palavras mais longas que uma linha são quebradas no nível do caractere em vez de serem cortadas. Exemplo:
|
Direção do texto
A direção do texto em uma célula.
Enums | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
A direção do texto não foi especificada. Não use. |
LEFT_TO_RIGHT
|
A direção do texto da esquerda para a direita foi definida pelo usuário. |
RIGHT_TO_LEFT
|
A direção do texto da direita para a esquerda foi definida pelo usuário. |
HyperlinkDisplayType
Indica se é necessário renderizar um hiperlink explicitamente. Se não for especificado, o hiperlink será vinculado.
Enums | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
O valor padrão: o hiperlink é renderizado. Não use. |
LINKED
|
Um hiperlink precisa ser renderizado explicitamente. |
PLAIN_TEXT
|
Um hiperlink não deve ser renderizado. |
Rotação do texto
A rotação aplicada ao texto em uma célula.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união type . O tipo de rotação, vertical ou angular.
type pode ser apenas uma das seguintes opções:
|
|
angle
|
O ângulo entre a orientação padrão e a orientação desejada. Medida em graus. Os valores válidos estão entre -90 e 90. Os ângulos positivos são inclinados para cima, e os negativos, para baixo. Observação: para texto em LTR, os ângulos positivos estão no sentido anti-horário. Para RTL, eles estão no sentido horário. |
vertical
|
Se verdadeiro, o texto será lido de cima para baixo, mas a orientação de caracteres individuais não será alterada. Por exemplo:
|
TextFormatRun.
Uma execução de um formato de texto. O formato dessa execução continua até o índice inicial da próxima execução. Ao atualizar, todos os campos precisam ser definidos.
Representação JSON |
---|
{
"startIndex": integer,
"format": {
object (
|
Campos | |
---|---|
startIndex
|
O índice de caracteres baseado em zero onde essa execução começa, em unidades de código UTF-16. |
format
|
O formato dessa execução. Os valores ausentes herdam o formato da célula. |
Regra de validação de dados
Uma regra de validação de dados.
Representação JSON |
---|
{
"condition": {
object (
|
Campos | |
---|---|
condition
|
A condição na qual os dados na célula devem corresponder. |
inputMessage
|
Uma mensagem para mostrar ao usuário ao adicionar dados à célula. |
strict
|
Verdadeiro se os dados inválidos forem rejeitados. |
showCustomUi
|
Verdadeiro se a IU precisa ser personalizada com base no tipo de condição. Se for verdadeiro, as condições "Lista" exibirão um menu suspenso. |
Tabela de DataSource
Uma tabela de fonte de dados, que permite ao usuário importar uma tabela estática de dados do DataSource
para o Planilhas. Isso também é conhecido como "Extrair" no editor do Planilhas.
Representação JSON |
---|
{ "dataSourceId": string, "columnSelectionType": enum ( |
Campos | |
---|---|
dataSourceId
|
O ID da fonte de dados à qual a tabela de fonte de dados está associada. |
columnSelectionType
|
O tipo para selecionar colunas para a tabela de fonte de dados. O padrão é |
columns[]
|
Colunas selecionadas para a tabela de fonte de dados. O |
filterSpecs[]
|
Filtre as especificações na tabela de fonte de dados. |
sortSpecs[]
|
Classifique as especificações na tabela de fonte de dados. O resultado da tabela da fonte de dados é classificado com base nas especificações de classificação em ordem. |
rowLimit
|
O limite de linhas a serem retornadas. Se não for definido, um limite padrão será aplicado. Consulte o editor de planilhas para ver os limites padrão e máximo. |
dataExecutionStatus
|
Apenas saída. O status de execução dos dados. |
Tipo: colunaColunaSeleção
Os tipos de seleção de coluna da tabela de fonte de dados.
Enums | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED
|
O tipo de seleção de coluna padrão, não use. |
SELECTED
|
Selecione colunas especificadas pelo campo columns .
|
SYNC_ALL
|
Sincronize todas as colunas atuais e futuras na fonte de dados. Se definida, a tabela de fonte de dados busca todas as colunas na fonte de dados no momento da atualização. |
Fórmula
Uma fórmula de fonte de dados.
Representação JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object (
|
Campos | |
---|---|
dataSourceId
|
O código da fonte de dados à qual a fórmula está associada. |
dataExecutionStatus
|
Apenas saída. O status de execução dos dados. |