Pivot Tables

PivotTable

Tabela przestawna.

Zapis JSON

{ "rows": [ { object (PivotGroup) } ], "columns": [ { object (PivotGroup) } ], "criteria": { integer: { object (PivotFilterCriteria) }, ... }, "filterSpecs": [ { object (PivotFilterSpec) } ], "values": [ { object (PivotValue) } ], "valueLayout": enum (PivotValueLayout), "dataExecutionStatus": { object (DataExecutionStatus) }, // Union field source_data can be only one of the following: "source": { object (GridRange) }, "dataSourceId": string // End of list of possible types for union field source_data. }

Pola
rows[]	object (PivotGroup) Każde grupowanie wierszy w tabeli przestawnej.
columns[]	object (PivotGroup) Każde grupowanie kolumn w tabeli przestawnej.
criteria (deprecated)	map (key: integer, value: object ( PivotFilterCriteria)) Ten produkt został wycofany. Opcjonalne mapowanie filtrów na przesunięcie kolumny źródłowej. Filtry są stosowane przed agregowaniem danych do tabeli przestawnej. Klucz mapy to przesunięcie kolumny zakresu źródłowego, który chcesz filtrować, a wartość to kryteria tej kolumny. Jeśli na przykład źródłem było C10:E15, klucz 0 będzie zawierać filtr dla kolumny C, a klucz 1 dotyczy kolumny D. To pole zostało wycofane i zastąpione filterSpecs
filterSpecs[]	object (PivotFilterSpec) Filtry zastosowane do kolumn źródłowych przed agregowaniem danych do tabeli przestawnej. Obie opcje criteria oraz filterSpecs są wypełniane w odpowiedziach. Jeśli w żądaniu aktualizacji określono oba pola, to pole ma pierwszeństwo.
values[]	object (PivotValue) Lista wartości do uwzględnienia w tabeli przestawnej.
valueLayout	enum (PivotValueLayout) Określa, czy wartości mają być wymienione poziomo (jako kolumny) czy pionowo (jako wiersze).
dataExecutionStatus	object (DataExecutionStatus) Tylko dane wyjściowe. Stan wykonania danych w tabelach przestawnych źródła danych.
Pole sumy source_data Źródło danych tabeli przestawnej. source_data może być tylko jednym z tych elementów:
source	object (GridRange) Zakres, z którego tabela przestawna odczytuje dane.
dataSourceId	string Identyfikator źródła danych, z którego tabela przestawna odczytuje dane.

PivotGroup

Pojedyncze grupowanie (wiersza lub kolumny) w tabeli przestawnej.

Zapis JSON

{ "showTotals": boolean, "valueMetadata": [ { object (PivotGroupValueMetadata) } ], "sortOrder": enum (SortOrder), "valueBucket": { object (PivotGroupSortValueBucket) }, "repeatHeadings": boolean, "label": string, "groupRule": { object (PivotGroupRule) }, "groupLimit": { object (PivotGroupLimit) }, // Union field source can be only one of the following: "sourceColumnOffset": integer, "dataSourceColumnReference": { object (DataSourceColumnReference) } // End of list of possible types for union field source. }

Pola
showTotals	boolean Wartość prawda, jeśli tabela przestawna powinna zawierać sumy dla tego grupowania.
valueMetadata[]	object (PivotGroupValueMetadata) Metadane dotyczące wartości w grupowaniu.
sortOrder	enum (SortOrder) Kolejność wartości w tej grupie powinna być sortowana.
valueBucket	object (PivotGroupSortValueBucket) Zasobnik przeciwnej grupy przestawnej, według którego ma być sortowana. Jeśli nie określono tej wartości, sortowanie jest sortowane alfabetycznie według wartości tej grupy.
repeatHeadings	boolean Wartość prawda, jeśli nagłówki w tej grupie przestawnej mają się powtarzać. Ta opcja ma zastosowanie tylko do grupowania wierszy i jest ignorowana w kolumnach. Domyślnie ograniczamy liczbę powtórzeń nagłówków, nie wyświetlając nagłówków wyższego poziomu w miejscach, w których są one takie same. Na przykład, mimo że trzeci wiersz poniżej odpowiada adresowi „I mar” lub „Q1” nie jest wyświetlany, ponieważ jest nadmiarowy w poprzednich wierszach. Ustawienie wartości trueHeadings na „true” spowoduje wyświetlenie „Q1” do powtórzenia dla "Lut" i „Mar”. +--------------+ | Q1 | Jan | | | Feb | | | Mar | +--------+-----+ | Q1 Total | +--------------+
label	string Etykiety dla grup wierszy/kolumn, które można dostosowywać. Na przykład w poniższej tabeli przestawnej etykieta wiersza to Region (który można zmienić na State), a etykieta kolumny to Product (który można zmienić Item). Tabele przestawne utworzone przed grudniem 2017 r. nie mają etykiet nagłówków. Jeśli chcesz dodać etykiety nagłówków do istniejącej tabeli przestawnej, usuń istniejącą tabelę przestawną, a następnie utwórz nową tabelę z tymi samymi parametrami. +--------------+---------+-------+ | SUM of Units | Product | | | Region | Pen | Paper | +--------------+---------+-------+ | New York | 345 | 98 | | Oregon | 234 | 123 | | Tennessee | 531 | 415 | +--------------+---------+-------+ | Grand Total | 1110 | 636 | +--------------+---------+-------+
groupRule	object (PivotGroupRule) Reguła grupy, która ma być stosowana do tej grupy wierszy lub kolumn.
groupLimit	object (PivotGroupLimit) Limit liczby wierszy lub kolumn do zastosowania do tej grupy elementów tabeli przestawnej.
Pole sumy source Źródło danych grupy tabeli przestawnej. source może być tylko jednym z tych elementów:
sourceColumnOffset	integer Przesunięcie kolumny zakresu źródłowego, na którym opiera się ta grupa. Jeśli na przykład źródłem było C10:E15, sourceColumnOffset z 0 oznacza, że ta grupa odwołuje się do kolumny C, a przesunięcie 1 będzie oznaczać kolumnę D.
dataSourceColumnReference	object (DataSourceColumnReference) Odwołanie do kolumny źródła danych, na której opiera się to grupowanie.

PivotGroupValueMetadata

Metadane dotyczące wartości w grupowaniu elementów tabeli przestawnej.

Zapis JSON
{ "value": { object (ExtendedValue) }, "collapsed": boolean }

Pola
value	object (ExtendedValue) Wartość obliczona, której dotyczą metadane. (Pamiętaj, że formulaValue jest nieprawidłowy, ponieważ wartości zostaną obliczone).
collapsed	boolean Prawda, jeśli dane powiązane z wartością są zwinięte.

PivotGroupSortValueBucket

Informacje o tym, które wartości w grupie przestawnej powinny być używane do sortowania.

Zapis JSON
{ "valuesIndex": integer, "buckets": [ { object (ExtendedValue) } ] }

Pola
valuesIndex	integer Przesunięcie w PivotTable.values według którego mają być sortowane wartości w tej grupie.
buckets[]	object (ExtendedValue) Określa zasobnik, z którego wybierane są wartości do sortowania. Na przykład w tabeli przestawnej z jedną grupą wierszy & dwóch grup kolumn, grupa wierszy może zawierać maksymalnie 2 wartości. Pierwsza wartość odpowiada wartości w pierwszej grupie kolumn, a druga wartość w drugiej grupie kolumn. Jeśli na liście nie ma żadnych wartości, oznacza to, że wiersz powinien zostać posortowany według „Suma całkowita” nad grupami kolumn. Jeśli podana jest tylko jedna wartość, odpowiada ona użyciu wartości „Łącznie”. tego zasobnika.

PivotGroupRule

Opcjonalne ustawienie PivotGroup który definiuje zasobniki dla wartości w kolumnie danych źródłowych, zamiast wydzielić poszczególne wartości. Tylko jedna PivotGroup z regułą grupy można dodać do każdej kolumny w danych źródłowych, lecz w każdej kolumnie możesz dodać zarówno PivotGroup z regułą i PivotGroup w ogóle nie działa.

Zapis JSON
{ // Union field rule can be only one of the following: "manualRule": { object (ManualRule) }, "histogramRule": { object (HistogramRule) }, "dateTimeRule": { object (DateTimeRule) } // End of list of possible types for union field rule. }

Pola
Pole sumy rule Reguła, która zostanie zastosowana do PivotGroup rule może być tylko jednym z tych elementów:
manualRule	object (ManualRule) O ManualRule
histogramRule	object (HistogramRule) O HistogramRule
dateTimeRule	object (DateTimeRule) O DateTimeRule

ManualRule

Umożliwia ręczne porządkowanie wartości w źródłowej kolumnie danych w zasobniki o wybranych przez siebie nazwach. Na przykład tabela przestawna, która agreguje populację według stanu:

+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK    |               0.7 |
| AL    |               4.8 |
| AR    |               2.9 |
...
+-------+-------------------+

można przekształcić w tabelę przestawną, która gromadzi populację według strefy czasowej przez udostępnienie listy grup (np. nazwagrupy = 'Central', elementy = ['AL', 'AR', 'IA' itd.') w ręcznej regule grupowej. Podobny efekt można uzyskać, dodając do danych źródłowych kolumnę strefy czasowej i dostosowując tabelę przestawną.

+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central   |             106.3 |
| Eastern   |             151.9 |
| Mountain  |              17.4 |
...
+-----------+-------------------+

Zapis JSON
{ "groups": [ { object (ManualRuleGroup) } ] }

Pola
groups[]	object (ManualRuleGroup) Lista nazw grup i odpowiadających im elementów z danych źródłowych, które są mapowane na każdą nazwę grupy.

ManualRuleGroup

Nazwa grupy i lista elementów z danych źródłowych, które powinny zostać umieszczone w grupie o tej nazwie.

Zapis JSON
{ "groupName": { object (ExtendedValue) }, "items": [ { object (ExtendedValue) } ] }

Pola
groupName	object (ExtendedValue) Nazwa grupy, która musi być ciągiem znaków. Każda grupa w danym ManualRule musi mieć unikalną nazwę grupy.
items[]	object (ExtendedValue) Pozycje w danych źródłowych, które powinny zostać umieszczone w tej grupie. Każdy element może być ciągiem znaków, liczbą lub wartością logiczną. Elementy mogą występować w maksymalnie jednej grupie w danej grupie ManualRule Elementy, które nie znajdują się w żadnej grupie, będą wyświetlane samodzielnie.

HistogramRule

Umożliwia uporządkowanie wartości liczbowych w kolumnie danych źródłowych w zasobnikach o stałym rozmiarze. Wszystkie wartości z HistogramRule.start do HistogramRule.end są umieszczane w grupach rozmiarów HistogramRule.interval Dodatkowo wszystkie poniższe wartości HistogramRule.start są umieszczone w jednej grupie, a wszystkie wartości powyżej HistogramRule.end w innym. Tylko HistogramRule.interval jest wymagane, jednak jeśli HistogramRule.start oraz HistogramRule.end i jedną z tych grup, HistogramRule.start musi być mniejsze niż HistogramRule.end. Na przykład tabela przestawna pokazująca średnią kwotę zakupu według grupy wiekowej ma ponad 50 wierszy:

+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16  |            $27.13 |
| 17  |             $5.24 |
| 18  |            $20.15 |
...
+-----+-------------------+

można przekształcić w tabelę przestawną podobną do przedstawionej poniżej, stosując regułę grupy histogramu HistogramRule.start równy 25, HistogramRule.interval i 20 oraz HistogramRule.end z 65.

+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25        |            $19.34 |
| 25-45       |            $31.43 |
| 45-65       |            $35.87 |
| > 65        |            $27.55 |
+-------------+-------------------+
| Grand Total |            $29.12 |
+-------------+-------------------+

Zapis JSON
{ "interval": number, "start": number, "end": number }

Pola
interval	number Rozmiar tworzonych zasobników. Musi być liczbą dodatnią.
start	number Minimalna wartość, z jaką elementy są umieszczane w segmentach o stałej wielkości. Wartości poniżej początku są umieszczone w jednym zasobniku. To pole jest opcjonalne.
end	number Maksymalna wartość, z jaką elementy są umieszczane w zasobnikach o stałej wielkości. Wartości znajdujące się powyżej końca są umieszczone w jednym zasobniku. To pole jest opcjonalne.

DateTimeRule

Umożliwia podział wartości daty i godziny w kolumnie danych źródłowych na segmenty na podstawie wybranych elementów daty lub godziny. Weźmy na przykład tabelę przestawną zawierającą transakcje sprzedaży według daty:

+----------+--------------+
| Date     | SUM of Sales |
+----------+--------------+
| 1/1/2017 |      $621.14 |
| 2/3/2017 |      $708.84 |
| 5/8/2017 |      $326.84 |
...
+----------+--------------+

Zastosowanie reguły grupy daty i godziny ze DateTimeRuleType z YEAR_MONTH daje następującą tabelę przestawną.

+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan     |   $53,731.78 |
| 2017-Feb     |   $83,475.32 |
| 2017-Mar     |   $94,385.05 |
...
+--------------+--------------+

Zapis JSON
{ "type": enum (DateTimeRuleType) }

Pola
type	enum (DateTimeRuleType) Typ stosowanego grupowania według daty i godziny.

DateTimeRuleType

Dostępne typy reguł grupowania według daty i godziny. W tej dokumentacji przyjęto, że język arkusza kalkulacyjnego to „en-US”, choć w przypadku niektórych typów reguł podczas renderowania dat i godzin są używane ustawienia regionalne arkusza kalkulacyjnego.

Wartości w polu enum
DATE_TIME_RULE_TYPE_UNSPECIFIED	Jest to typ domyślny – nie używaj.
SECOND	Grupuj daty według sekund (od 0 do 59).
MINUTE	Grupuj daty według minut (od 0 do 59).
HOUR	Pogrupuj daty według godziny przy użyciu systemu 24-godzinnego (od 0 do 23).
HOUR_MINUTE	Pogrupuj daty według godziny i minut w systemie 24-godzinnym, np. 19:45.
HOUR_MINUTE_AMPM	Daty pogrupuj według godziny i minuty w systemie 12-godzinnym, np. 19:45. Oznaczenie AM/PM jest tłumaczone na podstawie języka arkusza kalkulacyjnego.
DAY_OF_WEEK	Pogrupuj daty według dnia tygodnia, np. niedziela. Dni tygodnia zostaną przetłumaczone na podstawie ustawień regionalnych arkusza kalkulacyjnego.
DAY_OF_YEAR	Grupuj daty według dnia roku, od 1 do 366. Pamiętaj, że daty po 29 lutego trafiają do innych grup w latach przestępnych niż w latach bez przestępnych.
DAY_OF_MONTH	Grupuj daty według dnia miesiąca, od 1 do 31.
DAY_MONTH	Pogrupuj daty według dnia i miesiąca, np. 22-listopad. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego.
MONTH	Pogrupuj daty według miesiąca, na przykład listopad. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego.
QUARTER	Pogrupuj daty według kwartałów, np. Q1 (kwartał styczeń–Mar).
YEAR	Pogrupuj daty według roku, np. 2008.
YEAR_MONTH	Możesz grupować daty według roku i miesiąca, np. 2008–listopad. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego.
YEAR_QUARTER	Pogrupować daty według roku i kwartału, np. IV kwartał 2008 r.
YEAR_MONTH_DAY	Możesz pogrupować daty według roku, miesiąca i dnia, np. 2008-11-22.

PivotGroupLimit

Limit liczby wierszy lub kolumn w grupie przestawnej.

Zapis JSON
{ "countLimit": integer, "applyOrder": integer }

Pola
countLimit	integer Limit liczby żądań.
applyOrder	integer Kolejność, w jakiej limit grup jest stosowany do tabeli przestawnej. Limity grup przestawnych są stosowane od najniższego do wyższego numeru kolejności. Numery zamówień są normalizowane do kolejnych liczb całkowitych od 0. Aby w pełni dostosować stosowane zamówienia, w przypadku żądania zapisu wszystkie limity grup elementów tabeli przestawnej powinny mieć to pole z unikalną liczbą. W przeciwnym razie kolejność jest określana przez indeks w sekcji PivotTable.rows , a następnie PivotTable.columns z listy.

PivotFilterCriteria

Kryteria wyświetlania/ukrywania wierszy w tabeli przestawnej.

Zapis JSON
{ "visibleValues": [ string ], "condition": { object (BooleanCondition) }, "visibleByDefault": boolean }

Pola
visibleValues[]	string Wartości, które powinny być uwzględnione. Wartości, które nie są tu wymienione, są wykluczone.
condition	object (BooleanCondition) Warunek, który musi być spełniony, aby wyświetlały się wartości. ( visibleValues nie zastępuje tego – nawet jeśli jakaś wartość jest tam wymieniona, to i tak jest ukryta, jeśli nie spełnia warunku). Wartości warunku, które odnoszą się do zakresów w notacji A1, są oceniane względem arkusza tabeli przestawnej. Odwołania są traktowane bezwzględnie, więc nie są wypełniane w tabeli przestawnej. Na przykład wartość warunku =A1 w tabeli przestawnej 1 jest traktowany jako 'Pivot Table 1'!$A$1 Do danych źródłowych tabeli przestawnej można się odwoływać za pomocą nazwy nagłówka kolumny. Jeśli np. dane źródłowe zawierają kolumny o nazwie „Przychody” i „Koszt” i zostanie zastosowany warunek w kolumnie „Przychody”, kolumna z typem NUMBER_GREATER i wartości =Cost i tylko kolumny, w których „Przychody” > „Koszt” .
visibleByDefault	boolean Określa, czy wartości są domyślnie widoczne. Jeśli ma wartość prawda, parametr visibleValues są ignorowane, wszystkie wartości spełniające condition (jeśli zostały określone). Jeśli fałsz, obie wartości są zawarte w visibleValues i spotkać condition są wyświetlane.

PivotFilterSpec

Kryteria filtrowania tabeli przestawnej powiązane z przesunięciem określonej kolumny źródłowej.

Zapis JSON
{ "filterCriteria": { object (PivotFilterCriteria) }, // Union field source can be only one of the following: "columnOffsetIndex": integer, "dataSourceColumnReference": { object (DataSourceColumnReference) } // End of list of possible types for union field source. }

Pola
filterCriteria	object (PivotFilterCriteria) Kryteria kolumny.
Pole sumy source Kolumna źródłowa, do której ma zastosowanie dany filtr. source może być tylko jednym z tych elementów:
columnOffsetIndex	integer Od zera przesunięcie kolumny zakresu źródłowego.
dataSourceColumnReference	object (DataSourceColumnReference) Odwołanie do kolumny źródła danych.

PivotValue

Definicja sposobu obliczania wartości w tabeli przestawnej.

Zapis JSON
{ "summarizeFunction": enum (PivotValueSummarizeFunction), "name": string, "calculatedDisplayType": enum (PivotValueCalculatedDisplayType), // Union field value can be only one of the following: "sourceColumnOffset": integer, "formula": string, "dataSourceColumnReference": { object (DataSourceColumnReference) } // End of list of possible types for union field value. }

Pola
summarizeFunction	enum (PivotValueSummarizeFunction) Funkcja służąca do podsumowania wartości. Jeśli formula , jedyne obsługiwane wartości to SUM oraz CUSTOM Jeśli sourceColumnOffset jest ustawiona, a następnie CUSTOM nie jest obsługiwany.
name	string Nazwa, która ma być używana w przypadku wartości.
calculatedDisplayType	enum (PivotValueCalculatedDisplayType) Jeśli określono tę wartość, wskazuje, że wartości w tabeli przestawnej powinny być wyświetlane jako wynik obliczeń z inną wartością przestawnej. Jeśli na przykład obliczony typ DisplayType jest określony jako PERCENT_OF_GRAND_TOTAL, wszystkie wartości w tabeli przestawnej są wyświetlane jako odsetek całkowitej sumy. W edytorze Arkuszy ta opcja jest wyświetlana jako „Pokaż jako”. w sekcji wartości tabeli przestawnej.
Pole sumy value Dane, które mają być używane w przypadku wartości w tabeli przestawnej. Musisz ustawić dokładnie jedną wartość. value może być tylko jednym z tych elementów:
sourceColumnOffset	integer Przesunięcie kolumny zakresu źródłowego, z którego odczytuje ta wartość. Jeśli na przykład źródłem było C10:E15, sourceColumnOffset z 0 oznacza, że ta wartość odnosi się do kolumny C, a przesunięcie 1 będzie odnosić się do kolumny D.
formula	string Własna formuła do obliczania wartości. Formuła musi zaczynać się od = znaku.
dataSourceColumnReference	object (DataSourceColumnReference) Odwołanie do kolumny źródła danych, z której odczytuje ta wartość.

PivotValueSummarizeFunction

Funkcja do podsumowania wartości w tabeli przestawnej.

Wartości w polu enum
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED	Ustawienie domyślne – nie używaj.
SUM	Odpowiada SUM .
COUNTA	Odpowiada COUNTA .
COUNT	Odpowiada COUNT .
COUNTUNIQUE	Odpowiada COUNTUNIQUE .
AVERAGE	Odpowiada AVERAGE .
MAX	Odpowiada MAX .
MIN	Odpowiada MIN .
MEDIAN	Odpowiada MEDIAN .
PRODUCT	Odpowiada PRODUCT .
STDEV	Odpowiada STDEV .
STDEVP	Odpowiada STDEVP .
VAR	Odpowiada VAR .
VARP	Odpowiada VARP .
CUSTOM	Wskazuje, że należy używać formuły w niezmienionej formie. Prawidłowy tylko wtedy, gdy PivotValue.formula została ustawiona.
NONE	Wskazuje, że wartość została już podsumowana, a funkcja podsumowania nie jest jawnie określona. Używana w przypadku tabel przestawnych źródła danych Lookera, w których wartość jest już podsumowana.

PivotValueCalculatedDisplayType

Możliwe sposoby obliczania wartości przestawnych na potrzeby wyświetlania

Wartości w polu enum
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED	Wartość domyślna, nie używaj.
PERCENT_OF_ROW_TOTAL	Pokazuje wartości w tabeli przestawnej jako procent łącznej wartości wierszy.
PERCENT_OF_COLUMN_TOTAL	Pokazuje wartości w tabeli przestawnej jako procent łącznej wartości w kolumnie.
PERCENT_OF_GRAND_TOTAL	Pokazuje wartości w tabeli przestawnej jako odsetek łącznych wartości.

PivotValueLayout

Układ wartości przestawnych.

Wartości w polu enum
HORIZONTAL	Wartości są układane w poziomie (w postaci kolumn).
VERTICAL	Wartości są ułożone w pionie (jako wiersze).