Pivot-Tabelle
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 Offset der Quellspalte. Die Filter werden angewendet, bevor Daten in der Pivot-Tabelle zusammengefasst werden. Der Schlüssel der Karte 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[]
|
Filter, die auf die Quellspalten angewendet wurden, bevor Daten für die Pivot-Tabelle zusammengefasst werden
Sowohl |
values[]
|
Eine Liste der Werte, die in die Pivot-Tabelle aufgenommen werden sollen. |
valueLayout
|
Gibt an, ob Werte horizontal (als Spalten) oder vertikal (als Zeilen) aufgeführt 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 einer der folgenden Werte sein:
|
|
source
|
Der Bereich, aus dem die Pivot-Tabelle Daten liest. |
dataSourceId
|
Die ID der Datenquelle, aus der die Pivot-Tabelle Daten liest. |
Pivot-Gruppe
Eine einzelne Gruppierung (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 sollte. |
valueMetadata[]
|
Metadaten zu Werten in der Gruppierung. |
sortOrder
|
Die Reihenfolge, in der die Werte in dieser Gruppe sortiert werden sollen |
valueBucket
|
Bucket der entgegengesetzten Pivot-Gruppe, nach der sortiert werden soll. Wenn keine Angabe erfolgt, wird alphabetisch nach den Werten dieser Gruppe sortiert. |
repeatHeadings
|
Dieser Wert ist „true“, wenn die Überschriften in dieser Pivot-Gruppe wiederholt werden sollen. Dies ist nur für Zeilengruppierungen gültig und wird von Spalten ignoriert. Standardmäßig wird eine Wiederholung von Überschriften minimiert, indem nicht dieselben Überschriften derselben Ebene angezeigt werden. Obwohl die dritte Zeile unten beispielsweise „Q1 Mar“ entspricht, wird „Q1“ nicht angezeigt, da sie in vorherigen Zeilen redundant ist. Wenn Sie wiederholte Überschriften auf "true" setzen, wird "Q1" für "Feb" und "Mär" wiederholt.
|
label
|
Die Labels, die für die Zeilen-/Spaltengruppen verwendet werden sollen. 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 sollen. |
Union-Feld source . Die Datenquelle der Pivot-Gruppe.
source darf 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-Gruppe
JSON-Darstellung |
---|
{
"value": {
object (
|
Felder | |
---|---|
value
|
Der berechnete Wert, zu dem die Metadaten gehören. |
collapsed
|
True, wenn die Daten, die dem Wert entsprechen, minimiert werden. |
PivotGroupSortValueBucket
Informationen darüber, 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 |
buckets[]
|
Legt den Bucket fest, aus dem Werte sortiert werden. Beispielsweise kann eine Zeilengruppe in einer Pivot-Tabelle mit einer Zeilengruppe und zwei Spaltengruppen bis zu zwei Werte enthalten. Der erste Wert entspricht einem Wert in der ersten Spaltengruppe, der zweite einem Wert in der zweiten Spaltengruppe. Wenn keine Werte angegeben sind, weist dies darauf hin, dass die Zeile nach „Gesamtsumme“ über den Spaltengruppen sortiert werden soll. Wenn ein einzelner Wert aufgeführt ist, entspricht dies der „Gesamtsumme“ dieses Buckets. |
PivotGroup-Regel
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 darf nur eine PivotGroup
mit einer Gruppenregel hinzugefügt werden. In jeder Spalte können Sie jedoch sowohl eine PivotGroup
mit einer Regel als auch eine PivotGroup
hinzufügen, bei der dies nicht der Fall ist.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld rule . Die Regel, die auf PivotGroup angewendet werden soll.
rule darf nur einer der folgenden Werte sein:
|
|
manualRule
|
Ein |
histogramRule
|
Ein |
dateTimeRule
|
Ein |
Manuelle Regel
Sie können die Werte in einer Quelldatenspalte manuell in Buckets mit Namen Ihrer Wahl organisieren. Beispiel für 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 |
...
+-------+-------------------+
können Sie in eine Pivot-Tabelle umwandeln, in der die Bevölkerung nach Zeitzone zusammengefasst wird. Dazu stellen Sie einer manuellen Gruppenregel eine Liste von Gruppen bereit (z. B. groupName = 'Central', items = ['AL', 'AR', 'IA', ...]). Einen ähnlichen Effekt erzielen Sie, wenn Sie den Quelldaten eine Zeitzone 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 zugehörigen Elemente aus den Quelldaten, die jedem Gruppennamen zugeordnet sind. |
Manuelle Regelgruppe
Ein Gruppenname und eine Liste von Elementen aus den Quelldaten, die in der Gruppe mit diesem Namen platziert 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 höchstens einer Gruppe innerhalb einer bestimmten |
Histogrammregel
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
werden in Gruppen der Größe HistogramRule.interval
platziert. Darüber hinaus werden alle Werte unter HistogramRule.start
in eine Gruppe gelegt und alle Werte über HistogramRule.end
in eine andere. 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 für 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 |
...
+-----+-------------------+
können Sie in eine Pivot-Tabelle umwandeln, die in etwa so 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 Minimalwert, mit dem Elemente in Buckets mit konstanter Größe platziert werden. Werte unter dem Start werden in einem einzigen Bucket zusammengefasst. Dieses Feld ist optional. |
end
|
Der maximale Wert, bei dem Elemente in Buckets mit konstanter Größe platziert werden. Werte über dem Ende werden in einem einzigen Bucket zusammengefasst. Dieses Feld ist optional. |
Datum/Uhrzeit-Regel
Damit können Sie die Datum/Uhrzeit-Werte in einer Quelldatenspalte basierend auf ausgewählten Teilen ihrer Datums- oder Zeitwerte in Buckets organisieren. Ein Beispiel wäre 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 |
...
+----------+--------------+
Die Anwendung einer Datum/Uhrzeit-Gruppenregel mit einem DateTimeRuleType
von YEAR_MONTH führt zu der folgenden 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 Gruppierung von Datum und Uhrzeit, die angewendet werden soll. |
Datum/UhrzeitRegeltyp
Die verfügbaren Arten von Regeln für die Datum/Uhrzeit-Gruppierung. In dieser Dokumentation wird davon ausgegangen, dass das Gebietsschema in der Tabelle „en-US“ lautet. Das tatsächliche Rendering von Datum und Uhrzeit verwendet für einige Regeltypen jedoch das Gebietsschema der Tabelle.
Enums | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Der Standardtyp, nicht verwenden. |
SECOND
|
Gruppieren Sie Datumsangaben nach Sekunden, von 0 bis 59. |
MINUTE
|
Gruppiert Datumsangaben nach Minute, von 0 bis 59. |
HOUR
|
Gruppieren Sie Datumsangaben nach einem 24-Stunden-System von 0 bis 23. |
HOUR_MINUTE
|
Gruppieren Sie Datumsangaben mithilfe eines 24-Stunden-Systems nach Stunde und Minute, z. B. 19:45. |
HOUR_MINUTE_AMPM
|
Gruppieren Sie die Daten in einem 12-Stunden-System, z. B. 19:45 Uhr. Die AM/PM-Kennzeichnung wird basierend auf dem Gebietsschema der Tabelle übersetzt. |
DAY_OF_WEEK
|
Gruppieren Sie Termine nach Wochentag, z. B. Sonntag. Die Wochentage werden basierend auf dem Gebietsschema der Tabelle übersetzt. |
DAY_OF_YEAR
|
Gruppieren Sie die Daten nach Tag des Jahres, von 1 bis 366. Daten nach dem 29. Februar liegen in unterschiedlichen Buckets in Schaltjahren und nicht in Schaltjahren. |
DAY_OF_MONTH
|
Gruppiert die Datumsangaben nach Tag, von 1 bis 31. |
DAY_MONTH
|
Gruppieren Sie Datumsangaben nach Tag und Monat, z. B. 22-Nov. Der Monat wird je nach Tabellensprache übersetzt. |
MONTH
|
Gruppiert die Datumsangaben nach Monat, z. B. Nov. Der Monat wird basierend auf der Sprache der Tabelle übersetzt. |
QUARTER
|
Gruppieren Sie Datumsangaben nach Quartal, z. B. Q1 (Januar bis März). |
YEAR
|
Gruppiert die Datumsangaben nach Jahr, z. B. 2008. |
YEAR_MONTH
|
Gruppiert die Datumsangaben nach Jahr und Monat, z. B. 2008-Nov. Der Monat wird je nach Sprache der Tabelle übersetzt. |
YEAR_QUARTER
|
Gruppieren Sie Termine nach Jahr und Quartal, z. B. 2008 Q4. |
YEAR_MONTH_DAY
|
Gruppieren Sie Datumsangaben nach Jahr, Monat und Tag, z. B. 2018-11-22. |
PivotGroupLimit
Das Limit für Zeilen oder Spalten in der Pivot-Gruppe.
JSON-Darstellung |
---|
{ "countLimit": integer, "applyOrder": integer } |
Felder | |
---|---|
countLimit
|
Das Limit. |
applyOrder
|
Die Reihenfolge, in der das Gruppenlimit auf die Pivot-Tabelle angewendet wird. Beschränkungen für Pivot-Gruppen werden von einer niedrigeren auf eine höhere Bestellnummer angewendet. Bestellnummern werden normalisiert und aufeinanderfolgende Ganzzahlen von 0 normalisiert.
Wenn Sie für eine Schreibanfrage die angewendeten Aufträge vollständig anpassen möchten, sollte für alle Pivot-Gruppenlimits dieses Feld mit einer eindeutigen Zahl festgelegt werden. Andernfalls wird die Reihenfolge durch den Index in der Liste |
PivotFilterCriteria
Kriterien zum Ein- und Ausblenden von Zeilen in einer Pivot-Tabelle
JSON-Darstellung |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
Felder | |
---|---|
visibleValues[]
|
Werte, die enthalten sein müssen Werte, die hier nicht aufgelistet 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, werden also nicht in der Pivot-Tabelle ausgefüllt. Beispielsweise wird der Bedingungswert
Auf die Quelldaten der Pivot-Tabelle kann durch den Namen der Spaltenüberschrift verwiesen werden. Wenn die Quelldaten beispielsweise Spalten mit den Namen „Umsatz“ und „Kosten“ haben und eine Bedingung auf die Spalte „Umsatz“ mit dem Typ |
visibleByDefault
|
Gibt an, ob Werte standardmäßig sichtbar sind. Bei "true" werden die |
PivotFilterSpec
Die Filterkriterien für die Pivot-Tabelle, die mit einem bestimmten Quellspaltenversatz 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 einer der folgenden Werte sein:
|
|
columnOffsetIndex
|
Der nullbasierte Spaltenversatz des Quellbereichs. |
dataSourceColumnReference
|
Verweis auf die Datenquellenspalte. |
Pivot-Wert
Die Definition, wie ein Wert in einer Pivot-Tabelle berechnet werden soll.
JSON-Darstellung |
---|
{ "summarizeFunction": enum ( |
Felder | |
---|---|
summarizeFunction
|
Eine Funktion zur Zusammenfassung des Werts. Wenn |
name
|
Ein Name, der für den Wert verwendet werden soll. |
calculatedDisplayType
|
Gibt an, dass Pivot-Tabellenwerte als Ergebnis einer Berechnung mit einem anderen Pivot-Wert angezeigt werden. Wenn für „computeDisplayType“ beispielsweise PERCENT_OF_GRAND_TOTAL angegeben ist, werden alle Pivot-Tabellen als Prozentsatz der Gesamtsumme angezeigt. Im Tabelleneditor wird das im Abschnitt „Wert“ einer Pivot-Tabelle 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.
value darf 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 dem Zeichen |
dataSourceColumnReference
|
Der Verweis auf die Datenquellenspalte, aus der dieser Wert liest. |
Funktion PivotValueSummarizeFunction
Eine Funktion zum Zusammenfassung eines Pivot-Tabellenwerts.
Enums | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
Standardmäßig 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 angewendet werden soll. Nur gültig, wenn PivotValue.formula festgelegt wurde.
|
PivotValueComputedDisplayType
Die möglichen Methoden zum Berechnen von Pivot-Tabellenwerten für die Anzeige.
Enums | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
Standardwert, nicht verwenden. |
PERCENT_OF_ROW_TOTAL
|
Zeigt die Pivot-Tabellenwerte als Prozentsatz der Gesamtwerte der Zeile an. |
PERCENT_OF_COLUMN_TOTAL
|
Zeigt die Pivot-Tabellenwerte als Prozentsatz der Gesamtwerte der Spalte an. |
PERCENT_OF_GRAND_TOTAL
|
Zeigt die Pivot-Tabellenwerte als Prozentsatz der Gesamtsummenwerte an. |
Pivot-Wert-Layout
Das Layout von Pivot-Tabellenwerten.
Enums | |
---|---|
HORIZONTAL
|
Die Werte sind horizontal angeordnet (als Spalten). |
VERTICAL
|
Werte sind vertikal angeordnet (als Zeilen). |