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 Quellspaltenversatz. Die Filter werden angewendet, bevor Daten in der Pivot-Tabelle aggregiert werden. Der Schlüssel der Zuordnung ist der Spaltenversatz des Quellbereichs, den Sie filtern möchten, und der Wert ist das Kriterium für diese Spalte.
Wenn die Quelle beispielsweise
Dieses Feld wurde zugunsten von |
filterSpecs[]
|
Die Filter, die auf die Quellspalten angewendet wurden, bevor Daten für die Pivot-Tabelle aggregiert wurden.
Sowohl |
values[]
|
Eine Liste der Werte, die in der Pivot-Tabelle enthalten sein sollen. |
valueLayout
|
Gibt an, ob Werte horizontal (als Spalten) oder vertikal (als Zeilen) aufgelistet werden sollen. |
dataExecutionStatus
|
Nur Ausgabe. Der Status der Datenausführung für Pivot-Tabellen der Datenquelle. |
Union-Feld source_data . Die Quelle der Daten in der Pivot-Tabelle.
Für source_data ist nur einer der folgenden Werte zulässig:
|
|
source
|
Der 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
|
Dieser Wert ist „True“, wenn die Pivot-Tabelle die Summen für diese Gruppierung enthalten soll. |
valueMetadata[]
|
Metadaten zu Werten in der Gruppierung. |
sortOrder
|
Die Reihenfolge, in der die Werte in dieser Gruppe sortiert werden sollen. |
valueBucket
|
Bucket der gegenüberliegenden Pivot-Gruppe, nach der sortiert werden soll. Falls nicht angegeben, erfolgt die Sortierung alphabetisch nach den Werten dieser Gruppe. |
repeatHeadings
|
Dieser Wert ist „True“, wenn die Überschriften in dieser Pivot-Gruppe wiederholt werden sollen. Dies gilt nur für Zeilengruppierungen und wird von Spalten ignoriert. Standardmäßig minimieren wir Wiederholungen von Überschriften, indem wir keine Überschriften höherer Ebene anzeigen, wenn sie identisch sind. Obwohl die dritte Zeile unten beispielsweise „Q1 Mar“ entspricht, wird „Q1“ nicht angezeigt, da sie im Vergleich zu den vorherigen Zeilen redundant ist. Wenn „RepeatHeadings“ auf „true“ festgelegt ist, wird „Q1“ für „Feb“ und „Mär“ wiederholt.
|
label
|
Die zu verwendenden Beschriftungen für die Zeilen-/Spaltengruppen, die angepasst werden können. In der folgenden Pivot-Tabelle lautet das Zeilenlabel
|
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.
Für source ist nur einer der folgenden Werte zulässig:
|
|
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. |
collapsed
|
„True“, wenn die Daten für den Wert 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 |
buckets[]
|
Bestimmt den Bucket, aus dem die Werte zum Sortieren ausgewählt werden. Beispiel: In einer Pivot-Tabelle mit einer Zeilengruppe und zwei Spaltengruppen kann die Zeilengruppe bis zu zwei Werte enthalten. 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 gemäß der Gesamtsumme über die Spaltengruppen sortiert werden soll. Wenn ein einzelner Wert aufgeführt ist, entspricht dies der Verwendung des Gesamtwerts dieses Buckets. |
PivotGroupRule
Eine optionale Einstellung für eine PivotGroup
, die Buckets für die Werte in der Quelldatenspalte definiert, anstatt jeden einzelnen Wert aufzuschlüsseln. Für jede Spalte in den Quelldaten kann nur eine PivotGroup
mit einer Gruppenregel hinzugefügt werden. Sie können jedoch für jede Spalte sowohl einen PivotGroup
mit einer Regel als auch ein PivotGroup
ohne Regel hinzufügen.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld rule . Die Regel, die auf PivotGroup angewendet werden soll.
Für rule ist nur einer der folgenden Werte zulässig:
|
|
manualRule
|
Ein |
histogramRule
|
Ein |
dateTimeRule
|
Ein |
ManualRule
Damit können Sie die Werte in einer Quelldatenspalte manuell in Buckets mit Namen Ihrer Wahl organisieren. Hier ein 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 |
...
+-------+-------------------+
in eine Pivot-Tabelle umgewandelt werden, in der die Bevölkerung nach Zeitzone aggregiert wird, indem eine Liste von Gruppen (z. B. groupName = 'Central', items = ['AL', 'AR', 'IA' ...]) für eine manuelle Gruppenregel bereitgestellt wird. Ein ähnlicher Effekt kann erzielt werden, indem eine Zeitzonenspalte zu den Quelldaten 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 der entsprechenden Elemente aus den Quelldaten, die den einzelnen Gruppennamen zugeordnet sind. |
ManualRuleGroup
Ein Gruppenname und eine Liste der Elemente aus den Quelldaten, die in die Gruppe mit diesem Namen aufgenommen werden sollen.
JSON-Darstellung |
---|
{ "groupName": { object ( |
Felder | |
---|---|
groupName
|
Der Gruppenname, der ein String sein muss Jede Gruppe in einer |
items[]
|
Die Elemente in den Quelldaten, die in diese Gruppe aufgenommen werden sollen. Jedes Element kann ein String, eine Zahl oder ein boolescher Wert sein. Elemente dürfen innerhalb einer |
HistogramRule
Mit dieser Funktion können Sie die numerischen Werte in einer Quelldatenspalte in Buckets konstanter Größe organisieren. Alle Werte von HistogramRule.start
bis HistogramRule.end
werden in Gruppen der Größe HistogramRule.interval
platziert. Außerdem werden alle Werte unter HistogramRule.start
in einer Gruppe und alle Werte über HistogramRule.end
in eine andere platziert. Es ist nur HistogramRule.interval
erforderlich. Wenn sowohl HistogramRule.start
als auch HistogramRule.end
angegeben sind, muss HistogramRule.start
kleiner als HistogramRule.end
sein. Hier ein Beispiel für 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, die wie unten gezeigt aussieht. Dazu wenden Sie eine Histogrammgruppenregel mit einem HistogramRule.start
von 25, einem HistogramRule.interval
von 20 und einem HistogramRule.end
von 65 an.
+-------------+-------------------+
| 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 Artikel in Buckets konstanter Größe platziert werden. Werte unterhalb des Startwerts werden in einem einzelnen Bucket zusammengefasst. Dieses Feld ist optional. |
end
|
Der Maximalwert, bei dem Artikel in Buckets konstanter Größe platziert werden. Die 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 Buckets organisieren. Nehmen wir als 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-/Uhrzeitgruppenregel mit einem DateTimeRuleType
von YEAR_MONTH anwenden, ergibt sich 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 Datum/Uhrzeit-Gruppierung, die angewendet werden soll. |
DateTimeRuleType
Die verfügbaren Arten von Gruppierungsregeln für Datum und Uhrzeit. In dieser Dokumentation wird davon ausgegangen, dass das Gebietsschema für die Tabellenkalkulation „en-US“ ist, auch wenn bei einigen Regeltypen bei der tatsächlichen Wiedergabe von Datum und Uhrzeit das Gebietsschema der Tabellenkalkulation verwendet wird.
Enums | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Standardtyp, nicht verwenden. |
SECOND
|
Daten nach Sekunden gruppieren (von 0 bis 59). |
MINUTE
|
Daten nach Minute gruppieren (von 0 bis 59). |
HOUR
|
Daten nach Stunden mithilfe eines 24-Stunden-Systems von 0 bis 23 gruppieren. |
HOUR_MINUTE
|
Gruppieren Sie Datumsangaben nach Stunde und Minute anhand eines 24-Stunden-Systems, z. B. 19:45. |
HOUR_MINUTE_AMPM
|
Daten nach Stunde und Minute in einem 12-Stunden-System gruppieren, z. B. 19:45 Uhr. Die AM/PM-Bezeichnung wird entsprechend der Sprache der Tabelle übersetzt. |
DAY_OF_WEEK
|
Daten nach Wochentag gruppieren, z. B. Sonntag Die Wochentage werden entsprechend der Sprache der Tabelle übersetzt. |
DAY_OF_YEAR
|
Daten nach Jahrestag gruppieren (von 1 bis 366). Beachten Sie, dass Daten nach dem 29. Februar in Schaltjahren in andere Kategorien fallen als in Nicht-Schaltjahren. |
DAY_OF_MONTH
|
Daten nach Monat gruppieren, von 1 bis 31. |
DAY_MONTH
|
Gruppieren Sie Datumsangaben nach Tag und Monat, z. B. 22. November. Der Monat wird entsprechend der Sprache der Tabelle übersetzt. |
MONTH
|
Gruppieren Sie Daten nach Monat, z. B. Nov. Der Monat wird entsprechend 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 Datumsangaben nach Jahr und Monat, z. B. 2008 bis November. Der Monat wird in die Sprache der Tabelle übersetzt. |
YEAR_QUARTER
|
Daten nach Jahr und Quartal gruppieren, z. B. 2008 Q4. |
YEAR_MONTH_DAY
|
Gruppieren Sie Daten nach Jahr, Monat und Tag, z. B. 2008-11-22. |
PivotGroupLimit
Das Limit 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. Grenzwerte für Pivot-Gruppen werden von der niedrigeren zur höheren Auftragsnummer angewendet. Bestellnummern werden auf aufeinanderfolgende Ganzzahlen von 0 normalisiert.
Um bei Schreibanfragen die angewendeten Aufträge vollständig anzupassen, sollte für alle Limits für Pivot-Gruppen in diesem Feld eine eindeutige Zahl festgelegt sein. Andernfalls wird die Reihenfolge durch den Index in der |
PivotFilterCriteria
Kriterien zum Ein-/Ausblenden von Zeilen in einer Pivot-Tabelle.
JSON-Darstellung |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
Felder | |
---|---|
visibleValues[]
|
Werte, die enthalten sein sollen. Werte, die hier nicht aufgeführt sind, sind 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 die Pivot-Tabellen nicht ausgefüllt. Der Bedingungswert
Auf die Quelldaten der Pivot-Tabelle kann durch die Spaltenüberschrift verwiesen werden. Wenn die Quelldaten beispielsweise Spalten namens „Umsatz“ und „Kosten“ enthalten und auf die Spalte „Umsatz“ eine Bedingung vom Typ |
visibleByDefault
|
Gibt an, ob Werte standardmäßig sichtbar sind. Bei „true“ werden die |
PivotFilterSpec
Die Filterkriterien für Pivot-Tabellen, die mit einem bestimmten Versatz von Quellspalten 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.
Für source ist nur einer der folgenden Werte zulässig:
|
|
columnOffsetIndex
|
Der nullbasierte Spaltenversatz des Quellbereichs. |
dataSourceColumnReference
|
Der Verweis auf die Datenquellenspalte. |
PivotValue
Definition, wie ein Wert in einer Pivot-Tabelle berechnet werden soll.
JSON-Darstellung |
---|
{ "summarizeFunction": enum ( |
Felder | |
---|---|
summarizeFunction
|
Eine Funktion, um den Wert zusammenzufassen. Wenn |
name
|
Ein Name, der für den Wert verwendet werden soll. |
calculatedDisplayType
|
Falls angegeben, werden Pivot-Werte als Ergebnis einer Berechnung mit einem anderen Pivot-Wert angezeigt. Wenn beispielsweise PERCENT_OF_GRAND_TOTAL als „countedDisplayType“ angegeben ist, werden alle Pivot-Werte als Prozentsatz der Gesamtsumme angezeigt. Im Google Tabellen-Editor wird dies im Bereich „Werte“ von Pivot-Tabellen als „Anzeigen als“ 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.
Für value ist nur einer der folgenden Werte zulässig:
|
|
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
|
Standardeinstellung, nicht verwenden. |
SUM
|
Entspricht der Funktion SUM .
|
COUNTA
|
Entspricht der Funktion COUNTA .
|
COUNT
|
Entspricht der Funktion COUNT .
|
COUNTUNIQUE
|
Entspricht der Funktion COUNTUNIQUE .
|
AVERAGE
|
Entspricht der Funktion AVERAGE .
|
MAX
|
Entspricht der Funktion MAX .
|
MIN
|
Entspricht der Funktion MIN .
|
MEDIAN
|
Entspricht der Funktion MEDIAN .
|
PRODUCT
|
Entspricht der Funktion PRODUCT .
|
STDEV
|
Entspricht der Funktion STDEV .
|
STDEVP
|
Entspricht der Funktion STDEVP .
|
VAR
|
Entspricht der Funktion VAR .
|
VARP
|
Entspricht der Funktion VARP .
|
CUSTOM
|
Gibt an, dass die Formel unverändert verwendet werden soll. Nur gültig, wenn PivotValue.formula festgelegt wurde.
|
NONE
|
Gibt an, dass der Wert bereits zusammengefasst ist und die Zusammenfassungsfunktion nicht explizit angegeben wurde. Wird für Pivot-Tabellen in Looker-Datenquellen verwendet, in 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
|
Werte werden horizontal angeordnet (als Spalten). |
VERTICAL
|
Die Werte werden vertikal angeordnet (als Zeilen). |