PivotTable
Eine Pivot-Tabelle.
JSON-Darstellung |
---|
{ "rows": [ { object ( |
Felder | |
---|---|
rows[]
|
Jede Zeilengruppierung in der Pivot-Tabelle. |
columns[]
|
Jede Spaltengruppierung in der Pivot-Tabelle. |
criteria
|
Optionale Zuordnung von Filtern pro Offset der Quellspalte. Die Filter werden angewendet, bevor die Daten in der Pivot-Tabelle zusammengefasst werden. Der Schlüssel der Zuordnung ist der Spaltenoffset des Quellbereichs, den Sie filtern möchten, und der Wert sind die Kriterien für diese Spalte.
Wenn die Quelle beispielsweise
Dieses Feld wird zugunsten von |
filterSpecs[]
|
Die Filter, die auf die Quellspalten angewendet wurden, bevor Daten für die Pivot-Tabelle aggregiert wurden.
Beide
|
values[]
|
Eine Liste der Werte, die in die Pivot-Tabelle aufgenommen werden sollen. |
valueLayout
|
Ob die 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 darf nur einen der folgenden Werte haben:
|
|
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 keine Angabe erfolgt, erfolgt die Sortierung alphabetisch nach den Werten dieser Gruppe. |
repeatHeadings
|
"True", wenn die Überschriften in dieser Pivot-Gruppe wiederholt werden sollen. Diese Option ist nur für Zeilengruppierungen gültig und wird für Spalten ignoriert. Standardmäßig minimieren wir die Wiederholung von Überschriften, indem wir Überschriften höherer Ebene nicht anzeigen, 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 Sie „repeatHeadings“ auf „wahr“ setzen, wird „Q1“ für „Feb“ und „Mar“ wiederholt.
|
label
|
Die Labels für die Zeilen-/Spaltengruppen, die angepasst werden können. In der folgenden Pivot-Tabelle ist die Zeilenbeschriftung beispielsweise
|
groupRule
|
Die Gruppenregel, die auf diese Zeilen-/Spaltengruppe angewendet werden soll. |
groupLimit
|
Die maximale Anzahl von Zeilen oder Spalten, die 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 Spaltenoffset 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 in der Liste |
buckets[]
|
Bestimmt den Bucket, aus dem Werte für die Sortierung ausgewählt werden. In einer Pivot-Tabelle mit einer Zeilengruppe und zwei Spaltengruppen können beispielsweise bis zu zwei Werte in der Zeilengruppe aufgeführt werden. 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, sollte die Zeile nach dem Gesamtwert über die Spaltengruppen sortiert werden. 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. Pro Spalte in den Quelldaten kann nur eine PivotGroup
mit einer Gruppenregel hinzugefügt werden. Sie können jedoch jeder Spalte sowohl eine PivotGroup
mit einer Regel als auch eine PivotGroup
ohne Regel hinzufügen.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
rule . Die Regel, die auf den
PivotGroup
rule
kann nur einer der folgenden Werte sein:
|
|
manualRule
|
Ein |
histogramRule
|
Ein |
dateTimeRule
|
|
ManualRule
Hiermit können Sie die Werte in einer Quelldatenspalte manuell in Bucket mit von Ihnen gewählten Namen organisieren. Beispiel: Eine Pivot-Tabelle, in der die Bevölkerung nach Bundesstaat zusammengefasst wird:
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
kann in eine Pivot-Tabelle umgewandelt werden, in der die Bevölkerung nach Zeitzone zusammengefasst wird. Dazu muss einer manuellen Gruppenregel eine Liste von Gruppen (z. B. groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) zugewiesen werden. 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. Elemente können in einer bestimmten |
HistogramRule
Damit können Sie die numerischen Werte in einer Quelldatenspalte in Buckets mit konstanter Größe organisieren. Alle Werte von
HistogramRule.start
bis
HistogramRule.end
in Gruppen mit Größen von
HistogramRule.interval
Außerdem werden alle Werte unter HistogramRule.start
in eine Gruppe und alle Werte über HistogramRule.end
in eine andere Gruppe eingeordnet. 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 |
...
+-----+-------------------+
in eine Pivot-Tabelle umgewandelt werden kann, die wie die folgende aussieht, 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 Mindestwert, bei dem Elemente in Buckets mit konstanter Größe eingeordnet 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 über dem Endwert werden in einem einzigen Bucket zusammengefasst. Dieses Feld ist optional. |
DateTimeRule
Hiermit können Sie die Datums-/Uhrzeitwerte in einer Quelldatenspalte anhand ausgewählter Teile ihrer Datums- oder Uhrzeitwerte in Bucket sortieren. 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
|
Die Art der Datums-/Uhrzeitgruppierung, die angewendet werden soll. |
DateTimeRuleType
Die verfügbaren Typen von Regeln für die Gruppierung von Datum und Uhrzeit. In dieser Dokumentation wird davon ausgegangen, dass das Gebietsschema der Tabelle „en-US“ ist. Für einige Regeltypen wird jedoch das Gebietsschema der Tabelle für die tatsächliche Darstellung der Datumsangaben und Uhrzeiten verwendet.
Enums | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Dies ist der Standardtyp, nicht verwenden. |
SECOND
|
Gruppieren Sie Datumsangaben nach Sekunden, von 0 bis 59. |
MINUTE
|
Datumsangaben nach Minuten gruppieren, von 0 bis 59. |
HOUR
|
Gruppieren Sie Datumsangaben nach Stunden im 24-Stunden-Format von 0 bis 23. |
HOUR_MINUTE
|
Gruppieren Sie Datumsangaben nach Stunde und Minute im 24-Stunden-System, z. B. 19:45. |
HOUR_MINUTE_AMPM
|
Gruppieren Sie Datumsangaben nach Stunde und Minute im 12-Stunden-Format, z. B. 19:45 Uhr. Die Angabe von „Vormittags“ und „Nachmittags“ wird basierend auf dem Gebietsschema 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 Datumsangaben nach dem 29. Februar in Schaltjahren in andere Kategorien fallen als in Nicht-Schaltjahren. |
DAY_OF_MONTH
|
Gruppieren Sie Daten nach Tag des Monats von 1 bis 31. |
DAY_MONTH
|
Gruppieren Sie Datumsangaben nach Tag und Monat, z. B. 22-Nov. Der Monat wird basierend auf dem Gebietsschema der Tabelle übersetzt. |
MONTH
|
Gruppieren Sie die Datumsangaben nach Monat, z. B. November. Der Monat wird basierend auf dem Gebietsschema der Tabelle übersetzt. |
QUARTER
|
Gruppieren Sie die Daten nach Quartal, z. B. Q1 (Januar bis März). |
YEAR
|
Gruppieren Sie Datumsangaben nach Jahr, z. B. 2008. |
YEAR_MONTH
|
Gruppieren Sie Datumsangaben nach Jahr und Monat, z. B. 2008-Nov. Der Monat wird basierend auf dem Gebietsschema der Tabelle übersetzt. |
YEAR_QUARTER
|
Gruppieren Sie die Daten nach Jahr und Quartal, z. B. 2008 Q4. |
YEAR_MONTH_DAY
|
Gruppieren Sie Datumsangaben nach Jahr, Monat und Tag, z. B. 22.11.2008. |
PivotGroupLimit
Die Begrenzung für Zeilen oder Spalten in der Pivot-Gruppe.
JSON-Darstellung |
---|
{ "countLimit": integer, "applyOrder": integer } |
Felder | |
---|---|
countLimit
|
Das Zähllimit. |
applyOrder
|
Die Reihenfolge, in der das Gruppenlimit auf die Pivot-Tabelle angewendet wird. Die Limits für Pivot-Gruppen werden von der niedrigeren zur höheren Ordnungszahl angewendet. Bestellnummern werden auf aufeinanderfolgende Ganzzahlen von 0 normalisiert.
Bei Schreibanfragen sollten für alle Pivot-Gruppenbeschränkungen eindeutige Zahlen in diesem Feld festgelegt werden, damit die anwendbaren Reihenfolgen vollständig angepasst werden können. Andernfalls wird die Reihenfolge durch den Index in der Liste |
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 und nicht in die gesamte Pivot-Tabelle kopiert. Beispiel: Ein Bedingungswert von
Auf die Quelldaten der Pivot-Tabelle kann durch die Spaltenüberschriften verwiesen werden. Wenn die Quelldaten beispielsweise die Spalten „Umsatz“ und „Kosten“ enthalten und auf die Spalte „Umsatz“ eine Bedingung vom Typ |
visibleByDefault
|
Ob Werte standardmäßig sichtbar sind. Wenn diese Option aktiviert ist, werden die |
PivotFilterSpec
Die Filterkriterien für die Pivot-Tabelle, die mit einem bestimmten Offset der Quellspalte verknüpft 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
|
Ein 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 Editor von Google Tabellen wird dies im Wertebereich einer Pivot-Tabelle als „Als anzeigen“ bezeichnet. |
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 zur Berechnung des Werts. Die Formel muss mit dem Zeichen |
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 der Funktion SUM .
|
COUNTA
|
Entspricht dem
COUNTA
.
|
COUNT
|
Entspricht der Funktion COUNT .
|
COUNTUNIQUE
|
Entspricht dem
COUNTUNIQUE
.
|
AVERAGE
|
Entspricht der Funktion AVERAGE .
|
MAX
|
Entspricht dem
MAX
.
|
MIN
|
Entspricht der Funktion MIN .
|
MEDIAN
|
Entspricht der Funktion MEDIAN .
|
PRODUCT
|
Entspricht der Funktion PRODUCT .
|
STDEV
|
Entspricht dem
STDEV
.
|
STDEVP
|
Entspricht dem
STDEVP
.
|
VAR
|
Entspricht der Funktion VAR .
|
VARP
|
Entspricht der Funktion 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
|
Die Pivot-Werte werden als Prozentsatz der Zeilengesamtwerte angezeigt. |
PERCENT_OF_COLUMN_TOTAL
|
Zeigt die Pivot-Werte als Prozentsatz der Spaltengesamtwerte an. |
PERCENT_OF_GRAND_TOTAL
|
Die Pivot-Werte werden als Prozentsatz der Werte der Gesamtsumme angezeigt. |
PivotValueLayout
Das Layout von Pivot-Werten.
Enums | |
---|---|
HORIZONTAL
|
Die Werte werden horizontal (als Spalten) angeordnet. |
VERTICAL
|
Werte werden vertikal (als Zeilen) dargestellt. |