Planilha
Uma página em uma planilha.
Representação JSON |
---|
{ "properties": { object ( |
Campos | |
---|---|
properties
|
As propriedades da planilha. |
data[]
|
Dados na grade, se esta for uma planilha de grade.
O número de objetos GridData retornados depende do número de intervalos solicitados na planilha. Por exemplo, se isso representa
Para uma
planilha
|
merges[]
|
Os intervalos que são mesclados. |
conditionalFormats[]
|
As regras de formatação condicional nesta página. |
filterViews[]
|
As visualizações com filtro nesta página. |
protectedRanges[]
|
Os intervalos protegidos nesta página. |
basicFilter
|
O filtro na planilha, se houver. |
charts[]
|
As especificações de cada gráfico nesta página. |
bandedRanges[]
|
Os intervalos de faixas (cores alternadas) nesta planilha. |
developerMetadata[]
|
Os metadados do desenvolvedor associados a uma planilha. |
rowGroups[]
|
Todos os grupos de linhas na planilha, ordenados pelo índice de início do intervalo crescente e depois pela profundidade do grupo. |
columnGroups[]
|
Todos os grupos de colunas na planilha, ordenados pelo índice de início do intervalo crescente e depois pela profundidade do grupo. |
slicers[]
|
Os seções desta planilha. |
tables[]
|
As tabelas desta página. |
SheetProperties
Propriedades de uma planilha.
Representação JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Campos | |
---|---|
sheetId
|
O ID da planilha. Não podem ser negativas. Não é possível mudar esse campo depois de definido. |
title
|
O nome da planilha. |
index
|
O índice da página na planilha. Ao adicionar ou atualizar propriedades da planilha, se esse campo for excluído, a planilha será adicionada ou movida para o final da lista de planilhas. Ao atualizar índices de planilha ou inserir planilhas, o movimento é considerado nos índices "antes da movimentação". Por exemplo, se houver três planilhas (S1, S2, S3), para mover a S1 à frente da S2, o índice terá que ser definido como 2. Uma solicitação de atualização do índice da página é ignorada se o índice solicitado for idêntico ao índice atual da página ou se o novo índice solicitado for igual ao índice atual da página + 1. |
sheetType
|
O tipo de página. O padrão é
|
gridProperties
|
Propriedades adicionais da planilha, se ela for uma grade. Se a planilha for uma planilha de objetos, contendo um gráfico ou uma imagem, esse campo não vai estar presente. Ao escrever, é um erro definir propriedades de grade em folhas que não são de grade.
Se essa planilha for uma
|
tabColor
|
A cor da guia na interface. Descontinuado: use
|
tabColorStyle
|
A cor da guia na interface. Se
|
rightToLeft
|
Verdadeiro se a planilha for RTL em vez de LTR. |
dataSourceSheetProperties
|
Apenas saída. Se presente, o campo contém propriedades específicas da planilha |
SheetType
O tipo de folha.
Enums | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Valor padrão. Não use. |
GRID
|
A folha é uma grade. |
OBJECT
|
A planilha não tem grade, mas um objeto, como um gráfico ou uma imagem. |
DATA_SOURCE
|
A página se conecta a um DataSource
externo e mostra a visualização dos dados.
|
GridProperties
Propriedades de uma grade.
Representação JSON |
---|
{ "rowCount": integer, "columnCount": integer, "frozenRowCount": integer, "frozenColumnCount": integer, "hideGridlines": boolean, "rowGroupControlAfter": boolean, "columnGroupControlAfter": boolean } |
Campos | |
---|---|
rowCount
|
O número de linhas na grade. |
columnCount
|
O número de colunas na grade. |
frozenRowCount
|
O número de linhas congeladas na grade. |
frozenColumnCount
|
O número de colunas congeladas na grade. |
hideGridlines
|
Verdadeiro se a grade não estiver mostrando linhas de grade na interface. |
rowGroupControlAfter
|
Verdadeiro se o controle de agrupamento de linhas for mostrado após o grupo. |
columnGroupControlAfter
|
Verdadeiro se o controle de agrupamento de colunas for mostrado após o grupo. |
DataSourceSheetProperties
Propriedades adicionais de uma
folha
DATA_SOURCE
.
Representação JSON |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Campos | |
---|---|
dataSourceId
|
ID do
|
columns[]
|
As colunas exibidas na página, correspondendo aos valores em
|
dataExecutionStatus
|
O status de execução dos dados. |
GridData
Dados na grade e metadados sobre as dimensões.
Representação JSON |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
Campos | |
---|---|
startRow
|
A primeira linha a que GridData se refere, com base em zero. |
startColumn
|
A primeira coluna a que GridData se refere, com base em zero. |
rowData[]
|
Os dados na grade, uma entrada por linha, começando pela linha em startRow. Os valores em RowData correspondem às colunas a partir de
|
rowMetadata[]
|
Metadados sobre as linhas solicitadas na grade, começando pela linha em
|
columnMetadata[]
|
Metadados sobre as colunas solicitadas na grade, começando pela coluna em |
RowData
Dados sobre cada célula em uma linha.
Representação JSON |
---|
{
"values": [
{
object ( |
Campos | |
---|---|
values[]
|
Os valores na linha, um por coluna. |
DimensionProperties
Propriedades sobre uma dimensão.
Representação JSON |
---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
Campos | |
---|---|
pixelSize
|
A altura (se for uma linha) ou a largura (se for uma coluna) da dimensão em pixels. |
developerMetadata[]
|
Os metadados do desenvolvedor associados a uma única linha ou coluna. |
dataSourceColumnReference
|
Apenas saída. Se definido, é uma coluna em uma planilha de fonte de dados. |
ConditionalFormatRule
Uma regra que descreve uma formatação condicional.
Representação JSON |
---|
{ "ranges": [ { object ( |
Campos | |
---|---|
ranges[]
|
Os intervalos formatados se a condição for verdadeira. Todos os intervalos precisam estar na mesma grade. |
Campo de união
rule . A regra que controla esse formato condicional precisa ser definida exatamente uma vez.
rule
pode ser apenas um dos seguintes:
|
|
booleanRule
|
A formatação é "ativada" ou "desativada" de acordo com a regra. |
gradientRule
|
A formatação varia de acordo com os gradientes na regra. |
BooleanRule
Uma regra que pode ou não corresponder, dependendo da condição.
Representação JSON |
---|
{ "condition": { object ( |
Campos | |
---|---|
condition
|
A condição da regra. Se a condição for avaliada como verdadeira, o formato será aplicado. |
format
|
O formato a ser aplicado. A formatação condicional só pode aplicar um subconjunto de formatação:
|
GradientRule
Uma regra que aplica um formato de escala de cores gradiente com base nos pontos de interpolação listados. O formato de uma célula varia de acordo com o conteúdo em comparação com os valores dos pontos de interpolação.
Representação JSON |
---|
{ "minpoint": { object ( |
Campos | |
---|---|
minpoint
|
O ponto de interpolação inicial. |
midpoint
|
Um ponto de interpolação opcional no meio. |
maxpoint
|
O ponto de interpolação final. |
InterpolationPoint
Um único ponto de interpolação em um formato condicional de gradiente. Eles fixam a escala de cores do gradiente de acordo com a cor, o tipo e o valor escolhidos.
Representação JSON |
---|
{ "color": { object ( |
Campos | |
---|---|
color
|
A cor que esse ponto de interpolação precisa usar. Descontinuado: use
|
colorStyle
|
A cor que esse ponto de interpolação precisa usar. Se
|
type
|
Como o valor deve ser interpretado. |
value
|
O valor usado por esse ponto de interpolação. Pode ser uma fórmula. Não é usado se
|
InterpolationPointType
O tipo de ponto de interpolação.
Enums | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
O valor padrão, não use. |
MIN
|
O ponto de interpolação usa o valor mínimo nas células no intervalo do formato condicional. |
MAX
|
O ponto de interpolação usa o valor máximo nas células no intervalo do formato condicional. |
NUMBER
|
O ponto de interpolação usa exatamente o valor em
InterpolationPoint.value .
|
PERCENT
|
O ponto de interpolação é a porcentagem especificada em todas as células no intervalo do formato condicional. Isso é equivalente a
|
PERCENTILE
|
O ponto de interpolação é o percentil fornecido em todas as células no intervalo do formato condicional. Isso é equivalente a
NUMBER
se o valor for:
=PERCENTILE(FLATTEN(range), value / 100)
(em que os erros no intervalo são ignorados durante a compactação).
|
FilterView
Uma visualização com filtro.
Representação JSON |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
Campos | |
---|---|
filterViewId
|
O ID da visualização do filtro. |
title
|
O nome da visualização de filtro. |
range
|
O intervalo que essa visualização de filtro abrange.
Ao gravar, apenas uma das opções
|
namedRangeId
|
O intervalo nomeado que dá suporte a essa visualização de filtro, se houver.
Ao gravar, apenas uma das opções
|
tableId
|
A tabela que dá suporte a essa visualização de filtro, se houver.
Ao gravar, apenas uma das opções
|
sortSpecs[]
|
A ordem de classificação por coluna. As especificações posteriores são usadas quando os valores são iguais nas especificações anteriores. |
criteria
|
Os critérios para mostrar/ocultar valores por coluna. A chave do mapa é o índice da coluna, e o valor é o critério para essa coluna.
O uso desse campo foi descontinuado em favor de
|
filterSpecs[]
|
Os critérios de filtro para mostrar/ocultar valores por coluna.
Tanto
|
ProtectedRange
Um intervalo protegido.
Representação JSON |
---|
{ "protectedRangeId": integer, "range": { object ( |
Campos | |
---|---|
protectedRangeId
|
O ID do intervalo protegido. Este campo é somente leitura. |
range
|
O intervalo que está sendo protegido. O intervalo pode ser totalmente ilimitado, caso em que é considerado uma página protegida.
Ao gravar, apenas uma das opções
|
namedRangeId
|
O intervalo nomeado que dá suporte a esse intervalo protegido, se houver.
Ao gravar, apenas uma das opções
|
tableId
|
A tabela que dá suporte a esse intervalo protegido, se houver.
Ao gravar, apenas uma das opções
|
description
|
A descrição do intervalo protegido. |
warningOnly
|
Verdadeiro se esse intervalo protegido vai mostrar um aviso ao ser editado. A proteção baseada em avisos significa que todos os usuários podem editar dados no intervalo protegido, mas a edição vai acionar um aviso pedindo que o usuário confirme a edição.
Ao gravar: se esse campo for verdadeiro, |
requestingUserCanEdit
|
Verdadeiro se o usuário que solicitou o intervalo protegido pode editar a área protegida. Este campo é somente leitura. |
unprotectedRanges[]
|
Lista de intervalos não protegidos em uma página protegida. Os intervalos não protegidos só são aceitos em páginas protegidas. |
editors
|
Os usuários e grupos com acesso de edição ao intervalo protegido. Esse campo só fica visível para usuários com acesso de edição ao intervalo protegido e ao documento. Os editores não têm suporte para a
proteção
|
Editores
Os editores de um intervalo protegido.
Representação JSON |
---|
{ "users": [ string ], "groups": [ string ], "domainUsersCanEdit": boolean } |
Campos | |
---|---|
users[]
|
Os endereços de e-mail dos usuários com acesso de edição ao intervalo protegido. |
groups[]
|
Os endereços de e-mail dos grupos com acesso de edição ao intervalo protegido. |
domainUsersCanEdit
|
Verdadeiro se qualquer pessoa no domínio do documento tiver acesso de edição ao intervalo protegido. A proteção de domínio só é compatível com documentos dentro de um domínio. |
BasicFilter
O filtro padrão associado a uma planilha.
Representação JSON |
---|
{ "range": { object ( |
Campos | |
---|---|
range
|
O intervalo que o filtro abrange. |
tableId
|
A tabela que dá suporte a esse filtro, se houver. Ao gravar, apenas uma das opções
|
sortSpecs[]
|
A ordem de classificação por coluna. As especificações posteriores são usadas quando os valores são iguais nas especificações anteriores. |
criteria
|
Os critérios para mostrar/ocultar valores por coluna. A chave do mapa é o índice da coluna, e o valor é o critério para essa coluna.
O uso desse campo foi descontinuado em favor de
|
filterSpecs[]
|
Os critérios de filtro por coluna.
Tanto
|
BandedRange
Um intervalo com faixas (cores alternadas) em uma planilha.
Representação JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
Campos | |
---|---|
bandedRangeId
|
O ID do intervalo com faixas. |
range
|
O intervalo em que essas propriedades são aplicadas. |
rowProperties
|
Propriedades para faixas de linha. Essas propriedades são aplicadas linha por linha em todas as linhas do intervalo. Pelo menos uma das seguintes propriedades:
|
columnProperties
|
Propriedades para faixas de colunas. Essas propriedades são aplicadas em cada coluna do intervalo. Pelo menos uma das seguintes propriedades:
|
BandingProperties
Propriedades que se referem a uma única dimensão (linha ou coluna). Se
BandedRange.row_properties
e
BandedRange.column_properties
estiverem definidos, as cores de preenchimento serão aplicadas às células de acordo com as seguintes regras:
-
headerColor
efooterColor
têm prioridade sobre as cores da faixa. -
firstBandColor
tem precedência sobresecondBandColor
. -
rowProperties
tem precedência sobrecolumnProperties
.
Por exemplo, a cor da primeira linha tem prioridade sobre a cor da primeira coluna, mas a cor da primeira coluna tem prioridade sobre a cor da segunda linha. Da mesma forma, o cabeçalho da linha tem prioridade sobre o cabeçalho da coluna na célula superior esquerda, mas o cabeçalho da coluna tem prioridade sobre a cor da primeira linha se o cabeçalho da linha não estiver definido.
Representação JSON |
---|
{ "headerColor": { object ( |
Campos | |
---|---|
headerColor
|
A cor da primeira linha ou coluna. Se esse campo estiver definido, a primeira linha ou coluna será preenchida com essa cor, e as cores vão alternar entre
|
headerColorStyle
|
A cor da primeira linha ou coluna. Se esse campo estiver definido, a primeira linha ou coluna será preenchida com essa cor, e as cores vão alternar entre
|
firstBandColor
|
A primeira cor que está alternando. (Obrigatório) Descontinuado: use
|
firstBandColorStyle
|
A primeira cor que está alternando. (Obrigatório) Se
|
secondBandColor
|
A segunda cor que está alternando. (Obrigatório) Descontinuado: use
|
secondBandColorStyle
|
A segunda cor que está alternando. (Obrigatório) Se
|
footerColor
|
A cor da última linha ou coluna. Se esse campo não estiver definido, a última linha ou coluna será preenchida com
|
footerColorStyle
|
A cor da última linha ou coluna. Se esse campo não estiver definido, a última linha ou coluna será preenchida com
|
DimensionGroup
Um grupo em um intervalo de linhas ou colunas em uma planilha, que pode conter ou ser contido em outros grupos. Um grupo pode ser recolhido ou expandido como uma unidade na página.
Representação JSON |
---|
{
"range": {
object ( |
Campos | |
---|---|
range
|
O intervalo em que o grupo existe. |
depth
|
A profundidade do grupo, que representa quantos grupos têm um intervalo que contém totalmente o intervalo desse grupo. |
collapsed
|
Este campo é verdadeiro se o grupo estiver fechado. Um grupo recolhido permanece recolhido se um grupo sobreposto em uma profundidade menor for aberto. Um valor verdadeiro não implica que todas as dimensões do grupo estão ocultas, já que a visibilidade de uma dimensão pode mudar independentemente dessa propriedade de grupo. No entanto, quando essa propriedade é atualizada, todas as dimensões nela são definidas como ocultas se esse campo for verdadeiro ou como visíveis se for falso. |
Controle de filtros
Um seletor em uma planilha.
Representação JSON |
---|
{ "slicerId": integer, "spec": { object ( |
Campos | |
---|---|
slicerId
|
O ID do seletor. |
spec
|
A especificação do fatiador. |
position
|
A posição do seletor. O seletor só pode ser posicionado na planilha atual. Além disso, a largura e a altura do fatiador podem ser ajustadas automaticamente para ficarem dentro dos limites permitidos. |
SlicerSpec
As especificações de um fatiador.
Representação JSON |
---|
{ "dataRange": { object ( |
Campos | |
---|---|
dataRange
|
O intervalo de dados do seletor. |
filterCriteria
|
Os critérios de filtragem do seletor. |
columnIndex
|
O índice de colunas com base em zero na tabela de dados em que o filtro é aplicado. |
applyToPivotTables
|
Verdadeiro se o filtro for aplicado a tabelas dinâmicas. Se não for definido, o padrão será
|
title
|
O título do seletor. |
textFormat
|
O formato de texto do título no seletor. O campo de link não é aceito. |
backgroundColor
|
A cor de fundo do seletor. Descontinuado: use
|
backgroundColorStyle
|
A cor de fundo do seletor. Se
|
horizontalAlignment
|
O alinhamento horizontal do título no seletor. Se não for especificado, o padrão será
|
Tabela
Uma tabela.
Representação JSON |
---|
{ "tableId": string, "name": string, "range": { object ( |
Campos | |
---|---|
tableId
|
O ID da tabela. |
name
|
O nome da tabela. Isso é exclusivo para todas as tabelas na mesma planilha. |
range
|
O intervalo da tabela. |
rowsProperties
|
As propriedades das linhas da tabela. |
columnProperties[]
|
As propriedades da coluna da tabela. |
TableRowsProperties
As propriedades da linha da tabela.
Representação JSON |
---|
{ "headerColorStyle": { object ( |
Campos | |
---|---|
headerColorStyle
|
A cor da linha de cabeçalho. Se esse campo for definido, a linha do cabeçalho será preenchida com a cor especificada. Caso contrário, a linha de cabeçalho é preenchida com uma cor padrão. |
firstBandColorStyle
|
A primeira cor que está alternando. Se esse campo for definido, a primeira linha em faixa será preenchida com a cor especificada. Caso contrário, a primeira linha com faixas é preenchida com uma cor padrão. |
secondBandColorStyle
|
A segunda cor que está alternando. Se esse campo for definido, a segunda linha em faixa será preenchida com a cor especificada. Caso contrário, a segunda linha com faixas é preenchida com uma cor padrão. |
footerColorStyle
|
A cor da última linha. Se esse campo não for definido e um rodapé não for adicionado, a última linha será preenchida com
|
TableColumnProperties
A coluna da tabela.
Representação JSON |
---|
{ "columnIndex": integer, "columnName": string, "columnType": enum ( |
Campos | |
---|---|
columnIndex
|
O índice de colunas baseado em 0. Esse índice é relativo à posição na tabela e não é necessariamente o mesmo que o índice de colunas na planilha. |
columnName
|
O nome da coluna. |
columnType
|
O tipo de coluna. |
dataValidationRule
|
A regra de validação de dados da coluna. Definido apenas para o tipo de coluna de menu suspenso. |
ColumnType
O tipo de coluna de uma determinada coluna em uma tabela.
Enums | |
---|---|
COLUMN_TYPE_UNSPECIFIED
|
Um tipo de coluna não especificado. |
DOUBLE
|
O tipo de coluna numérica. |
CURRENCY
|
O tipo de coluna de moeda. |
PERCENT
|
O tipo de coluna de porcentagem. |
DATE
|
O tipo de coluna de data. |
TIME
|
O tipo de coluna de tempo. |
DATE_TIME
|
O tipo de coluna de data e hora. |
TEXT
|
O tipo de coluna de texto. |
BOOLEAN
|
O tipo de coluna booleano. |
DROPDOWN
|
O tipo de coluna do menu suspenso. |
FILES_CHIP
|
O tipo de coluna "Ícone de arquivo" |
PEOPLE_CHIP
|
O tipo de coluna "Ícone de usuário" |
FINANCE_CHIP
|
O tipo de coluna do ícone de finanças |
PLACE_CHIP
|
O tipo de coluna do ícone de lugar |
RATINGS_CHIP
|
O tipo de coluna "Ícone de classificação" |
TableColumnDataValidationRule
Uma regra de validação de dados para uma coluna em uma tabela.
Representação JSON |
---|
{
"condition": {
object ( |
Campos | |
---|---|
condition
|
A condição que os dados na célula precisam atender. Válido apenas se [BooleanCondition.type] for ONE_OF_LIST. |