Pivot Tables

{
  "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.
}

object (PivotGroup)

Cada agrupamento de linhas na tabela dinâmica.

object (PivotGroup)

Cada agrupamento de colunas na tabela dinâmica.

map (key: integer, value: object ( PivotFilterCriteria))

Um mapeamento opcional de filtros por deslocamento da coluna de origem.

Os filtros são aplicados antes da agregação dos dados na tabela dinâmica. A chave do mapa é o deslocamento da coluna do intervalo de origem que você deseja filtrar, e o valor é o critério para aquela coluna.

Por exemplo, se a origem for C10:E15, uma chave de 0 terá o filtro para a coluna C, enquanto a chave 1 será para a coluna D.

Este campo está obsoleto e foi substituído por filterSpecs.

object (PivotFilterSpec)

Os filtros aplicados às colunas de origem antes da agregação dos dados da 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.

object (PivotValue)

Uma lista de valores a serem incluídos na tabela dinâmica.

enum (PivotValueLayout)

Indica se os valores devem ser listados horizontalmente (como colunas) ou verticalmente (como linhas).

object (DataExecutionStatus)

Apenas saída. O status de execução de dados para tabelas dinâmicas de fonte de dados.

object (GridRange)

O intervalo do qual a tabela dinâmica está lendo dados.

string

O código da fonte de dados em que a tabela dinâmica está lendo dados.

{
  "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.
}

boolean

Verdadeiro se a tabela dinâmica precisar incluir os totais deste agrupamento.

object (PivotGroupValueMetadata)

Metadados sobre valores no agrupamento.

enum (SortOrder)

A ordem em que os valores neste grupo devem ser classificados.

object (PivotGroupSortValueBucket)

O bucket do grupo dinâmico oposto ao qual classificar. Se não for especificado, a classificação será em ordem alfabética pelos valores deste grupo.

boolean

Verdadeiro se os cabeçalhos neste grupo dinâmico devem ser repetidos. Isso é válido apenas para agrupamentos de linhas e é ignorado pelas colunas.

Por padrão, minimizamos a repetição de cabeçalhos não mostrando cabeçalhos de nível superior onde eles são iguais. Por exemplo, mesmo que a terceira linha abaixo corresponda a "P1 Mar", "1T" não é mostrado porque é redundante com as linhas anteriores. A definição de repeatedHeadings como true faria com que "Q1" fosse repetido para "Fev" e "Mar".

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+

string

Os rótulos que serão usados nos grupos de linhas/colunas que podem ser personalizados. Por exemplo, na tabela dinâmica a seguir, o rótulo da linha é Region (que pode ser renomeado como State) e o rótulo da coluna é Product (que pode ser renomeado como 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 existente, exclua a tabela dinâmica existente e crie uma nova tabela dinâmica 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 |
+--------------+---------+-------+

object (PivotGroupRule)

A regra de grupo a ser aplicada ao grupo de linhas/colunas.

object (PivotGroupLimit)

O limite de contagem em linhas ou colunas a ser aplicado ao grupo dinâmico.

integer

O deslocamento da coluna do intervalo de origem em que o 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.

object (DataSourceColumnReference)

A referência à coluna da fonte de dados na qual esse agrupamento é baseado.

{
  "value": {
    object (ExtendedValue)
  },
  "collapsed": boolean
}

object (ExtendedValue)

O valor calculado a que os metadados correspondem. Observe que formulaValue não é válido porque os valores serão calculados.

boolean

Verdadeiro se os dados correspondentes ao valor estiverem recolhidos.

{
  "valuesIndex": integer,
  "buckets": [
    {
      object (ExtendedValue)
    }
  ]
}

integer

O deslocamento na lista PivotTable.values em que os valores neste agrupamento serão classificados.

object (ExtendedValue)

Determina o bucket em que 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 estiver listado, isso indica que a linha deve ser classificada de acordo com o "Total geral" nos grupos de colunas. Se um único valor estiver listado, isso corresponde ao uso do "Total" do bucket.

{

  // 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.
}

object (ManualRule)

Um ManualRule.

object (HistogramRule)

Um HistogramRule.

object (DateTimeRule)

Um DateTimeRule.

{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}

object (ManualRuleGroup)

A lista dos nomes de grupos e os itens correspondentes dos dados de origem mapeados para cada nome de grupo.

{
  "groupName": {
    object (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}

object (ExtendedValue)

O nome do grupo, que precisa ser uma string. Cada grupo em um determinado ManualRule precisa ter um nome de grupo exclusivo.

object (ExtendedValue)

Os itens nos dados de origem que devem 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 forem exibidos em nenhum grupo aparecerão por conta própria.

{
  "interval": number,
  "start": number,
  "end": number
}

number

O tamanho dos buckets criados. Precisa ser positivo.

number

O valor mínimo em que os itens são colocados em segmentos de tamanho constante. Os valores abaixo do início são agrupados em um único bucket. Este campo é opcional.

number

O valor máximo em que os itens são colocados em buckets de tamanho constante. Os valores acima da extremidade são agrupados em um único bucket. Este campo é opcional.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

O tipo de agrupamento de data e hora a ser aplicado.

{
  "countLimit": integer,
  "applyOrder": integer
}

integer

O limite de contagem.

integer

A ordem em que o limite do grupo é aplicado à tabela dinâmica.

Os limites do grupo dinâmico são aplicados do número de pedido mais baixo para o mais alto. Os números de pedidos são normalizados para números inteiros consecutivos a partir de 0.

Para a solicitação de gravação, para personalizar totalmente os pedidos aplicados, todos os limites do grupo dinâmico devem ter este campo definido com um número exclusivo. Caso contrário, a ordem é determinada pelo índice na lista PivotTable.rows e, em seguida, na lista PivotTable.columns.

{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}

string

Valores que devem ser incluídos. Os valores não listados aqui são excluídos.

object (BooleanCondition)

Uma condição que precisa ser verdadeira para os valores serem mostrados. visibleValues não substitui isso. Mesmo que um valor seja listado, ele ainda estará 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 à página da tabela dinâmica. As referências são tratadas de forma absoluta e, portanto, não são preenchidas na tabela dinâmica. Por exemplo, o valor de condição =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 chamadas "Receita" e "Custo" e uma condição for aplicada à coluna "Receita" com o tipo NUMBER_GREATER e o valor =Cost, somente as colunas em que "Receita" > "Custo" serão incluídas.

boolean

Se os valores são visíveis por padrão. Se for verdadeiro, os visibleValues serão ignorados, todos os valores que atendem a condition (se especificado) serão mostrados. Se for falso, os valores que estão em visibleValues e atendem a condition são mostrados.

{
  "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.
}

object (PivotFilterCriteria)

Os critérios da coluna.

integer

O deslocamento da coluna de base do intervalo de origem.

object (DataSourceColumnReference)

A referência à coluna da fonte de dados.

{
  "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.
}

enum (PivotValueSummarizeFunction)

Uma função para resumir o valor. Se formula estiver definido, os únicos valores compatíveis serão SUM e CUSTOM. Se sourceColumnOffset estiver definido, CUSTOM não é compatível.

string

Um nome a ser usado para o valor.

enum (PivotValueCalculatedDisplayType)

Se especificado, indica que os valores dinâmicos devem ser exibidos como resultado de um cálculo com outro valor dinâmico. Por exemplo, se calculadoDisplayType for especificado como PERCENT_OF_GRAND_TOTAL, todos os valores dinâmicos serão exibidos como a porcentagem do total geral. No editor do Planilhas, isso é conhecido como "Mostrar como" na seção de valor de uma tabela dinâmica.

integer

O deslocamento da coluna do intervalo de origem a partir do qual 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.

string

Uma fórmula personalizada para calcular o valor. A fórmula precisa começar com um caractere =.

object (DataSourceColumnReference)

A referência à coluna da fonte de dados em que esse valor é lido.