PivotTable
Eine Pivot-Tabelle.
JSON-Darstellung |
---|
{ "rows": [ { object ( |
Felder | |
---|---|
rows[]
|
Jede Zeilengruppierung in der Pivot-Tabelle. |
columns[]
|
Jede Spaltengruppierung in der Pivot-Tabelle. |
criteria
|
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
Dieses Feld wird zugunsten von
|
filterSpecs[]
|
Die Filter, die auf die Quellspalten angewendet wurden, bevor die Daten für die Pivot-Tabelle aggregiert wurden.
Beide
|
values[]
|
Eine Liste der in die Pivot-Tabelle aufzunehmenden Werte. |
valueLayout
|
Legt fest, ob Werte horizontal (als Spalten) oder vertikal (als Zeilen) aufgelistet werden sollen |
dataExecutionStatus
|
Nur Ausgabe. Der Ausführungsstatus der Daten für Pivot-Tabellen der Datenquelle. |
Union-Feld
source_data Die Quelle der Pivot-Tabellendaten.
source_data
kann nur einer der folgenden Werte sein:
|
|
source
|
Bereich, aus dem die Pivot-Tabelle Daten liest. |
dataSourceId
|
Die ID der Datenquelle, aus der die Pivot-Tabelle Daten liest. |
PivotGroup
Eine einzelne Gruppierung (entweder Zeile oder Spalte) in einer Pivot-Tabelle.
JSON-Darstellung |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
Felder | |
---|---|
showTotals
|
"True", wenn die Pivot-Tabelle die Summen für diese Gruppierung enthalten soll. |
valueMetadata[]
|
Metadaten zu den Werten in der Gruppierung. |
sortOrder
|
Die Reihenfolge, in der die Werte in dieser Gruppe sortiert werden sollen. |
valueBucket
|
Der Bucket der gegenüberliegenden Pivot-Gruppe, nach dem sortiert werden soll. Wenn nicht angegeben, erfolgt die Sortierung alphabetisch nach den Werten dieser Gruppe. |
repeatHeadings
|
"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“.
|
label
|
Die Labels für die Zeilen-/Spaltengruppen, die angepasst werden können. Beispiel: In der folgenden Pivot-Tabelle ist die Zeilenbeschriftung
|
groupRule
|
Die Gruppenregel, die auf diese Zeilen-/Spaltengruppe angewendet werden soll. |
groupLimit
|
Das Limit für Zeilen oder Spalten, das auf diese Pivot-Gruppe angewendet werden soll. |
Union-Feld
source Die Datenquelle der Pivot-Gruppe.
source
kann nur einer der folgenden Werte sein:
|
|
sourceColumnOffset
|
Der Spaltenversatz des Quellbereichs, auf dem diese Gruppierung basiert.
Wenn die Quelle beispielsweise
|
dataSourceColumnReference
|
Der Verweis auf die Datenquellenspalte, auf der diese Gruppierung basiert. |
PivotGroupValueMetadata
Metadaten zu einem Wert in einer Pivot-Gruppierung.
JSON-Darstellung |
---|
{
"value": {
object (
|
Felder | |
---|---|
value
|
Der berechnete Wert, dem die Metadaten entsprechen. (Hinweis:
|
collapsed
|
"True", wenn die dem Wert entsprechenden Daten minimiert sind. |
PivotGroupSortValueBucket
Informationen darüber, welche Werte in einer Pivot-Gruppe zum Sortieren verwendet werden sollen.
JSON-Darstellung |
---|
{
"valuesIndex": integer,
"buckets": [
{
object (
|
Felder | |
---|---|
valuesIndex
|
Der Offset im Feld
|
buckets[]
|
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. |
PivotGroupRule
Eine optionale Einstellung auf einer
PivotGroup
definiert Gruppen für die Werte in der Quelldatenspalte, anstatt jeden einzelnen Wert aufzuschlüsseln. Nur eine
PivotGroup
mit einer Gruppenregel kann für jede Spalte in den Quelldaten hinzugefügt werden. Sie können jedoch für jede Spalte sowohl ein
PivotGroup
mit einer Regel und einem
PivotGroup
aber das ist nicht der Fall.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
rule Die Regel, die auf den
PivotGroup
rule
kann nur einer der folgenden Werte sein:
|
|
manualRule
|
|
histogramRule
|
|
dateTimeRule
|
|
ManualRule
Damit können Sie die Werte in einer Quelldatenspalte manuell in Buckets mit Namen Ihrer Wahl organisieren. Beispiel für eine Pivot-Tabelle, die die Bevölkerung nach Bundesstaat aggregiert:
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
könnte in eine Pivot-Tabelle umgewandelt werden, die die Bevölkerung nach Zeitzone aggregiert, indem einer manuellen Gruppenregel eine Liste von Gruppen (zum Beispiel groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) zur Verfügung gestellt wird. Ein ähnlicher Effekt kann erzielt werden, wenn den Quelldaten eine Zeitzonenspalte hinzugefügt und die Pivot-Tabelle angepasst wird.
+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central | 106.3 |
| Eastern | 151.9 |
| Mountain | 17.4 |
...
+-----------+-------------------+
JSON-Darstellung |
---|
{
"groups": [
{
object (
|
Felder | |
---|---|
groups[]
|
Die Liste der Gruppennamen und die entsprechenden Elemente aus den Quelldaten, die den einzelnen Gruppennamen zugeordnet sind. |
ManualRuleGroup
Ein Gruppenname und eine Liste von Elementen aus den Quelldaten, die der Gruppe mit diesem Namen hinzugefügt werden sollen.
JSON-Darstellung |
---|
{ "groupName": { object ( |
Felder | |
---|---|
groupName
|
Der Gruppenname, der ein String sein muss. Jede Gruppe in einer bestimmten
|
items[]
|
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
|
HistogramRule
Damit können Sie die numerischen Werte in einer Quelldatenspalte in Buckets mit konstanter Größe unterteilen. Alle Werte von
HistogramRule.start
bis
HistogramRule.end
in Gruppen mit Größen von
HistogramRule.interval
Außerdem werden alle Werte unter
HistogramRule.start
werden in einer Gruppe platziert und alle Werte darüber
HistogramRule.end
in einer anderen. Nur
HistogramRule.interval
ist jedoch erforderlich, wenn
HistogramRule.start
und
HistogramRule.end
bereitgestellt werden,
HistogramRule.start
muss kleiner sein als
HistogramRule.end
Zum Beispiel eine Pivot-Tabelle mit mehr als 50 Zeilen, die den durchschnittlichen Kaufbetrag nach Alter zeigt:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
könnte in eine Pivot-Tabelle wie die folgende umgewandelt werden, indem eine Histogramm-Gruppenregel mit einem
HistogramRule.start
von 25, ein
HistogramRule.interval
von 20 und ein
HistogramRule.end
von 65.
+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25 | $19.34 |
| 25-45 | $31.43 |
| 45-65 | $35.87 |
| > 65 | $27.55 |
+-------------+-------------------+
| Grand Total | $29.12 |
+-------------+-------------------+
JSON-Darstellung |
---|
{ "interval": number, "start": number, "end": number } |
Felder | |
---|---|
interval
|
Die Größe der erstellten Buckets. Muss positiv sein. |
start
|
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. |
end
|
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. |
DateTimeRule
Damit können Sie die Datum/Uhrzeit-Werte in einer Quelldatenspalte basierend auf ausgewählten Teilen ihrer Datums- oder Uhrzeitwerte in Gruppen organisieren. Betrachten Sie zum Beispiel eine Pivot-Tabelle mit Verkaufstransaktionen nach Datum:
+----------+--------------+
| Date | SUM of Sales |
+----------+--------------+
| 1/1/2017 | $621.14 |
| 2/3/2017 | $708.84 |
| 5/8/2017 | $326.84 |
...
+----------+--------------+
Wenn Sie eine Datums-/Uhrzeit-Gruppenregel mit einer
DateTimeRuleType
von YEAR_MONTH ergibt die folgende Pivot-Tabelle.
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
JSON-Darstellung |
---|
{
"type": enum (
|
Felder | |
---|---|
type
|
Der Typ der anzuwendenden Datum-Uhrzeit-Gruppierung. |
DateTimeRuleType
Die verfügbaren Arten von Datum-Uhrzeit-Gruppierungsregeln. In dieser Dokumentation wird davon ausgegangen, dass das Gebietsschema für die Tabelle "en-US" ist. Für die tatsächliche Darstellung der Datums- und Uhrzeitangaben wird jedoch für einige Regeltypen das Gebietsschema der Tabelle verwendet.
Enums | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Dies ist der Standardtyp, nicht verwenden. |
SECOND
|
Gruppieren Sie Datumsangaben nach Sekunden, von 0 bis 59. |
MINUTE
|
Gruppieren Sie Datumsangaben nach Minuten von 0 bis 59. |
HOUR
|
Gruppieren Sie Datumsangaben im 24-Stunden-System von 0 bis 23. |
HOUR_MINUTE
|
Gruppieren Sie Datumsangaben im 24-Stunden-System nach Stunde und Minute, z. B. 19:45. |
HOUR_MINUTE_AMPM
|
Gruppieren Sie Datumsangaben in einem 12-Stunden-System nach Stunde und Minute, z. B. 19:45 Uhr. Die AM/PM-Kennzeichnung wird basierend auf der Sprache der Tabelle übersetzt. |
DAY_OF_WEEK
|
Gruppieren Sie Daten nach Wochentag, z. B. Sonntag. Die Wochentage werden entsprechend der Sprache der Tabelle übersetzt. |
DAY_OF_YEAR
|
Gruppieren Sie Daten nach Tag des Jahres von 1 bis 366. Beachten Sie, dass Daten nach dem 29. Februar in Schaltjahren in andere Kategorien fallen als in anderen. |
DAY_OF_MONTH
|
Gruppieren Sie Daten nach Tag des Monats von 1 bis 31. |
DAY_MONTH
|
Gruppieren Sie Daten nach Tag und Monat, z. B. 22–Nov. Der Monat wird anhand des in der Tabelle angegebenen Gebietsschemas übersetzt. |
MONTH
|
Gruppieren Sie Datumsangaben nach Monat, z. B. Nov. Der Monat wird basierend auf der Sprache der Tabelle übersetzt. |
QUARTER
|
Gruppieren Sie Daten nach Quartal, z. B. Q1 (für Januar bis März). |
YEAR
|
Gruppieren Sie Daten nach Jahr, z. B. 2008. |
YEAR_MONTH
|
Gruppieren Sie Daten nach Jahr und Monat, z. B. 2008-Nov. Der Monat wird anhand des in der Tabelle angegebenen Gebietsschemas übersetzt. |
YEAR_QUARTER
|
Gruppieren Sie Daten nach Jahr und Quartal, z. B. 2008 Q4. |
YEAR_MONTH_DAY
|
Gruppieren Sie Daten nach Jahr, Monat und Tag, z. B. 2008-11-22. |
PivotGroupLimit
Die Begrenzung für Zeilen oder Spalten in der Pivot-Gruppe.
JSON-Darstellung |
---|
{ "countLimit": integer, "applyOrder": integer } |
Felder | |
---|---|
countLimit
|
Das Limit für die Anzahl. |
applyOrder
|
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
|
PivotFilterCriteria
Kriterien zum Ein-/Ausblenden von Zeilen in einer Pivot-Tabelle.
JSON-Darstellung |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
Felder | |
---|---|
visibleValues[]
|
Werte, die enthalten sein sollten. Werte, die hier nicht aufgeführt sind, werden ausgeschlossen. |
condition
|
Eine Bedingung, die erfüllt sein muss, damit Werte angezeigt werden. (
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
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
|
visibleByDefault
|
Gibt an, ob Werte standardmäßig sichtbar sind. Falls wahr, wird die
|
PivotFilterSpec
Die Filterkriterien für die Pivot-Tabelle, die einem bestimmten Quellspaltenversatz zugeordnet sind.
JSON-Darstellung |
---|
{ "filterCriteria": { object ( |
Felder | |
---|---|
filterCriteria
|
Die Kriterien für die Spalte. |
Union-Feld
source Die Quellspalte, auf die dieser Filter angewendet wird.
source
kann nur einer der folgenden Werte sein:
|
|
columnOffsetIndex
|
Der nullbasierte Spaltenversatz des Quellbereichs. |
dataSourceColumnReference
|
Der Verweis auf die Datenquellenspalte. |
PivotValue
Die Definition, wie ein Wert in einer Pivot-Tabelle berechnet werden soll.
JSON-Darstellung |
---|
{ "summarizeFunction": enum ( |
Felder | |
---|---|
summarizeFunction
|
Eine Funktion, mit der der Wert zusammengefasst wird. Wenn
|
name
|
Der Name, der für den Wert verwendet werden soll. |
calculatedDisplayType
|
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. |
Union-Feld
value Die Daten, die für die Werte in der Pivot-Tabelle verwendet werden sollen. Es muss genau ein Wert festgelegt werden.
value
kann nur einer der folgenden Werte sein:
|
|
sourceColumnOffset
|
Der Spaltenversatz des Quellbereichs, aus dem dieser Wert liest.
Wenn die Quelle beispielsweise
|
formula
|
Eine benutzerdefinierte Formel zum Berechnen des Werts. Die Formel muss mit einem
|
dataSourceColumnReference
|
Der Verweis auf die Datenquellenspalte, aus der dieser Wert liest. |
PivotValueSummarizeFunction
Eine Funktion zum Zusammenfassen eines Pivot-Werts.
Enums | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
Nicht verwenden. |
SUM
|
Entspricht dem
SUM
.
|
COUNTA
|
Entspricht dem
COUNTA
.
|
COUNT
|
Entspricht dem
COUNT
.
|
COUNTUNIQUE
|
Entspricht dem
COUNTUNIQUE
.
|
AVERAGE
|
Entspricht dem
AVERAGE
.
|
MAX
|
Entspricht dem
MAX
.
|
MIN
|
Entspricht dem
MIN
.
|
MEDIAN
|
Entspricht dem
MEDIAN
.
|
PRODUCT
|
Entspricht dem
PRODUCT
.
|
STDEV
|
Entspricht dem
STDEV
.
|
STDEVP
|
Entspricht dem
STDEVP
.
|
VAR
|
Entspricht dem
VAR
.
|
VARP
|
Entspricht dem
VARP
.
|
CUSTOM
|
Gibt an, dass die Formel in der vorliegenden Form verwendet werden muss. Nur gültig, wenn
PivotValue.formula
festgelegt wurde.
|
NONE
|
Gibt an, dass der Wert bereits zusammengefasst ist und die Zusammenfassungsfunktion nicht explizit angegeben ist. Wird für Pivot-Tabellen der Looker-Datenquelle verwendet, bei denen der Wert bereits zusammengefasst ist. |
PivotValueCalculatedDisplayType
Die Möglichkeiten, wie Pivot-Werte für die Anzeige berechnet werden können.
Enums | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
Standardwert, nicht verwenden. |
PERCENT_OF_ROW_TOTAL
|
Zeigt die Pivot-Werte als Prozentsatz der Zeilengesamtwerte an. |
PERCENT_OF_COLUMN_TOTAL
|
Zeigt die Pivot-Werte als Prozentsatz der Spaltengesamtwerte an. |
PERCENT_OF_GRAND_TOTAL
|
Zeigt die Pivot-Werte als Prozentsatz der Gesamtsummenwerte an. |
PivotValueLayout
Das Layout von Pivot-Werten.
Enums | |
---|---|
HORIZONTAL
|
Die Werte werden horizontal als Spalten dargestellt. |
VERTICAL
|
Werte werden vertikal (als Zeilen) dargestellt. |