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 de agregar os dados na tabela dinâmica. A chave do mapa é o deslocamento da coluna do intervalo de origem que você quer filtrar, e o valor são os critérios dessa coluna.

Por exemplo, se a fonte era C10:E15, uma chave de 0 terão o filtro para a coluna, C, enquanto a chave 1 é para a coluna D.

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

object (PivotFilterSpec)

Os filtros aplicados às colunas de origem antes de agregar os dados à tabela dinâmica.

Ambos criteria e filterSpecs são preenchidos nas respostas. Se ambos os campos forem especificados em uma solicitação de atualização, este campo terá precedência.

object (PivotValue)

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

enum (PivotValueLayout)

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

object (DataExecutionStatus)

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

object (GridRange)

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

string

O ID da fonte de dados da qual a tabela dinâmica está lendo os 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 desse agrupamento.

object (PivotGroupValueMetadata)

Metadados sobre valores no agrupamento.

enum (SortOrder)

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

object (PivotGroupSortValueBucket)

O bucket do grupo dinâmico oposto para classificação. Se não for especificada, a classificação será em ordem alfabética pelos valores desse grupo.

boolean

Verdadeiro se os títulos deste grupo dinâmico precisarem ser repetidos. Isso é válido apenas para agrupamentos de linhas e é ignorado pelas colunas.

Por padrão, minimizamos a repetição de títulos ao não mostrar cabeçalhos de níveis superiores onde são iguais. Por exemplo, embora a terceira linha abaixo corresponda a "T1 Mar", "T1" não é mostrado porque é redundante com as linhas anteriores. Definir "repeatHeadings" como "true" causaria "Q1" a ser repetido para "fevereiro" e "Mar".

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

string

Os rótulos a serem usados para os 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 renomeada como State) e o rótulo da coluna é Product (que pode ser renomeada 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 a este grupo de linhas/colunas.

object (PivotGroupLimit)

O limite de contagem em linhas ou colunas que serão aplicadas a este grupo dinâmico.

integer

O deslocamento de coluna do intervalo de origem em que esse agrupamento se baseia.

Por exemplo, se a fonte era C10:E15, um sourceColumnOffset de 0 significa que o grupo se refere à coluna C, enquanto o deslocamento 1 se referiria à coluna D.

object (DataSourceColumnReference)

A referência à coluna da fonte de dados na qual esse agrupamento se baseia.

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

object (ExtendedValue)

O valor calculado ao qual 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 PivotTable.values lista pelos quais os valores nesse agrupamento devem ser classificados.

object (ExtendedValue)

Determina o bucket a partir do qual os valores são escolhidos para classificação.

Por exemplo, em uma tabela dinâmica com um grupo de linhas & 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" sobre os grupos de colunas. Se um único valor for listado, isso corresponderia ao uso do atributo "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 de nomes de grupos e os itens correspondentes dos dados de origem que mapeiam para o nome de cada 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 nesse grupo. Cada item pode ser uma string, um número ou um booleano. Os itens podem aparecer em, no máximo, um grupo de um determinado grupo ManualRule: Os itens que não aparecem em nenhum grupo aparecem 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 buckets de tamanho constante. Os valores abaixo de start 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 de end 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 dos grupos dinâmicos são aplicados do número de ordem menor para o maior. Números de ordem são normalizados para números inteiros consecutivos a partir de 0.

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

{
  "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 que os valores sejam mostrados. ( visibleValues não substitui isso. Mesmo que um valor esteja listado lá, ele ainda ficará 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, 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 o nome "Receita" e "Custo" e uma condição é aplicada ao campo "Receita" coluna com tipo NUMBER_GREATER e valor =Cost, então apenas as colunas em que "Receita" > "Custo" estão incluídas.

boolean

Indica se os valores ficam visíveis por padrão. Se verdadeiro, o visibleValues são ignorados, todos os valores que atendem condition (se especificado). Se for falso, os valores que estão em visibleValues e conhecer 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 de coluna baseado em zero 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 for definido, os únicos valores compatíveis serão SUM e CUSTOM Se sourceColumnOffset estiver definido, CUSTOM não tem suporte.

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 computeDisplayType 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 é chamado de "Mostrar como" na seção de valor de uma tabela dinâmica.

integer

O deslocamento da coluna do intervalo de origem que esse valor lê.

Por exemplo, se a fonte era C10:E15, um sourceColumnOffset de 0 significa que esse valor se refere à coluna C, enquanto o deslocamento 1 se referiria à coluna D.

string

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

object (DataSourceColumnReference)

A referência à coluna da fonte de dados usada para a leitura desse valor.