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 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.
Sowohl |
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 Status der Datenausführung für Datenquellen-Pivot-Tabellen. |
Union-Feld
source_data . Die Quelle der Pivot-Tabellendaten.
source_data darf nur einen der folgenden Werte haben:
|
|
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 (Zeile oder Spalte) in einer Pivot-Tabelle.
JSON-Darstellung |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
Felder | |
---|---|
showTotals
|
„Wahr“, wenn die Pivot-Tabelle die Gesamtwerte 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
|
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
|
„Wahr“, 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. Obwohl die dritte Zeile unten beispielsweise „Q1 März“ entspricht, wird „Q1“ nicht angezeigt, da sie mit den vorherigen Zeilen übereinstimmt. Wenn Sie „repeatHeadings“ auf „true“ 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 lautet das Zeilenlabel 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 darf nur einen der folgenden Werte haben:
|
|
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
|
„Wahr“, wenn die Daten, die dem Wert entsprechen, minimiert sind. |
PivotGroupSortValueBucket
Informationen dazu, welche Werte in einer Pivot-Gruppe für die Sortierung 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 des Gesamtwerts dieses Buckets. |
PivotGroupRule
Eine optionale Einstellung für eine PivotGroup
, mit der Buckets für die Werte in der Quelldatenspalte definiert werden, 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 die PivotGroup angewendet werden soll.
rule darf nur einen der folgenden Werte haben:
|
|
manualRule
|
Ein |
histogramRule
|
Ein |
dateTimeRule
|
Ein |
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 auch erzielt werden, indem Sie den Quelldaten eine Zeitzonenspalte hinzufügen und die Pivot-Tabelle anpassen.
+-----------+-------------------+
| 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 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 bestimmten |
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 können in einer bestimmten |
HistogramRule
Hiermit können Sie die numerischen Werte in einer Quelldatenspalte in Bins mit konstanter Größe organisieren. Alle Werte von HistogramRule.start
bis HistogramRule.end
werden in Gruppen mit der Größe HistogramRule.interval
eingeteilt. 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 erforderlich. Wenn jedoch sowohl HistogramRule.start
als auch HistogramRule.end
angegeben sind, muss HistogramRule.start
kleiner als HistogramRule.end
sein. Beispiel: Eine Pivot-Tabelle mit dem durchschnittlichen Kaufbetrag nach Alter mit mehr als 50 Zeilen:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
kann durch Anwenden einer Histogrammgruppenregel mit einer HistogramRule.start
von 25, einer HistogramRule.interval
von 20 und einer HistogramRule.end
von 65 in eine Pivot-Tabelle umgewandelt werden, die der folgenden ähnelt.
+-------------+-------------------+
| 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 mit konstanter Größe eingeordnet 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. Angenommen, Sie haben 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 der DateTimeRuleType
YEAR_MONTH anwenden, erhalten Sie 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 Datums-/Uhrzeitgruppierung. |
DateTimeRuleType
Die verfügbaren Typen von Gruppierungsregeln für Datum und Uhrzeit. In dieser Dokumentation wird davon ausgegangen, dass die Sprache der Tabelle „en-US“ ist. Für einige Regeltypen wird jedoch die Sprache der Tabelle für die tatsächliche Darstellung der Datumsangaben und Uhrzeiten verwendet.
Enums | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Der Standardtyp, darf nicht verwendet werden. |
SECOND
|
Datumsangaben nach Sekunden von 0 bis 59 gruppieren. |
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
|
Datumsangaben nach Wochentag gruppieren, z. B. Sonntag Die Wochentage werden basierend auf dem Gebietsschema der Tabelle übersetzt. |
DAY_OF_YEAR
|
Datumsangaben nach dem Tag des Jahres gruppieren, 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 Datumsangaben nach dem Tag des Monats (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 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 Zeilen- oder Spaltenanzahl in der Pivot-Gruppe.
JSON-Darstellung |
---|
{ "countLimit": integer, "applyOrder": integer } |
Felder | |
---|---|
countLimit
|
Die maximale Anzahl. |
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 müssen alle Grenzwerte für Pivot-Gruppen in diesem Feld mit einer eindeutigen Zahl festgelegt sein, damit die anwendbaren Reihenfolgen vollständig angepasst werden können. Andernfalls wird die Reihenfolge durch den Index in der Liste |
PivotFilterCriteria
Kriterien für das Ein-/Ausblenden von Zeilen in einer Pivot-Tabelle.
JSON-Darstellung |
---|
{
"visibleValues": [
string
],
"condition": {
object ( |
Felder | |
---|---|
visibleValues[]
|
Werte, die enthalten sein sollten. Nicht hier aufgeführte Werte 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 Blatt der Pivot-Tabelle ausgewertet. Verweise werden absolut behandelt und nicht in die gesamte Pivot-Tabelle kopiert. Beispiel: Ein Bedingungswert von
Auf die Quelldaten der Pivot-Tabelle kann über den Namen der Spaltenüberschrift 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 darf nur einen der folgenden Werte haben:
|
|
columnOffsetIndex
|
Der nullbasierte Spaltenoffset 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
|
Wenn diese Option angegeben ist, werden Pivot-Werte als Ergebnis einer Berechnung mit einem anderen Pivot-Wert angezeigt. Wenn Sie beispielsweise „PERCENT_OF_GRAND_TOTAL“ als „calculatedDisplayType“ angeben, werden alle Pivot-Werte als Prozentsatz des Gesamtwerts angezeigt. Im Editor von Google Tabellen wird dies im Wertbereich 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 darf nur einen der folgenden Werte haben:
|
|
sourceColumnOffset
|
Der Spaltenoffset des Quellbereichs, aus dem dieser Wert gelesen wird.
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 gelesen wird. |
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 wurde und die Zusammenfassungsfunktion nicht explizit angegeben ist. Wird für Pivot-Tabellen der Looker-Datenquelle verwendet, in denen der Wert bereits zusammengefasst ist. |
PivotValueCalculatedDisplayType
Die möglichen Berechnungsmethoden für Pivot-Werte.
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
|
Die Pivot-Werte werden als Prozentsatz der Werte der Spaltensumme angezeigt. |
PERCENT_OF_GRAND_TOTAL
|
Die Pivot-Werte werden als Prozentsatz der Werte der Gesamtsumme angezeigt. |
PivotValueLayout
Das Layout der Pivot-Werte.
Enums | |
---|---|
HORIZONTAL
|
Die Werte werden horizontal (als Spalten) angeordnet. |
VERTICAL
|
Die Werte werden vertikal (als Zeilen) angeordnet. |