Pivot Tables

PivotTable

Una tabella pivot.

Rappresentazione 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.
}
Campi
rows[]

object (PivotGroup)

Ogni raggruppamento di righe nella tabella pivot.

columns[]

object (PivotGroup)

Ogni raggruppamento di colonne nella tabella pivot.

criteria
(deprecated)

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

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

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

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

Questo campo è deprecato a favore di filterSpecs.

filterSpecs[]

object (PivotFilterSpec)

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

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

values[]

object (PivotValue)

Un elenco di valori da includere nella tabella pivot.

valueLayout

enum (PivotValueLayout)

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

dataExecutionStatus

object (DataExecutionStatus)

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

Campo di unione source_data. L'origine dei dati della tabella pivot. source_data può essere solo uno dei seguenti:
source

object (GridRange)

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

dataSourceId

string

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

PivotGroup

Un singolo raggruppamento (riga o colonna) in una tabella pivot.

Rappresentazione 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.
}
Campi
showTotals

boolean

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

valueMetadata[]

object (PivotGroupValueMetadata)

I metadati sui valori nel raggruppamento.

sortOrder

enum (SortOrder)

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

valueBucket

object (PivotGroupSortValueBucket)

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

repeatHeadings

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 non mostrando intestazioni di livello superiore quando sono uguali. Ad esempio, anche se la terza riga seguente corrisponde a "Q1 Mar", "Q1" non viene visualizzata perché è ridondante con le righe precedenti. L'impostazione di ripetizioneHeadings su true comporterebbe la ripetizione di "Q1" per "Feb" e "Mar". 

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

string

Le etichette da utilizzare per i gruppi di righe/colonne che possono essere personalizzate. Ad esempio, nella seguente tabella pivot, l'etichetta della riga è Region (che potrebbe essere rinominata come 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 desideri aggiungere etichette di intestazione a una tabella pivot esistente, elimina la tabella pivot esistente e poi crea una nuova tabella pivot 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 |
+--------------+---------+-------+
groupRule

object (PivotGroupRule)

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

groupLimit

object (PivotGroupLimit)

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

Campo di unione source. L'origine dati del gruppo pivot. source può essere solo uno dei seguenti:
sourceColumnOffset

integer

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

Ad esempio, se l'origine era C10:E15, sourceColumnOffset di 0 significa che questo gruppo si riferisce alla colonna C, mentre l'offset 1 farà riferimento alla colonna D.

dataSourceColumnReference

object (DataSourceColumnReference)

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

PivotGroupValueMetadata

Metadati su un valore in un raggruppamento pivot.

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

object (ExtendedValue)

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

collapsed

boolean

True se i dati corrispondenti al valore sono compressi.

PivotGroupSortValueBucket

Informazioni sui valori di un gruppo pivot da utilizzare per l'ordinamento.

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

integer

L'offset nell'elenco PivotTable.values in base al quale ordinare i valori di questo raggruppamento.

buckets[]

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 e 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, mentre il secondo a un valore nel secondo gruppo di colonne. Se non viene elencato alcun valore, significa che la riga deve essere ordinata in base al "Totale generale" dei gruppi di colonne. Se viene elencato un singolo valore, questo corrisponderà all'utilizzo del "Totale" del bucket.

PivotGroupRule

Un'impostazione facoltativa su un elemento PivotGroup che definisce i bucket per i valori nella colonna dei dati di origine anziché suddividere ogni singolo valore. È possibile aggiungere un solo PivotGroup con una regola di gruppo per ogni colonna nei dati di origine, anche se per ogni colonna puoi aggiungere sia PivotGroup che ha una regola che PivotGroup che non ha una regola.

Rappresentazione 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.
}
Campi
Campo di unione rule. La regola da applicare a PivotGroup. rule può essere solo uno dei seguenti:
manualRule

object (ManualRule)

Un ManualRule.

histogramRule

object (HistogramRule)

Un HistogramRule.

dateTimeRule

object (DateTimeRule)

Un DateTimeRule.

ManualRule

Consente di organizzare manualmente i valori di una colonna di dati di origine in bucket con nomi di tua scelta. Ad esempio, una tabella pivot che aggrega la popolazione per stato: 

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

potrebbe essere trasformata in una tabella pivot che aggrega la popolazione per fuso orario fornendo un elenco di gruppi (ad esempio, groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) in base a una regola di gruppo manuale. Tieni presente che puoi ottenere un effetto simile aggiungendo una colonna del fuso orario ai dati di origine e modificando la tabella pivot. 

+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central   |             106.3 |
| Eastern   |             151.9 |
| Mountain  |              17.4 |
...
+-----------+-------------------+
Rappresentazione JSON 
{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}
Campi
groups[]

object (ManualRuleGroup)

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

ManualRuleGroup

Un nome di gruppo e un elenco di elementi dai dati di origine che devono essere inseriti nel gruppo con questo nome.

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

object (ExtendedValue)

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

items[]

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 singolarmente.

HistogramRule

Consente di organizzare i valori numerici in una colonna di dati di origine in bucket di dimensione costante. Tutti i valori da HistogramRule.start a HistogramRule.end vengono inseriti in gruppi di dimensioni HistogramRule.interval. Inoltre, tutti i valori inferiori a HistogramRule.start vengono inseriti in un gruppo, mentre tutti i valori superiori a HistogramRule.end vengono inseriti in un altro. È richiesto solo HistogramRule.interval, tuttavia se vengono forniti entrambi i valori HistogramRule.start e HistogramRule.end, il valore HistogramRule.start deve essere inferiore a HistogramRule.end. Ad esempio, una tabella pivot che mostra un importo medio di acquisto per età con più di 50 righe: 

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

potrebbe essere trasformata in una tabella pivot simile a quella riportata di seguito applicando una regola di gruppo a istogrammi con HistogramRule.start di 25, HistogramRule.interval di 20 e HistogramRule.end di 65. 

+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25        |            $19.34 |
| 25-45       |            $31.43 |
| 45-65       |            $35.87 |
| > 65        |            $27.55 |
+-------------+-------------------+
| Grand Total |            $29.12 |
+-------------+-------------------+
Rappresentazione JSON 
{
  "interval": number,
  "start": number,
  "end": number
}
Campi
interval

number

Le dimensioni dei bucket creati. Deve essere positivo.

start

number

Il valore minimo al quale gli elementi vengono inseriti in bucket di dimensione costante. I valori inferiori all'inizio sono raggruppati in un unico bucket. Questo campo è facoltativo.

end

number

Il valore massimo al quale gli elementi vengono inseriti in bucket di dimensione costante. I valori superiori al limite sono raggruppati in un unico bucket. Questo campo è facoltativo.

DateTimeRule

Consente di organizzare i valori di data e ora in una colonna di dati di origine in bucket in base a parti selezionate dei relativi valori di data o ora. Ad esempio, considera una tabella pivot che mostra le transazioni di vendita per data: 

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

L'applicazione di una regola di gruppo data-ora con DateTimeRuleType di YEAR_MONTH nella tabella pivot seguente. 

+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan     |   $53,731.78 |
| 2017-Feb     |   $83,475.32 |
| 2017-Mar     |   $94,385.05 |
...
+--------------+--------------+
Rappresentazione JSON 
{
  "type": enum (DateTimeRuleType)
}
Campi
type

enum (DateTimeRuleType)

Il tipo di raggruppamento per data e ora da applicare.

DateTimeRuleType

I tipi disponibili di regole di raggruppamento per data e ora. Questa documentazione presuppone che le impostazioni internazionali del foglio di lavoro siano "en-US", sebbene il rendering effettivo di date e ore utilizzi le impostazioni internazionali del foglio di lavoro per alcuni tipi di regole.

Enum
DATE_TIME_RULE_TYPE_UNSPECIFIED Il tipo predefinito, non utilizzare.
SECOND Raggruppa le date per secondo, da 0 a 59.
MINUTE Raggruppa le date per minuto, da 0 a 59.
HOUR Raggruppa le date per ora utilizzando un sistema di 24 ore, da 0 a 23.
HOUR_MINUTE Raggruppa le date per ora e minuti utilizzando un sistema di 24 ore, ad esempio 19:45.
HOUR_MINUTE_AMPM Raggruppa le date per ora e minuti utilizzando un sistema a 12 ore, ad esempio 19:45. La designazione AM/PM viene tradotta in base alle impostazioni internazionali del foglio di lavoro.
DAY_OF_WEEK Raggruppa le date in base al giorno della settimana, ad esempio domenica. I giorni della settimana verranno tradotti in base alle impostazioni internazionali del foglio di lavoro.
DAY_OF_YEAR Raggruppa le date per giorno dell'anno, da 1 a 366. Tieni presente che le date successive al 29 febbraio rientrano in categorie diverse negli anni bisestili rispetto agli anni non bisestili.
DAY_OF_MONTH Raggruppa le date per giorno del mese, da 1 a 31.
DAY_MONTH Raggruppa le date per giorno e mese, ad esempio 22-nov. Il mese viene tradotto in base alle impostazioni internazionali del foglio di lavoro.
MONTH Raggruppa le date per mese, ad esempio novembre. Il mese viene tradotto in base alle impostazioni internazionali del foglio di lavoro.
QUARTER Raggruppa le date in base al trimestre, ad esempio T1 (che rappresenta gennaio-marzo).
YEAR Raggruppa le date per anno, ad esempio 2008.
YEAR_MONTH Raggruppa le date per anno e mese, ad esempio 2008-nov. Il mese viene tradotto in base alle impostazioni internazionali del foglio di lavoro.
YEAR_QUARTER Raggruppa le date per anno e trimestre, ad esempio T4 2008.
YEAR_MONTH_DAY Raggruppa le date per anno, mese e giorno, ad esempio 2008-11-22.

PivotGroupLimit

Il limite al numero di righe o colonne nel gruppo pivot.

Rappresentazione JSON 
{
  "countLimit": integer,
  "applyOrder": integer
}
Campi
countLimit

integer

Il limite di conteggio.

applyOrder

integer

L'ordine in cui il limite di gruppi viene applicato alla tabella pivot.

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

Per le richieste di scrittura, questo campo deve essere impostato con un numero univoco per personalizzare completamente gli ordini di applicazione per tutti i limiti del gruppo pivot. In caso contrario, l'ordine viene determinato dall'indice nell'elenco PivotTable.rows e poi dall'elenco PivotTable.columns.

PivotFilterCriteria

Criteri per mostrare/nascondere le righe in una tabella pivot.

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

string

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

condition

object (BooleanCondition)

Una condizione che deve essere vera affinché i valori vengano visualizzati. ( visibleValues non sostituisce questa condizione: anche se un valore è presente nell'elenco, rimane 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 riempiti nella tabella pivot. Ad esempio, il valore della condizione =A1 in "Tabella pivot 1" viene considerato come 'Pivot Table 1'!$A$1.

È possibile fare riferimento ai dati di origine della tabella pivot tramite il nome dell'intestazione di colonna. Ad esempio, se i dati di origine contengono colonne denominate "Entrate" e "Costo" e alla colonna "Entrate" viene applicata una condizione di tipo NUMBER_GREATER e valore =Cost, vengono incluse solo le colonne in cui "Entrate" > "Costo".

visibleByDefault

boolean

Indica se i valori sono visibili per impostazione predefinita. Se il valore è true, visibleValues viene ignorato, vengono mostrati tutti i valori che soddisfano condition (se specificati). Se è falso, vengono mostrati i valori che sono entrambi in visibleValues e soddisfano condition.

PivotFilterSpec

I criteri di filtro della tabella pivot associati a uno specifico offset della colonna di origine.

Rappresentazione 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.
}
Campi
filterCriteria

object (PivotFilterCriteria)

I criteri per la colonna.

Campo di unione source. La colonna di origine a cui si applica questo filtro. source può essere solo uno dei seguenti:
columnOffsetIndex

integer

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

dataSourceColumnReference

object (DataSourceColumnReference)

Il riferimento alla colonna dell'origine dati.

PivotValue

La definizione di come deve essere calcolato un valore in una tabella pivot.

Rappresentazione 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.
}
Campi
summarizeFunction

enum (PivotValueSummarizeFunction)

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

name

string

Un nome da utilizzare per il valore.

calculatedDisplayType

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, questo valore è chiamato "Mostra come" nella sezione dei valori di una tabella pivot.

Campo di unione value. I dati da utilizzare per i valori della tabella pivot. Deve essere impostato esattamente un valore. value può essere solo uno dei seguenti:
sourceColumnOffset

integer

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

Ad esempio, se l'origine era C10:E15, sourceColumnOffset di 0 significa che questo valore si riferisce alla colonna C, mentre l'offset 1 farà riferimento alla colonna D.

formula

string

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

dataSourceColumnReference

object (DataSourceColumnReference)

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

PivotValueSummarizeFunction

Una funzione per riepilogare un valore pivot.

Enum
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED L'impostazione predefinita: non utilizzare.
SUM Corrisponde alla funzione SUM.
COUNTA Corrisponde alla funzione COUNTA.
COUNT Corrisponde alla funzione COUNT.
COUNTUNIQUE Corrisponde alla funzione COUNTUNIQUE.
AVERAGE Corrisponde alla funzione AVERAGE.
MAX Corrisponde alla funzione MAX.
MIN Corrisponde alla funzione MIN.
MEDIAN Corrisponde alla funzione MEDIAN.
PRODUCT Corrisponde alla funzione PRODUCT.
STDEV Corrisponde alla funzione STDEV.
STDEVP Corrisponde alla funzione STDEVP.
VAR Corrisponde alla funzione VAR.
VARP Corrisponde alla funzione VARP.
CUSTOM Indica che la formula deve essere utilizzata così com'è. Valida solo se è stato impostato PivotValue.formula.
NONE Indica che il valore è già stato riepilogato e la funzione di riassunto non è specificata in modo esplicito. Utilizzato per le tabelle pivot dell'origine dati di Looker in cui il valore è già riepilogato.

PivotValueCalculatedDisplayType

Le possibili modalità di calcolo dei valori pivot per la visualizzazione.

Enum
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED Valore predefinito, non utilizzare.
PERCENT_OF_ROW_TOTAL Mostra i valori pivot come percentuale dei valori totali della riga.
PERCENT_OF_COLUMN_TOTAL Mostra i valori pivot come percentuale dei valori totali della colonna.
PERCENT_OF_GRAND_TOTAL Mostra i valori pivot come percentuale dei valori totali complessivi.

PivotValueLayout

Il layout dei valori pivot.

Enum
HORIZONTAL I valori sono disposti orizzontalmente (come colonne).
VERTICAL I valori sono disposti verticalmente (come righe).