PivotTable
Tabela przestawna.
Zapis JSON |
---|
{ "rows": [ { object ( |
Pola | |
---|---|
rows[]
|
Każde grupowanie wierszy w tabeli przestawnej. |
columns[]
|
Każde grupowanie kolumn w tabeli przestawnej. |
criteria
|
Opcjonalne mapowanie filtrów na przesunięcie kolumny źródłowej. Filtry są stosowane przed zagregowaniem danych w tabeli przestawnej. Klucz mapy to przesunięcie kolumny względem zakresu źródłowego, który chcesz filtrować, a wartość jest kryterium tej kolumny.
Jeśli np. źródłem jest
To pole zostało wycofane i zastąpione polem |
filterSpecs[]
|
Filtry zastosowane do kolumn źródłowych przed agregacją danych na potrzeby tabeli przestawnej.
W odpowiedziach podawane są wartości |
values[]
|
Lista wartości do uwzględnienia w tabeli przestawnej. |
valueLayout
|
Określa, czy wartości mają być wymienione poziomo (jako kolumny) czy pionowo (jako wiersze). |
dataExecutionStatus
|
Tylko dane wyjściowe. Stan wykonywania danych w tabelach przestawnych źródła danych. |
Pole sumy source_data . Źródło danych tabeli przestawnej.
source_data może mieć tylko jedną z tych wartości:
|
|
source
|
Zakres, z którego tabela przestawna odczytuje dane. |
dataSourceId
|
Identyfikator źródła danych, z którego tabela przestawna odczytuje dane. |
PivotGroup
Pojedyncze grupowanie (wiersz lub kolumna) w tabeli przestawnej.
Zapis JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
Pola | |
---|---|
showTotals
|
Prawda, jeśli tabela przestawna powinna zawierać sumy dla tej grupy. |
valueMetadata[]
|
Metadane dotyczące wartości w grupie. |
sortOrder
|
Wartości w tej grupie powinny być sortowane w kolejności. |
valueBucket
|
Segment przeciwnej grupy przestawnej, według którego chcesz posortować. Jeśli go nie podasz, zostanie przeprowadzone sortowanie alfabetyczne według wartości tej grupy. |
repeatHeadings
|
Wartość to prawda, jeśli nagłówki w tej grupie przestawnej mają się powtarzać. Ta metoda działa tylko w przypadku grupowań wierszy i jest ignorowana przez kolumny. Domyślnie minimalizujemy powtarzanie nagłówków, nie wyświetlając nagłówków wyższych poziomu w miejscach, w których są takie same. Na przykład trzeci wiersz poniżej odpowiada nazwie „I kw. mar.”, ale wiersz „Q1” nie jest widoczny, ponieważ jest zbędny w porównaniu z poprzednimi wierszami. Jeśli zasada „RepeatHeadings” ma wartość „true” (prawda), pole „Q1” (Q1) jest powtarzane w polach „Luty” i „Mar”.
|
label
|
Etykiety używane na potrzeby grup wierszy i kolumn, które można dostosować. Na przykład w poniższej tabeli przestawnej etykieta wiersza to
|
groupRule
|
Reguła grupy, która ma być stosowana do tej grupy wierszy lub kolumn. |
groupLimit
|
Limit liczby wierszy lub kolumn, które mają być zastosowane do tej grupy przestawnej. |
Pole sumy source . Źródło danych grupy przestawnej.
source może mieć tylko jedną z tych wartości:
|
|
sourceColumnOffset
|
Przesunięcie kolumny z zakresu źródłowego, na którym oparte jest to grupowanie.
Jeśli np. źródłem jest |
dataSourceColumnReference
|
Odniesienie do kolumny źródła danych, na podstawie której działa to grupowanie. |
PivotGroupValueMetadata
Metadane dotyczące wartości w grupowaniu przestawnym.
Zapis JSON |
---|
{
"value": {
object (
|
Pola | |
---|---|
value
|
Obliczona wartość, której odpowiadają metadane. (Funkcja |
collapsed
|
Prawda, jeśli dane odpowiadające wartości są zwinięte. |
PivotGroupSortValueBucket
Informacje o tym, które wartości w grupie przestawnej mają być używane do sortowania.
Zapis JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object (
|
Pola | |
---|---|
valuesIndex
|
Przesunięcie na liście |
buckets[]
|
Określa zasobnik, z którego wartości są wybierane do sortowania. Na przykład w tabeli przestawnej z 1 grupą wierszy i 2 grupami 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 zgodnie z „Sumą całkowitą” nad grupami kolumn. Jeśli na liście znajduje się 1 wartość, odpowiada to wartości „Łącznie” tego zasobnika. |
PivotGroupRule
Opcjonalne ustawienie PivotGroup
, które definiuje zasobniki wartości w kolumnie danych źródłowych zamiast rozdzielać poszczególne wartości. Do każdej kolumny w danych źródłowych można dodać tylko 1 PivotGroup
z regułą grupy. W każdej kolumnie możesz dodać zarówno PivotGroup
, który ma regułę, jak i PivotGroup
, która nie ma takiej reguły.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy rule . Reguła, która zostanie zastosowana do: PivotGroup .
rule może mieć tylko jedną z tych wartości:
|
|
manualRule
|
|
histogramRule
|
|
dateTimeRule
|
|
ManualRule
Umożliwia ręczne organizowanie wartości w kolumnie danych źródłowych w zasobnikach o wybranych przez Ciebie nazwach. Na przykład tabela przestawna agregująca 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 agreguje populację według strefy czasowej. W tym celu musi dostarczyć listę grup (na przykład groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) do ręcznej reguły grupowej. Podobny efekt można osiągnąć, 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 (
|
Pola | |
---|---|
groups[]
|
Lista nazw grup i odpowiadających im elementów z danych źródłowych zmapowanych na nazwy poszczególnych grup. |
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 ( |
Pola | |
---|---|
groupName
|
Nazwa grupy, która musi być ciągiem znaków. Każda grupa w danym elemencie |
items[]
|
Elementy 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ć tylko w 1 grupie w ramach danego elementu |
HistogramRule
Umożliwia porządkowanie wartości liczbowych w kolumnie danych źródłowych w zasobnikach o stałej wielkości. Wszystkie wartości z zakresu od HistogramRule.start
do HistogramRule.end
są umieszczane w grupach o rozmiarze HistogramRule.interval
. Dodatkowo wszystkie wartości poniżej HistogramRule.start
są umieszczane w jednej grupie, a wszystkie wartości powyżej HistogramRule.end
– w innej. Wymagana jest tylko wartość HistogramRule.interval
. Jeśli jednak podana jest zarówno wartość HistogramRule.start
, jak i HistogramRule.end
, wartość HistogramRule.start
musi być mniejsza niż HistogramRule.end
. Na przykład tabela przestawna pokazująca średnią kwotę zakupu według wieku, która 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łę grupowania histogramu z HistogramRule.start
wartościami HistogramRule.start
, HistogramRule.interval
o wartości 20 i HistogramRule.end
o wartości 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
|
Rozmiar tworzonych zasobników. Musi być liczbą dodatnią. |
start
|
Minimalna wartość, przy której elementy są umieszczane w zasobnikach o stałym rozmiarze. Wartości widoczne poniżej trafiają do jednej grupy. To pole jest opcjonalne. |
end
|
Maksymalna wartość, przy której elementy są umieszczane w zasobnikach o stałym rozmiarze. Wartości powyżej końca są umieszczane w jednym zbiorze. To pole jest opcjonalne. |
DateTimeRule
Pozwala uporządkować wartości daty i godziny w kolumnie danych źródłowych w zasobnikach na podstawie wybranych fragmentów ich wartości daty lub godziny. Przeanalizujmy 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 grupowania według daty i godziny z parametrem DateTimeRuleType
o wartości YEAR_MONTH powoduje wyświetlenie poniższej tabeli przestawnej.
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
Zapis JSON |
---|
{
"type": enum (
|
Pola | |
---|---|
type
|
Typ grupowania daty i godziny, który ma zostać zastosowany. |
DateTimeRuleType
Dostępne typy reguł grupowania według daty i godziny. W tej dokumentacji zakładamy, że język arkusza kalkulacyjnego to „en-US”, chociaż w przypadku niektórych typów reguł do renderowania dat i godzin używane są ustawienia regionalne arkusza kalkulacyjnego.
Wartości w polu enum | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
Domyślny typ, nie używać. |
SECOND
|
Grupuj daty według sekund (od 0 do 59). |
MINUTE
|
Grupuj daty według minut od 0 do 59. |
HOUR
|
Grupuj daty według godzin w systemie 24-godzinnym z zakresu od 0 do 23. |
HOUR_MINUTE
|
Grupuj daty według godzin i minut w systemie 24-godzinnym, np. 19:45. |
HOUR_MINUTE_AMPM
|
Grupuj daty według godzin i minut za pomocą systemu 12-godzinnego, np. 19:45. Oznaczenie AM/PM jest tłumaczone na podstawie ustawień regionalnych arkusza kalkulacyjnego. |
DAY_OF_WEEK
|
Grupuj daty według dnia tygodnia, np. niedzieli. Dni tygodnia będą tłumaczone na podstawie ustawień regionalnych arkusza kalkulacyjnego. |
DAY_OF_YEAR
|
Grupuj daty według dnia roku, od 1 do 366. Pamiętaj, że w latach przestępnych daty po 29 lutego przypadają w innych przedziałach niż w latach przestępnych. |
DAY_OF_MONTH
|
Grupuj daty według dnia miesiąca (od 1 do 31). |
DAY_MONTH
|
Grupuj daty według dnia i miesiąca, na przykład 22-listopad. Miesiąc jest przetłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego. |
MONTH
|
Grupuj daty według miesięcy, na przykład listopad. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego. |
QUARTER
|
Grupuj daty według kwartałów, na przykład I kwartał (który reprezentuje styczeń–marzec). |
YEAR
|
Grupuj daty według roku, np. 2008. |
YEAR_MONTH
|
Grupuj daty według roku i miesiąca, np. 2008–listopad. Miesiąc jest przetłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego. |
YEAR_QUARTER
|
Grupuj daty według roku i kwartału, na przykład IV kw. 2008. |
YEAR_MONTH_DAY
|
Grupuj 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
|
Limit liczby. |
applyOrder
|
Kolejność, w jakiej limit grup jest stosowany do tabeli przestawnej. Limity grup przestawnych są stosowane w kolejności od niższego do najwyższego numeru. Numery zamówień są normalizowane do kolejnych liczb całkowitych od 0.
Aby w przypadku żądania zapisu w pełni dostosować obowiązujące zamówienia, we wszystkich limitach grup przestawnych należy ustawić unikalną liczbę dla tego pola. W przeciwnym razie kolejność jest określana przez indeks na liście |
PivotFilterCriteria
Kryteria wyświetlania/ukrywania wierszy w tabeli przestawnej.
Zapis JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
Pola | |
---|---|
visibleValues[]
|
Wartości, które należy podać. Wartości niewymienione w tym miejscu są wykluczone. |
condition
|
Warunek, który musi zostać spełniony, aby wartości zostały wyświetlone. (
Wartości warunków odwołujące się do zakresów w notacji A1 są oceniane względem arkusza tabeli przestawnej. Odwołania są traktowane bezwzględnie, więc tabela przestawna nie jest wypełniana. Na przykład wartość warunku
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”, a w kolumnie „Przychody” o typie |
visibleByDefault
|
Określa, czy wartości są domyślnie widoczne. Jeśli wartość to prawda, pola |
PivotFilterSpec
Kryteria filtrowania tabeli przestawnej powiązane z określonym przesunięciem kolumny źródłowej.
Zapis JSON |
---|
{ "filterCriteria": { object ( |
Pola | |
---|---|
filterCriteria
|
Kryteria kolumny. |
Pole sumy source . Kolumna źródłowa, do której ma zastosowanie ten filtr.
source może mieć tylko jedną z tych wartości:
|
|
columnOffsetIndex
|
Odsunięcie kolumny zakresu źródłowego od zera. |
dataSourceColumnReference
|
Odwołanie do kolumny źródła danych. |
PivotValue
Definicja sposobu obliczania wartości w tabeli przestawnej.
Zapis JSON |
---|
{ "summarizeFunction": enum ( |
Pola | |
---|---|
summarizeFunction
|
Funkcja podsumowująca wartość. Jeśli ustawiona jest właściwość |
name
|
Nazwa, która ma być używana dla wartości. |
calculatedDisplayType
|
Jeśli zostanie podany, wskazuje, że wartości w tabeli przestawnej powinny być wyświetlane jako wynik obliczeń z inną wartością w tabeli przestawnej. Jeśli na przykład wartość obliczonaDisplayType jest określona jako PERCENT_OF_GRAND_TOTAL, wszystkie wartości w tabeli przestawnej są wyświetlane jako procent sumy całkowitej. W edytorze Arkuszy w sekcji wartości tabeli przestawnej jest to oznaczone jako „Pokaż jako”. |
Pole sumy value . Dane do użycia dla wartości w tabeli przestawnej. Musisz ustawić dokładnie jedną wartość.
value może mieć tylko jedną z tych wartości:
|
|
sourceColumnOffset
|
Przesunięcie kolumny zakresu źródłowego, z którego odczytuje tę wartość.
Jeśli np. źródłem jest |
formula
|
Niestandardowa formuła do obliczania wartości. Formuła musi zaczynać się od znaku |
dataSourceColumnReference
|
Odwołanie do kolumny źródła danych, z której odczytuje tę wartość. |
PivotValueSummarizeFunction
Funkcja podsumowująca wartość przestawną.
Wartości w polu enum | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
Domyślnie nie używaj. |
SUM
|
Odpowiada funkcji SUM .
|
COUNTA
|
Odpowiada funkcji COUNTA .
|
COUNT
|
Odpowiada funkcji COUNT .
|
COUNTUNIQUE
|
Odpowiada funkcji COUNTUNIQUE .
|
AVERAGE
|
Odpowiada funkcji AVERAGE .
|
MAX
|
Odpowiada funkcji MAX .
|
MIN
|
Odpowiada funkcji MIN .
|
MEDIAN
|
Odpowiada funkcji MEDIAN .
|
PRODUCT
|
Odpowiada funkcji PRODUCT .
|
STDEV
|
Odpowiada funkcji STDEV .
|
STDEVP
|
Odpowiada funkcji STDEVP .
|
VAR
|
Odpowiada funkcji VAR .
|
VARP
|
Odpowiada funkcji VARP .
|
CUSTOM
|
Wskazuje, że formuła powinna być używana w niezmienionej formie. Ta formuła jest ważna tylko wtedy, gdy ustawiono właściwość PivotValue.formula .
|
NONE
|
Wskazuje, że wartość została już podsumowana, a funkcja podsumowania nie jest wyraźnie określona. Służy w przypadku tabel przestawnych źródeł danych Lookera, w których wartość została 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żywać. |
PERCENT_OF_ROW_TOTAL
|
Pokazuje wartości w tabeli przestawnej jako odsetek wszystkich wartości w wierszu. |
PERCENT_OF_COLUMN_TOTAL
|
Wyświetla wartości w tabeli jako procent wartości w kolumnie. |
PERCENT_OF_GRAND_TOTAL
|
Wyświetla 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 poziomo (w kolumnach). |
VERTICAL
|
Wartości są układane w pionie (w wierszach). |