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)

Jede Zeilengruppierung in der Pivot-Tabelle.

object (PivotGroup)

Jede Spaltengruppierung in der Pivot-Tabelle.

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

Eine optionale Zuordnung von Filtern pro Quellspalten-Offset.

Die Filter werden angewendet, bevor die Daten in der Pivot-Tabelle zusammengefasst werden. Der Schlüssel der Karte ist der Spaltenversatz des Quellbereichs, den Sie filtern möchten. Der Wert ist das Kriterium für diese Spalte.

Wenn die Quelle beispielsweise C10:E15, ein Schlüssel von 0 den Filter für die Spalte C, während der Schlüssel 1 ist für Spalte D

Dieses Feld wird zugunsten von filterSpecs

object (PivotFilterSpec)

Die Filter, die auf die Quellspalten angewendet wurden, bevor die Daten für die Pivot-Tabelle aggregiert wurden.

Beide criteria und filterSpecs in den Antworten eingefügt. Wenn in einer Aktualisierungsanfrage beide Felder angegeben sind, hat dieses Feld Vorrang.

object (PivotValue)

Eine Liste der in die Pivot-Tabelle aufzunehmenden Werte.

enum (PivotValueLayout)

Legt fest, ob Werte horizontal (als Spalten) oder vertikal (als Zeilen) aufgelistet werden sollen

object (DataExecutionStatus)

Nur Ausgabe. Der Ausführungsstatus der Daten für Pivot-Tabellen der Datenquelle.

object (GridRange)

Bereich, aus dem die Pivot-Tabelle Daten liest.

string

Die ID der Datenquelle, aus der die Pivot-Tabelle Daten liest.

{
  "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", wenn die Pivot-Tabelle die Summen für diese Gruppierung enthalten soll.

object (PivotGroupValueMetadata)

Metadaten zu den Werten in der Gruppierung.

enum (SortOrder)

Die Reihenfolge, in der die Werte in dieser Gruppe sortiert werden sollen.

object (PivotGroupSortValueBucket)

Der Bucket der gegenüberliegenden Pivot-Gruppe, nach dem sortiert werden soll. Wenn nicht angegeben, erfolgt die Sortierung alphabetisch nach den Werten dieser Gruppe.

boolean

"True", wenn die Überschriften in dieser Pivot-Gruppe wiederholt werden sollen. Dies gilt nur für Zeilengruppierungen und wird von Spalten ignoriert.

Standardmäßig werden Wiederholungen von Überschriften minimiert, indem Überschriften auf höheren Ebenen nicht angezeigt werden, wenn sie identisch sind. Auch wenn die dritte Zeile unten beispielsweise „Q1 Mär“ entspricht, „Q1“ wird nicht angezeigt, da es im Vergleich zu vorherigen Zeilen redundant ist. Wenn „RepeatHeadings“ auf „true“ festgelegt ist, wird „Q1“ angezeigt. noch für „Feb“ zu wiederholen und „Mar“.

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

string

Die Labels für die Zeilen-/Spaltengruppen, die angepasst werden können. Beispiel: In der folgenden Pivot-Tabelle ist die Zeilenbeschriftung Region (die möglicherweise in State) und die Spaltenbeschriftung ist Product (die möglicherweise Item. Pivot-Tabellen, die vor Dezember 2017 erstellt wurden, haben keine Kopfzeilenlabels. Wenn Sie einer vorhandenen Pivot-Tabelle Überschriftenlabels hinzufügen möchten, löschen Sie die vorhandene Pivot-Tabelle und erstellen Sie dann eine neue Pivot-Tabelle mit denselben Parametern.

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

object (PivotGroupRule)

Die Gruppenregel, die auf diese Zeilen-/Spaltengruppe angewendet werden soll.

object (PivotGroupLimit)

Das Limit für Zeilen oder Spalten, das auf diese Pivot-Gruppe angewendet werden soll.

integer

Der Spaltenversatz des Quellbereichs, auf dem diese Gruppierung basiert.

Wenn die Quelle beispielsweise C10:E15, ein sourceColumnOffset von 0 bedeutet, dass sich diese Gruppe auf die Spalte C, während das Offset 1 auf Spalte D

object (DataSourceColumnReference)

Der Verweis auf die Datenquellenspalte, auf der diese Gruppierung basiert.

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

object (ExtendedValue)

Der berechnete Wert, dem die Metadaten entsprechen. (Hinweis: formulaValue ist ungültig, da die Werte berechnet werden.)

boolean

"True", wenn die dem Wert entsprechenden Daten minimiert sind.

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

integer

Der Offset im Feld PivotTable.values Liste, nach der die Werte in dieser Gruppierung sortiert werden sollen.

object (ExtendedValue)

Bestimmt den Bucket, aus dem Werte zum Sortieren ausgewählt werden.

Beispiel: In einer Pivot-Tabelle mit einer Zeilengruppe und zwei Spaltengruppen haben, kann die Zeilengruppe bis zu zwei Werte auflisten. Der erste Wert entspricht einem Wert in der ersten Spaltengruppe und der zweite Wert einem Wert in der zweiten Spaltengruppe. Wenn keine Werte aufgeführt sind, bedeutet dies, dass die Zeile nach der Spalte „Gesamtsumme“ sortiert werden sollte. auf die Spaltengruppen. Wenn ein einzelner Wert aufgeführt ist, entspricht dies der Verwendung von "Total". des Buckets.

{

  // 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)

A ManualRule

object (HistogramRule)

A HistogramRule

object (DateTimeRule)

A DateTimeRule

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

object (ManualRuleGroup)

Die Liste der Gruppennamen und die entsprechenden Elemente aus den Quelldaten, die den einzelnen Gruppennamen zugeordnet sind.

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

object (ExtendedValue)

Der Gruppenname, der ein String sein muss. Jede Gruppe in einer bestimmten ManualRule muss einen eindeutigen Gruppennamen haben.

object (ExtendedValue)

Die Elemente in den Quelldaten, die dieser Gruppe hinzugefügt werden sollen. Jedes Element kann ein String, eine Zahl oder ein boolescher Wert sein. Artikel dürfen in maximal einer Gruppe innerhalb einer bestimmten ManualRule Elemente, die in keiner Gruppe angezeigt werden, werden allein angezeigt.

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

number

Die Größe der erstellten Buckets. Muss positiv sein.

number

Der Minimalwert, bei dem Elemente in Buckets von konstanter Größe platziert werden. Werte unter dem Startwert werden in einem einzigen Bucket zusammengefasst. Dieses Feld ist optional.

number

Der Maximalwert, bei dem Elemente in Buckets von konstanter Größe platziert werden. Werte oberhalb des Endwerts werden in einem einzigen Bucket zusammengefasst. Dieses Feld ist optional.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

Der Typ der anzuwendenden Datum-Uhrzeit-Gruppierung.

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

integer

Das Limit für die Anzahl.

integer

Die Reihenfolge, in der das Gruppenlimit auf die Pivot-Tabelle angewendet wird.

Limits für Pivot-Gruppen werden von der niedrigeren zur höheren Reihenfolgenummer angewendet. Bestellnummern werden auf aufeinanderfolgende Ganzzahlen von 0 normalisiert.

Bei Schreibanfragen sollte dieses Feld für alle Grenzwerte für Pivot-Gruppen auf eine eindeutige Zahl gesetzt sein, um die angewendeten Aufträge vollständig anzupassen. Andernfalls wird die Reihenfolge durch den Index im PivotTable.rows und dann die PivotTable.columns Liste.

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

string

Werte, die enthalten sein sollten. Werte, die hier nicht aufgeführt sind, werden ausgeschlossen.

object (BooleanCondition)

Eine Bedingung, die erfüllt sein muss, damit Werte angezeigt werden. ( visibleValues überschreibt diesen Wert nicht. Selbst wenn ein Wert dort aufgelistet ist, bleibt er verborgen, wenn er die Bedingung nicht erfüllt.)

Bedingungswerte, die sich auf Bereiche in A1-Notation beziehen, werden relativ zum Pivot-Tabellenblatt ausgewertet. Verweise werden absolut behandelt, also werden in der Pivot-Tabelle nicht ausgefüllt. Beispiel: Der Bedingungswert =A1 zu "Pivot-Tabelle 1" wird behandelt als 'Pivot Table 1'!$A$1.

Auf die Quelldaten der Pivot-Tabelle kann durch die Spaltenüberschriften verwiesen werden. Wenn die Quelldaten z. B. Spalten mit dem Namen „Umsatz“ enthalten, und „Kosten“ und eine Bedingung auf den „Umsatz“ Spalte mit Typ NUMBER_GREATER und einen Wert =Cost, dann nur die Spalten mit „Umsatz“ > „Kosten“ enthalten sind.

boolean

Gibt an, ob Werte standardmäßig sichtbar sind. Falls wahr, wird die visibleValues ignoriert werden, werden alle Werte, die den condition (falls angegeben) angezeigt. Bei „false“ werden Werte, die beide in visibleValues und treffen Sie condition angezeigt werden.

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

Die Kriterien für die Spalte.

integer

Der nullbasierte Spaltenversatz des Quellbereichs.

object (DataSourceColumnReference)

Der Verweis auf die Datenquellenspalte.

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

Eine Funktion, mit der der Wert zusammengefasst wird. Wenn formula festgelegt ist, werden nur die Werte SUM und CUSTOM Wenn sourceColumnOffset festgelegt ist, dann CUSTOM wird nicht unterstützt.

string

Der Name, der für den Wert verwendet werden soll.

enum (PivotValueCalculatedDisplayType)

Falls angegeben, gibt es an, dass Pivot-Werte als Ergebnis einer Berechnung mit einem anderen Pivot-Wert angezeigt werden sollen. Beispiel: Wenn berechnetDisplayType als PERCENT_OF_GRAND_TOTAL angegeben ist, werden alle Pivot-Werte als Prozentsatz der Gesamtsumme angezeigt. Im Google Tabellen-Editor wird diese Option als "Anzeigen als" bezeichnet. im Abschnitt „value“ einer Pivot-Tabelle.

integer

Der Spaltenversatz des Quellbereichs, aus dem dieser Wert liest.

Wenn die Quelle beispielsweise C10:E15, ein sourceColumnOffset von 0 bedeutet, dass sich dieser Wert auf die Spalte C, während das Offset 1 auf Spalte D

string

Eine benutzerdefinierte Formel zum Berechnen des Werts. Die Formel muss mit einem = Zeichen.

object (DataSourceColumnReference)

Der Verweis auf die Datenquellenspalte, aus der dieser Wert liest.