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)

Ogni raggruppamento di righe nella tabella pivot.

object (PivotGroup)

Ogni raggruppamento di colonne nella tabella pivot.

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

Una mappatura facoltativa dei filtri per offset di colonna di origine.

I filtri vengono applicati prima di aggregare i dati nella tabella pivot. La chiave della mappa è l'offset di colonna dell'intervallo di origine che vuoi filtrare, mentre il valore corrisponde ai criteri per quella colonna.

Ad esempio, se la fonte è C10:E15, una chiave di 0 avrà il filtro per colonna C, mentre la chiave 1 è per la colonna D.

Questo campo è stato ritirato a favore di filterSpecs.

object (PivotFilterSpec)

I filtri applicati alle colonne di origine prima di aggregare i dati per la tabella pivot.

Entrambi criteria e filterSpecs vengono compilate in risposte. Se in una richiesta di aggiornamento vengono specificati entrambi i campi, questo campo ha la precedenza.

object (PivotValue)

Un elenco di valori da includere nella tabella pivot.

enum (PivotValueLayout)

Indica se i valori devono essere elencati orizzontalmente (come colonne) o verticalmente (come righe).

object (DataExecutionStatus)

Solo output. Lo stato di esecuzione dei dati per le tabelle pivot dell'origine dati.

object (GridRange)

L'intervallo da cui la tabella pivot legge i dati.

string

L'ID dell'origine dati da cui la tabella pivot legge i dati.

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

True se la tabella pivot deve includere i totali per questo raggruppamento.

object (PivotGroupValueMetadata)

Metadati sui valori nel raggruppamento.

enum (SortOrder)

L'ordine in cui devono essere ordinati i valori in questo gruppo.

object (PivotGroupSortValueBucket)

Il bucket del gruppo pivot opposto in base al quale ordinare. Se non specificato, l'ordinamento è in ordine alfabetico in base ai valori di questo gruppo.

boolean

True se le intestazioni in questo gruppo pivot devono essere ripetute. È valido solo per i raggruppamenti di righe e viene ignorato dalle colonne.

Per impostazione predefinita, riduciamo al minimo la ripetizione di intestazioni evitando di mostrare titoli di livello superiore quando sono uguali. Ad esempio, anche se la terza riga sottostante corrisponde a "Q1 mar", "Q1" non viene visualizzato perché è ridondante rispetto alle righe precedenti. L'impostazione ripetiHeadings su true causerebbe "Q1" da ripetere per "febbraio" e "Mar".

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

string

Le etichette da utilizzare per i gruppi di righe/colonne che possono essere personalizzati. Ad esempio, nella seguente tabella pivot, l'etichetta della riga è Region (che potrebbe essere rinominata in State) e l'etichetta della colonna è Product (che potrebbe essere rinominata Item). Le tabelle pivot create prima di dicembre 2017 non hanno etichette di intestazione. Se vuoi aggiungere etichette di intestazione a una tabella pivot esistente, elimina la tabella pivot esistente e creane una nuova con gli stessi parametri.

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+

object (PivotGroupRule)

La regola di gruppo da applicare a questo gruppo di righe/colonne.

object (PivotGroupLimit)

Il limite massimo di righe o colonne da applicare a questo gruppo pivot.

integer

L'offset di colonna dell'intervallo di origine su cui si basa questo raggruppamento.

Ad esempio, se la fonte è C10:E15, un sourceColumnOffset di 0 significa che il gruppo si riferisce alla colonna C, mentre la compensazione 1 si riferisce alla colonna D,

object (DataSourceColumnReference)

Il riferimento alla colonna dell'origine dati su cui si basa questo raggruppamento.

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

object (ExtendedValue)

Il valore calcolato a cui corrispondono i metadati. Tieni presente che formulaValue non è valido perché i valori verranno calcolati.

boolean

True se i dati corrispondenti al valore sono compressi.

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

integer

L'offset nella PivotTable.values un elenco in base al quale devono essere ordinati i valori di questo raggruppamento.

object (ExtendedValue)

Determina il bucket da cui vengono scelti i valori per l'ordinamento.

Ad esempio, in una tabella pivot con un gruppo di righe & due gruppi di colonne, il gruppo di righe può elencare fino a due valori. Il primo valore corrisponde a un valore all'interno del primo gruppo di colonne e il secondo valore corrisponde a un valore nel secondo gruppo di colonne. Se non sono indicati valori, la riga deve essere ordinata in base al "Totale generale" sui gruppi di colonne. L'indicazione di un singolo valore corrisponde all'utilizzo del valore "Totale" del 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)

R ManualRule.

object (HistogramRule)

R HistogramRule.

object (DateTimeRule)

R DateTimeRule.

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

object (ManualRuleGroup)

L'elenco dei nomi dei gruppi e degli elementi corrispondenti dai dati di origine mappati al nome di ciascun gruppo.

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

object (ExtendedValue)

Il nome del gruppo, che deve essere una stringa. Ogni gruppo in un dato ManualRule deve avere un nome di gruppo univoco.

object (ExtendedValue)

Gli elementi nei dati di origine che devono essere inseriti in questo gruppo. Ogni elemento può essere una stringa, un numero o un valore booleano. Gli elementi possono essere visualizzati al massimo in un gruppo all'interno di un determinato ManualRule. Gli elementi che non sono inclusi in alcun gruppo verranno visualizzati autonomamente.

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

number

Le dimensioni dei bucket creati. Deve essere positivo.

number

Il valore minimo al quale gli elementi vengono posizionati in bucket di dimensioni costanti. I valori inferiori all'inizio vengono raggruppati in un unico bucket. Questo campo è facoltativo.

number

Il valore massimo a cui gli elementi vengono posizionati in bucket di dimensione costante. I valori oltre l'estremità vengono raggruppati in un unico bucket. Questo campo è facoltativo.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

Il tipo di raggruppamento data-ora da applicare.

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

integer

Il limite massimo.

integer

L'ordine in cui il limite del gruppo viene applicato alla tabella pivot.

I limiti del gruppo pivot vengono applicati dal numero di ordine inferiore a quello superiore. I numeri degli ordini vengono normalizzati in numeri interi consecutivi compresi tra 0 e 0.

Per la richiesta di scrittura, per personalizzare completamente gli ordini da applicare, questo campo deve essere impostato con un numero univoco per tutti i limiti del gruppo pivot. Altrimenti, l'ordine è determinato dall'indice nella PivotTable.rows e poi PivotTable.columns dall'elenco di lettura.

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

string

Valori che devono essere inclusi. I valori non elencati qui sono esclusi.

object (BooleanCondition)

Una condizione che deve essere vera per poter mostrare i valori. ( visibleValues non lo sostituisce: anche se un valore è elencato, è comunque nascosto se non soddisfa la condizione).

I valori delle condizioni che fanno riferimento a intervalli nella notazione A1 vengono valutati in base al foglio della tabella pivot. I riferimenti vengono trattati in modo assoluto, quindi non vengono compilati nella tabella pivot. Ad esempio, il valore della condizione =A1 su "Tabella pivot 1" viene considerato 'Pivot Table 1'!$A$1.

È possibile fare riferimento ai dati di origine della tabella pivot in base al nome dell'intestazione di colonna. Ad esempio, se i dati di origine presentano colonne denominate "Entrate" e "Costo" e viene applicata una condizione alle "Entrate" colonna con tipo NUMBER_GREATER e il valore =Cost, poi solo le colonne in cui "Entrate" > "Costo" sono inclusi.

boolean

Indica se i valori sono visibili per impostazione predefinita. Se il valore è vero, i valori visibleValues vengono ignorati, tutti i valori che soddisfano condition (se specificate). Se il valore è false, i valori che si trovano entrambi in visibleValues e incontrare condition come vengono mostrati i dati.

{
  "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)

I criteri per la colonna.

integer

L'offset della colonna in base zero dell'intervallo di origine.

object (DataSourceColumnReference)

Il riferimento alla colonna dell'origine dati.

{
  "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)

Una funzione per riepilogare il valore. Se formula è impostato, gli unici valori supportati sono SUM e CUSTOM. Se sourceColumnOffset è impostato, allora CUSTOM non è supportato.

string

Un nome da utilizzare per il valore.

enum (PivotValueCalculatedDisplayType)

Se specificato, indica che i valori pivot devono essere visualizzati come risultato di un calcolo con un altro valore pivot. Ad esempio, se computeDisplayType è specificato come PERCENT_OF_GRAND_TOTAL, tutti i valori pivot vengono visualizzati come percentuale del totale complessivo. Nell'editor di Fogli, questa opzione è chiamata "Mostra come" nella sezione del valore di una tabella pivot.

integer

L'offset di colonna dell'intervallo di origine da cui viene letto questo valore.

Ad esempio, se la fonte è C10:E15, un sourceColumnOffset di 0 significa che questo valore si riferisce alla colonna C, mentre la compensazione 1 si riferisce alla colonna D,

string

Una formula personalizzata per calcolare il valore. La formula deve iniziare con un = .

object (DataSourceColumnReference)

Il riferimento alla colonna dell'origine dati da cui viene letto questo valore.