Pivot Tables

PivotTable

Uma tabela dinâmica.

Representação JSON

{ "rows": [ { object (PivotGroup) } ], "columns": [ { object (PivotGroup) } ], "criteria": { integer: { object (PivotFilterCriteria) }, ... }, "filterSpecs": [ { object (PivotFilterSpec) } ], "values": [ { object (PivotValue) } ], "valueLayout": enum (PivotValueLayout), "dataExecutionStatus": { object (DataExecutionStatus) }, // Union field source_data can be only one of the following: "source": { object (GridRange) }, "dataSourceId": string // End of list of possible types for union field source_data. }

Campos
rows[]	object (PivotGroup) Cada agrupamento de linhas na tabela dinâmica.
columns[]	object (PivotGroup) Cada agrupamento de colunas na tabela dinâmica.
criteria (deprecated)	map (key: integer, value: object ( PivotFilterCriteria)) Este item está obsoleto. Um mapeamento opcional de filtros por deslocamento da coluna de origem. Os filtros são aplicados antes da agregação de dados na tabela dinâmica. A chave do mapa é o deslocamento da coluna do intervalo de origem que você quer filtrar, e o valor é o critério para essa coluna. Por exemplo, se a origem for C10:E15, uma chave de 0 terá o filtro para a coluna C, enquanto a chave 1 é para a coluna D. O uso desse campo foi descontinuado em favor de filterSpecs.
filterSpecs[]	object (PivotFilterSpec) Os filtros aplicados às colunas de origem antes de agregar dados para a tabela dinâmica. Tanto criteria quanto filterSpecs são preenchidos nas respostas. Se ambos os campos forem especificados em uma solicitação de atualização, esse campo terá precedência.
values[]	object (PivotValue) Uma lista de valores a serem incluídos na tabela dinâmica.
valueLayout	enum (PivotValueLayout) Indica se os valores precisam ser listados horizontalmente (como colunas) ou verticalmente (como linhas).
dataExecutionStatus	object (DataExecutionStatus) Apenas saída. O status de execução dos dados para tabelas dinâmicas de fontes de dados.
Campo de união source_data. A origem dos dados da tabela dinâmica. source_data pode ser apenas um dos seguintes:
source	object (GridRange) O intervalo em que a tabela dinâmica está lendo dados.
dataSourceId	string O ID da fonte de dados da qual a tabela dinâmica está lendo dados.

PivotGroup

Um único agrupamento (linha ou coluna) em uma tabela dinâmica.

Representação JSON

{ "showTotals": boolean, "valueMetadata": [ { object (PivotGroupValueMetadata) } ], "sortOrder": enum (SortOrder), "valueBucket": { object (PivotGroupSortValueBucket) }, "repeatHeadings": boolean, "label": string, "groupRule": { object (PivotGroupRule) }, "groupLimit": { object (PivotGroupLimit) }, // Union field source can be only one of the following: "sourceColumnOffset": integer, "dataSourceColumnReference": { object (DataSourceColumnReference) } // End of list of possible types for union field source. }

Campos
showTotals	boolean Verdadeiro se a tabela pivot precisa incluir os totais desse agrupamento.
valueMetadata[]	object (PivotGroupValueMetadata) Metadados sobre os valores no agrupamento.
sortOrder	enum (SortOrder) A ordem em que os valores desse grupo precisam ser classificados.
valueBucket	object (PivotGroupSortValueBucket) O bucket do grupo dinâmico oposto para classificar. Se não for especificado, a classificação será alfabética pelos valores desse grupo.
repeatHeadings	boolean Verdadeiro se os títulos neste grupo de pivots precisam ser repetidos. Isso é válido apenas para agrupamentos de linhas e é ignorado pelas colunas. Por padrão, minimizamos a repetição de títulos não mostrando títulos de nível mais alto quando eles são iguais. Por exemplo, embora a terceira linha abaixo corresponda a "Q1 Mar", "Q1" não é mostrada porque é redundante com as linhas anteriores. A definição de repeatHeadings como "true" faria com que "Q1" fosse repetido para "Fev" e "Mar". +--------------+ | Q1 | Jan | | | Feb | | | Mar | +--------+-----+ | Q1 Total | +--------------+
label	string Os rótulos a serem usados para os grupos de linha/coluna que podem ser personalizados. Por exemplo, na tabela dinâmica a seguir, o rótulo da linha é Region (que pode ser renomeado para State) e o rótulo da coluna é Product (que pode ser renomeado para Item). As tabelas dinâmicas criadas antes de dezembro de 2017 não têm rótulos de cabeçalho. Se você quiser adicionar rótulos de cabeçalho a uma tabela dinâmica, exclua a tabela dinâmica atual e crie uma nova com os mesmos parâmetros. +--------------+---------+-------+ | SUM of Units | Product | | | Region | Pen | Paper | +--------------+---------+-------+ | New York | 345 | 98 | | Oregon | 234 | 123 | | Tennessee | 531 | 415 | +--------------+---------+-------+ | Grand Total | 1110 | 636 | +--------------+---------+-------+
groupRule	object (PivotGroupRule) A regra de grupo a ser aplicada a esse grupo de linhas/colunas.
groupLimit	object (PivotGroupLimit) O limite de contagem em linhas ou colunas a ser aplicado a esse grupo de pivot.
Campo de união source. A fonte de dados do grupo de pivot. source pode ser apenas um dos seguintes:
sourceColumnOffset	integer O deslocamento da coluna do intervalo de origem em que esse agrupamento se baseia. Por exemplo, se a origem for C10:E15, um sourceColumnOffset de 0 significa que esse grupo se refere à coluna C, enquanto o deslocamento 1 se refere à coluna D.
dataSourceColumnReference	object (DataSourceColumnReference) A referência à coluna da fonte de dados em que o agrupamento se baseia.

PivotGroupValueMetadata

Metadados sobre um valor em um grupo de abas.

Representação JSON
{ "value": { object (ExtendedValue) }, "collapsed": boolean }

Campos
value	object (ExtendedValue) O valor calculado ao qual os metadados correspondem. Observe que formulaValue não é válido, porque os valores serão calculados.
collapsed	boolean Verdadeiro se os dados correspondentes ao valor estiverem recolhidos.

PivotGroupSortValueBucket

Informações sobre quais valores em um grupo de pivote devem ser usados para a classificação.

Representação JSON
{ "valuesIndex": integer, "buckets": [ { object (ExtendedValue) } ] }

Campos
valuesIndex	integer O deslocamento na lista PivotTable.values em que os valores desse agrupamento precisam ser classificados.
buckets[]	object (ExtendedValue) Determina o bucket de onde os valores são escolhidos para classificação. Por exemplo, em uma tabela dinâmica com um grupo de linhas e dois grupos de colunas, o grupo de linhas pode listar até dois valores. O primeiro valor corresponde a um valor no primeiro grupo de colunas, e o segundo valor corresponde a um valor no segundo grupo de colunas. Se nenhum valor for listado, isso indicará que a linha precisa ser classificada de acordo com o "Total geral" nos grupos de colunas. Se um único valor for listado, isso vai corresponder ao uso do "Total" desse bucket.

PivotGroupRule

Uma configuração opcional em um PivotGroup que define buckets para os valores na coluna de dados de origem, em vez de separar cada valor individual. Só é possível adicionar uma PivotGroup com uma regra de grupo para cada coluna nos dados de origem, mas em qualquer coluna é possível adicionar uma PivotGroup com uma regra e uma PivotGroup sem uma.

Representação JSON
{ // Union field rule can be only one of the following: "manualRule": { object (ManualRule) }, "histogramRule": { object (HistogramRule) }, "dateTimeRule": { object (DateTimeRule) } // End of list of possible types for union field rule. }

Campos
Campo de união rule. A regra a ser aplicada à PivotGroup. rule pode ser apenas um dos seguintes:
manualRule	object (ManualRule) Um ManualRule.
histogramRule	object (HistogramRule) Um HistogramRule.
dateTimeRule	object (DateTimeRule) Um DateTimeRule.

ManualRule

Permite organizar manualmente os valores em uma coluna de dados de origem em grupos com os nomes que você escolher. Por exemplo, uma tabela dinâmica que agrega a população por estado:

+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK    |               0.7 |
| AL    |               4.8 |
| AR    |               2.9 |
...
+-------+-------------------+

pode ser transformada em uma tabela dinâmica que agrega a população por fuso horário fornecendo uma lista de grupos (por exemplo, groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) para uma regra de grupo manual. É possível conseguir um efeito semelhante adicionando uma coluna de fuso horário aos dados de origem e ajustando a tabela dinâmica.

+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central   |             106.3 |
| Eastern   |             151.9 |
| Mountain  |              17.4 |
...
+-----------+-------------------+

Representação JSON
{ "groups": [ { object (ManualRuleGroup) } ] }

Campos
groups[]	object (ManualRuleGroup) A lista de nomes de grupos e os itens correspondentes dos dados de origem que são mapeados para cada nome de grupo.

ManualRuleGroup

Um nome de grupo e uma lista de itens dos dados de origem que precisam ser colocados no grupo com esse nome.

Representação JSON
{ "groupName": { object (ExtendedValue) }, "items": [ { object (ExtendedValue) } ] }

Campos
groupName	object (ExtendedValue) O nome do grupo, que precisa ser uma string. Cada grupo em um determinado ManualRule precisa ter um nome exclusivo.
items[]	object (ExtendedValue) Os itens nos dados de origem que precisam ser colocados neste grupo. Cada item pode ser uma string, um número ou um booleano. Os itens podem aparecer em, no máximo, um grupo em um determinado ManualRule. Os itens que não aparecem em nenhum grupo aparecem por conta própria.

HistogramRule

Permite organizar os valores numéricos em uma coluna de dados de origem em buckets de tamanho constante. Todos os valores de HistogramRule.start a HistogramRule.end são colocados em grupos de tamanho HistogramRule.interval. Além disso, todos os valores abaixo de HistogramRule.start são colocados em um grupo, e todos os valores acima de HistogramRule.end são colocados em outro. Apenas HistogramRule.interval é obrigatório, mas se HistogramRule.start e HistogramRule.end forem fornecidos, HistogramRule.start precisa ser menor que HistogramRule.end. Por exemplo, uma tabela dinâmica que mostra o valor médio da compra por idade e tem mais de 50 linhas:

+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16  |            $27.13 |
| 17  |             $5.24 |
| 18  |            $20.15 |
...
+-----+-------------------+

pode ser transformada em uma tabela dinâmica semelhante à mostrada abaixo aplicando uma regra de grupo de histograma com um HistogramRule.start de 25, um HistogramRule.interval de 20 e um HistogramRule.end de 65.

+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25        |            $19.34 |
| 25-45       |            $31.43 |
| 45-65       |            $35.87 |
| > 65        |            $27.55 |
+-------------+-------------------+
| Grand Total |            $29.12 |
+-------------+-------------------+

Representação JSON
{ "interval": number, "start": number, "end": number }

Campos
interval	number O tamanho dos buckets criados. Precisa ser positivo.
start	number O valor mínimo em que os itens são colocados em buckets de tamanho constante. Os valores abaixo do início são agrupados em um único bucket. Este campo é opcional.
end	number O valor máximo em que os itens são colocados em buckets de tamanho constante. Os valores acima do final são agrupados em um único bucket. Este campo é opcional.

DateTimeRule

Permite organizar os valores de data e hora em uma coluna de dados de origem em grupos com base em partes selecionadas dos valores de data ou hora. Por exemplo, considere uma tabela dinâmica que mostra as transações de vendas por data:

+----------+--------------+
| Date     | SUM of Sales |
+----------+--------------+
| 1/1/2017 |      $621.14 |
| 2/3/2017 |      $708.84 |
| 5/8/2017 |      $326.84 |
...
+----------+--------------+

A aplicação de uma regra de grupo de data e hora com um DateTimeRuleType de YEAR_MONTH resulta na tabela dinâmica a seguir.

+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan     |   $53,731.78 |
| 2017-Feb     |   $83,475.32 |
| 2017-Mar     |   $94,385.05 |
...
+--------------+--------------+

Representação JSON
{ "type": enum (DateTimeRuleType) }

Campos
type	enum (DateTimeRuleType) O tipo de agrupamento de data e hora a ser aplicado.

DateTimeRuleType

Os tipos disponíveis de regras de agrupamento de data e hora. Esta documentação pressupõe que a localidade da planilha seja "en-US", embora a renderização real das datas e horários use a localidade da planilha para alguns tipos de regras.

Enums
DATE_TIME_RULE_TYPE_UNSPECIFIED	O tipo padrão, não use.
SECOND	Agrupar datas por segundo, de 0 a 59.
MINUTE	Agrupe datas por minuto, de 0 a 59.
HOUR	Agrupe as datas por hora usando um sistema de 24 horas, de 0 a 23.
HOUR_MINUTE	Agrupe as datas por hora e minuto usando um sistema de 24 horas, por exemplo, 19:45.
HOUR_MINUTE_AMPM	Agrupe as datas por hora e minuto usando um sistema de 12 horas, por exemplo, 19h 45. A designação AM/PM é traduzida com base na localidade da planilha.
DAY_OF_WEEK	Agrupar datas por dia da semana, por exemplo, domingo. Os dias da semana serão traduzidos com base na localidade da planilha.
DAY_OF_YEAR	Agrupar datas por dia do ano, de 1 a 366. As datas após 29 de fevereiro ficam em intervalos diferentes em anos bissextos e não bissextos.
DAY_OF_MONTH	Agrupe datas por dia do mês, de 1 a 31.
DAY_MONTH	Agrupe as datas por dia e mês, por exemplo, 22-Nov. O mês é traduzido com base na localidade da planilha.
MONTH	Agrupar datas por mês, por exemplo, novembro. O mês é traduzido com base na localidade da planilha.
QUARTER	Agrupe as datas por trimestre, por exemplo, T1 (que representa janeiro a março).
YEAR	Agrupe as datas por ano, por exemplo, 2008.
YEAR_MONTH	Agrupe as datas por ano e mês, por exemplo, 2008-nov. O mês é traduzido com base na localidade da planilha.
YEAR_QUARTER	Agrupe as datas por ano e trimestre, por exemplo, 2008 Q4.
YEAR_MONTH_DAY	Agrupe as datas por ano, mês e dia, por exemplo, 22/11/2008.

PivotGroupLimit

O limite de contagem em linhas ou colunas no grupo de pivot.

Representação JSON
{ "countLimit": integer, "applyOrder": integer }

Campos
countLimit	integer O limite de contagem.
applyOrder	integer A ordem em que o limite do grupo é aplicado à tabela dinâmica. Os limites do grupo de pivots são aplicados do número de ordem mais baixo para o mais alto. Os números de ordenação são normalizados para números inteiros consecutivos a partir de 0. Para a solicitação de gravação, para personalizar totalmente as ordens de aplicação, todos os limites de grupo de pivote precisam ter esse campo definido com um número exclusivo. Caso contrário, a ordem é determinada pelo índice na lista PivotTable.rows e depois na lista PivotTable.columns.

PivotFilterCriteria

Critérios para mostrar/ocultar linhas em uma tabela dinâmica.

Representação JSON
{ "visibleValues": [ string ], "condition": { object (BooleanCondition) }, "visibleByDefault": boolean }

Campos
visibleValues[]	string Valores que precisam ser incluídos. Os valores não listados aqui são excluídos.
condition	object (BooleanCondition) Uma condição que precisa ser verdadeira para que os valores sejam mostrados. O visibleValues não substitui isso. Mesmo que um valor seja listado, ele ainda fica oculto se não atender à condição. Os valores de condição que se referem a intervalos na notação A1 são avaliados em relação à planilha da tabela dinâmica. As referências são tratadas de forma absoluta, portanto, não são preenchidas na tabela dinâmica. Por exemplo, um valor de condição de =A1 em "Tabela dinâmica 1" é tratado como 'Pivot Table 1'!$A$1. Os dados de origem da tabela dinâmica podem ser referenciados pelo nome do cabeçalho da coluna. Por exemplo, se os dados de origem tiverem colunas com os nomes "Receita" e "Custo" e uma condição for aplicada à coluna "Receita" com o tipo NUMBER_GREATER e o valor =Cost, apenas as colunas em que "Receita" > "Custo" serão incluídas.
visibleByDefault	boolean Se os valores estão visíveis por padrão. Se for verdadeiro, o visibleValues será ignorado, e todos os valores que atenderem condition (se especificado) serão mostrados. Se for falso, os valores que estiverem em visibleValues e atenderem a condition serão mostrados.

PivotFilterSpec

Os critérios de filtro da tabela dinâmica associados a um deslocamento específico da coluna de origem.

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

Campos
filterCriteria	object (PivotFilterCriteria) Os critérios da coluna.
Campo de união source. A coluna de origem a que este filtro se aplica. source pode ser apenas um dos seguintes:
columnOffsetIndex	integer O deslocamento da coluna com base em zero do intervalo de origem.
dataSourceColumnReference	object (DataSourceColumnReference) A referência à coluna da fonte de dados.

PivotValue

A definição de como um valor em uma tabela dinâmica deve ser calculado.

Representação JSON
{ "summarizeFunction": enum (PivotValueSummarizeFunction), "name": string, "calculatedDisplayType": enum (PivotValueCalculatedDisplayType), // Union field value can be only one of the following: "sourceColumnOffset": integer, "formula": string, "dataSourceColumnReference": { object (DataSourceColumnReference) } // End of list of possible types for union field value. }

Campos
summarizeFunction	enum (PivotValueSummarizeFunction) Uma função para resumir o valor. Se formula estiver definido, os únicos valores aceitos serão SUM e CUSTOM. Se sourceColumnOffset estiver definido, CUSTOM não será compatível.
name	string Um nome para usar no valor.
calculatedDisplayType	enum (PivotValueCalculatedDisplayType) Se especificado, indica que os valores de pivot precisam ser mostrados como o resultado de um cálculo com outro valor de pivot. Por exemplo, se calculatedDisplayType for especificado como PERCENT_OF_GRAND_TOTAL, todos os valores do resumo serão mostrados como a porcentagem do valor total. No editor do Planilhas, isso é chamado de "Mostrar como" na seção de valores de uma tabela dinâmica.
Campo de união value. Os dados a serem usados para os valores na tabela dinâmica. É necessário definir exatamente um valor. value pode ser apenas um dos seguintes:
sourceColumnOffset	integer O deslocamento da coluna do intervalo de origem de onde esse valor é lido. Por exemplo, se a origem for C10:E15, um sourceColumnOffset de 0 significa que esse valor se refere à coluna C, enquanto o deslocamento 1 se refere à coluna D.
formula	string Uma fórmula personalizada para calcular o valor. A fórmula precisa começar com um caractere =.
dataSourceColumnReference	object (DataSourceColumnReference) A referência à coluna da origem de dados que este valor lê.

PivotValueSummarizeFunction

Uma função para resumir um valor de resumo.

Enums
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED	O padrão, não use.
SUM	Corresponde à função SUM.
COUNTA	Corresponde à função COUNTA.
COUNT	Corresponde à função COUNT.
COUNTUNIQUE	Corresponde à função COUNTUNIQUE.
AVERAGE	Corresponde à função AVERAGE.
MAX	Corresponde à função MAX.
MIN	Corresponde à função MIN.
MEDIAN	Corresponde à função MEDIAN.
PRODUCT	Corresponde à função PRODUCT.
STDEV	Corresponde à função STDEV.
STDEVP	Corresponde à função STDEVP.
VAR	Corresponde à função VAR.
VARP	Corresponde à função VARP.
CUSTOM	Indica que a fórmula precisa ser usada como está. Só é válida se PivotValue.formula foi definido.
NONE	Indica que o valor já foi resumido e que a função de resumo não foi especificada explicitamente. Usado para tabelas dinâmicas de origem de dados do Looker em que o valor já está resumido.

PivotValueCalculatedDisplayType

As maneiras possíveis de calcular os valores do eixo para exibição.

Enums
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED	Valor padrão. Não use.
PERCENT_OF_ROW_TOTAL	Mostra os valores do eixo como porcentagem dos valores totais da linha.
PERCENT_OF_COLUMN_TOTAL	Mostra os valores do eixo como porcentagem dos valores totais da coluna.
PERCENT_OF_GRAND_TOTAL	Mostra os valores do eixo como porcentagem dos valores do total geral.

PivotValueLayout

O layout dos valores do eixo de valores.

Enums
HORIZONTAL	Os valores são dispostos horizontalmente (como colunas).
VERTICAL	Os valores são dispostos verticalmente (como linhas).