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))

Opcjonalne mapowanie filtrów na przesunięcie kolumny źródłowej.

Filtry są stosowane przed zgrupowaniem danych w tabeli przestawnej. Klucz mapy to przesunięcie kolumny w zakresie źródeł, które chcesz odfiltrować, a wartość to kryterium dla tej kolumny.

Jeśli np. źródło to C10:E15, klucz 0 będzie miał filtr dla kolumny C, a klucz 1 będzie dotyczył kolumny D.

To pole zostało wycofane i zastąpione polem filterSpecs.

filterSpecs[]

object (PivotFilterSpec)

Filtry zastosowane do kolumn źródłowych przed zgrupowaniem danych w tabeli przestawnej.

Zarówno criteria, jak i filterSpecs są wypełniane w odpowiedziach. Jeśli w żądaniu aktualizacji są podane oba pola, to pierwsze z nich 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ć wyświetlane poziomo (jako kolumny) czy pionowo (jako wiersze).

dataExecutionStatus

object (DataExecutionStatus)

Tylko dane wyjściowe. Stan wykonania danych w przypadku tabel przestawnych źródeł danych.

Pole uniisource_data. Źródło danych tabeli przestawnej. source_datamoże być tylko jedną z tych wartości:
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 (wiersz lub kolumna) 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 ma zawierać sumy dla tego grupowania.

valueMetadata[]

object (PivotGroupValueMetadata)

Metadane dotyczące wartości w grupowaniu.

sortOrder

enum (SortOrder)

kolejność sortowania wartości w tej grupie.

valueBucket

object (PivotGroupSortValueBucket)

Grupa elementów tabeli przestawnej, według której ma być wykonywane sortowanie. Jeśli nie podasz wartości, sortowanie odbywa się według alfabetu według wartości tej grupy.

repeatHeadings

boolean

Wartość Prawda, jeśli nagłówki w tej grupie przekształcenia powinny być powtarzane. Jest to możliwe tylko w przypadku grupowania wierszy, a kolumny ignorują tę opcję.

Domyślnie minimalizujemy powtarzanie nagłówków, nie wyświetlając nagłówków wyższego poziomu, jeśli są one takie same. Na przykład mimo że trzeci wiersz poniżej odpowiada marce „Q1”, nie jest on widoczny, ponieważ jest zbędny w porównaniu z poprzednimi wierszami. Ustawienie wartości „true” dla opcji repeatHeadings spowoduje powtarzanie wartości „Q1” w przypadku „Feb” i „Mar”. 

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+
label

string

Etykiety, których chcesz używać w przypadku grup wierszy lub kolumn, które możesz dostosowywać. Na przykład w tej tabeli przestawnej etykieta wiersza toRegion(którą można zmienić naState), a etykieta kolumny toProduct(którą można zmienić naItem). Tabele przestawne utworzone przed grudniem 2017 r. nie mają etykiet nagłówka. Jeśli chcesz dodać etykiety nagłówków do istniejącej tabeli przestawnej, usuń tę tabelę, a potem utwórz nową 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, który ma być stosowany w przypadku tej grupy przestawnej.

Pole uniisource. Źródło danych grupy przestawnej. sourcemoże być tylko jedną z tych wartości:
sourceColumnOffset

integer

Odsunięcie kolumny w zakresie źródłowym, na którym jest oparte to grupowanie.

Jeśli np. źródło to C10:E15, a sourceColumnOffset z 0 oznacza, że ta grupa odwołuje się do kolumny C, podczas gdy przesunięcie 1 odwołuje się do kolumny D.

dataSourceColumnReference

object (DataSourceColumnReference)

Odniesienie do kolumny źródła danych, na której podstawie tworzone jest to grupowanie.

PivotGroupValueMetadata

Metadane wartości w grupowaniu przestawnym.

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

object (ExtendedValue)

Obliczona wartość, której odpowiadają metadane. (Uwaga: formulaValue nie jest prawidłową wartością, ponieważ wartości zostaną obliczone).

collapsed

boolean

Wartość „PRAWDA”, jeśli dane odpowiadające wartości są zwężone.

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

Odstęp w liście PivotTable.values, według którego mają być sortowane wartości w tym ugrupowaniu.

buckets[]

object (ExtendedValue)

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ści w drugiej grupie kolumn. Jeśli nie ma żadnych wartości, oznacza to, że wiersz powinien być posortowany według wartości „Suma” w grupach kolumn. Jeśli podana jest tylko 1 wartość, oznacza to, że używana jest wartość „Łączna” w danym zbiorze.

PivotGroupRule

Opcjonalne ustawienie PivotGroup, które definiuje przedziały dla wartości w kolumnie danych źródłowych zamiast wyodrębniania poszczególnych wartości. Do każdej kolumny w źródłowych danych można dodać tylko jedną kolumnę PivotGroup z regułą grupową, ale do każdej kolumny możesz dodać zarówno kolumnę PivotGroup z regułą, jak i kolumnę PivotGroup bez reguły.

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 uniirule. Regułę, która ma być stosowana do PivotGroup. rulemoże być tylko jedną z tych wartości:
manualRule

object (ManualRule)

A ManualRule.

histogramRule

object (HistogramRule)

A HistogramRule.

dateTimeRule

object (DateTimeRule)

A DateTimeRule.

ManualRule

Umożliwia ręczne grupowanie wartości w kolumnie danych źródłowych w zbiorniki o wybranych nazwach. Na przykład tabela przestawna, która agreguje dane o liczbie ludności według stanu: 

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

może zostać przekształcona w tabelę przestawną, która agreguje dane o populacji według strefy czasowej, podając listę grup (np. groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) w regułach grupowych ręcznych. Pamiętaj, że 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 danych źródłowych, które są mapowane na nazwy grup.

ManualRuleGroup

nazwę grupy i listę elementów ze źródła danych, 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 danej ManualRulemusi mieć unikalną nazwę.

items[]

object (ExtendedValue)

Elementy w danych źródłowych, które powinny zostać umieszczone w tej grupie. Każdy element może być ciągiem tekstowym, liczbą lub wartością logiczną. Elementy mogą należeć do maksymalnie 1 grupy w danej ManualRule. Elementy, które nie należą do żadnej grupy, będą wyświetlane osobno.

HistogramRule

Umożliwia uporządkowanie wartości liczbowych w kolumnie danych źródłowych w zasobniki o stałym rozmiarze. Wszystkie wartości od HistogramRule.start do HistogramRule.end są umieszczane w grupach o wielkości HistogramRule.interval. Dodatkowo wszystkie wartości poniżej HistogramRule.start są umieszczane w jednej grupie, a wszystkie wartości powyżej HistogramRule.end są umieszczane w innej. Wymagane jest tylko pole HistogramRule.interval, ale jeśli podasz wartości HistogramRule.start i HistogramRule.end, wartość HistogramRule.start musi być mniejsza od wartości HistogramRule.end. Na przykład tabela przestawna zawierają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że zostać przekształcona w tabelę przestawną, która wygląda jak tabela poniżej, po zastosowaniu reguły grupy histogramu z wartością HistogramRule.startrówną 25, HistogramRule.intervalrówną 20 i HistogramRule.endrówną 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ć dodatni.

start

number

Minimalna wartość, przy której elementy są umieszczane w zasobnikach o stałym rozmiarze. Wartości poniżej wartości początkowej są grupowane w jednym zbiorniku. To pole jest opcjonalne.

end

number

Maksymalna wartość, przy której elementy są umieszczane w zasobnikach o stałym rozmiarze. Wartości powyżej wartości końcowej są grupowane w jednym zbiorniku. To pole jest opcjonalne.

DateTimeRule

Umożliwia grupowanie wartości daty i godziny w kolumnie danych źródłowych na podstawie wybranych części ich wartości. Rozważ na przykład tabelę przestawną, która pokazuje 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 z użyciem argumentu DateTimeRuleType YEAR_MONTH powoduje utworzenie tabeli przestawnej o takim kształcie. 

+--------------+--------------+
| 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 grupowania daty i godziny do zastosowania.

DateTimeRuleType

Dostępne typy reguł grupowania „data i godzina”. W tej dokumentacji zakładamy, że językiem arkusza kalkulacyjnego jest „en-US”, ale w przypadku niektórych typów reguł do renderowania dat i godzin używany jest język arkusza kalkulacyjnego.

Wartości w polu enum
DATE_TIME_RULE_TYPE_UNSPECIFIED Domyślny typ, którego nie należy używać.
SECOND Grupuj daty według sekundy, od 0 do 59.
MINUTE Grupuj daty według minut od 0 do 59.
HOUR Grupuj daty według godzin w systemie 24-godzinnym (od 0 do 23).
HOUR_MINUTE Grupuj daty według godziny i minuty, używając systemu 24-godzinnego, np. 19:45.
HOUR_MINUTE_AMPM Grupuj daty według godziny i minuty, używając 12-godzinnego systemu, np. 19:45. Oznaczenie AM/PM jest tłumaczone na podstawie ustawień regionalnych arkusza kalkulacyjnego.
DAY_OF_WEEK Pogrupuj 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 w roku, od 1 do 366. Pamiętaj, że w rokach przestępnych daty po 29 lutego znajdują się w innych grupach niż w rokach 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, np. 22-Nov. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego.
MONTH grupowanie dat według miesiąca, np. listopad. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego;
QUARTER Grupuj daty według kwartału, np. Q1 (styczeń–marzec).
YEAR Grupuj daty według roku, np. 2008.
YEAR_MONTH Grupuj daty według roku i miesiąca, np. 2008-list. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego.
YEAR_QUARTER Grupuj daty według roku i kwartału, np. 2008 IV Q.
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

integer

Limit liczby.

applyOrder

integer

Kolejność, w jakiej ograniczenie grupy jest stosowane do tabeli przestawnej.

Limity grupowania elementów tabeli przestawnej są stosowane od najniższego do najwyższego numeru porządkowego. Numery zamówień są normalizowane do kolejnych liczb całkowitych, zaczynając od 0.

W przypadku żądania zapisu, aby w pełni dostosować kolejność stosowania, wszystkie limity grup przekształceń powinny mieć to pole ustawione na unikalny numer. W przeciwnym razie kolejność jest określana przez indeks na liście PivotTable.rows, a następnie na liście PivotTable.columns.

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 należy uwzględnić. Wartości, których nie ma na tej liście, są wykluczane.

condition

object (BooleanCondition)

Warunek, który musi być spełniony, aby wartości były wyświetlane. ( visibleValues nie zastąpi tego – nawet jeśli wartość jest podana, nadal jest ukryta, jeśli nie spełnia warunku).

Wartości warunków, które odwołują się do zakresów w notacji A1, są oceniane w stosunku do arkusza tabeli przestawnej. Odwołania są traktowane absolutnie, więc nie są wypełniane w tabeli przestawnej. Na przykład wartość warunku =A1 w tabeli przestawnej „Tabela przestawna 1” jest traktowana jako 'Pivot Table 1'!$A$1.

Odwołania do danych źródłowych tabeli przestawnej mogą zawierać nazwę nagłówka kolumny. Jeśli np. dane źródłowe zawierają kolumny o nazwach „Przychody” i „Koszt”, a do kolumny „Przychody” zastosowano warunek o typie NUMBER_GREATER i wartości =Cost, uwzględnione zostaną tylko kolumny, w których wartości w kolumnie „Przychody” > „Koszt”.

visibleByDefault

boolean

Określa, czy wartości są domyślnie widoczne. Jeśli jest to prawda, wartości w kolumnie visibleValues są ignorowane, a wyświetlane są wszystkie wartości, które spełniają kryterium określone w kolumnie condition (jeśli jest ona podana). Jeśli jest ustawiona na wartość FAŁSZ, wyświetlane są wartości, które są jednocześnie w zakresie visibleValues i spełniają kryterium condition.

PivotFilterSpec

Kryteria filtrowania tabeli przestawnej powiązane z konkretnym przesunięciem 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 uniisource. Źródłowa kolumna, do której ma zastosowanie ten filtr. sourcemoże być tylko jedną z tych wartości:
columnOffsetIndex

integer

Odsunięcie kolumny w zakresie źródłowym liczone od 0.

dataSourceColumnReference

object (DataSourceColumnReference)

Odwołuje się 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 podsumowująca wartość. Jeśli parametr formula jest ustawiony, obsługiwane są tylko wartości SUM i CUSTOM. Jeśli parametr sourceColumnOffset jest ustawiony, parametr CUSTOM nie jest obsługiwany.

name

string

Nazwa do użycia dla wartości.

calculatedDisplayType

enum (PivotValueCalculatedDisplayType)

Jeśli jest określony, wskazuje, że wartości pivot powinny być wyświetlane jako wynik obliczenia z inną wartością pivot. Jeśli na przykład parametr calculatedDisplayType ma wartość PERCENT_OF_GRAND_TOTAL, wszystkie wartości kolumny pivot są wyświetlane jako procenty sumy końcowej. W edytorze Arkuszy ta opcja nosi nazwę „Wyświetlaj jako” w sekcji wartości tabeli przestawnej.

Pole uniivalue. Dane, których chcesz używać do wartości w tabeli przestawnej. Musisz podać dokładnie jedną wartość. valuemoże być tylko jedną z tych wartości:
sourceColumnOffset

integer

Odsunięcie kolumny w zakresie źródłowym, z którego ta wartość jest odczytywana.

Jeśli na przykład źródło to C10:E15, sourceColumnOffset z 0 oznacza, że ta wartość odnosi się do kolumny C, podczas gdy przesunięcie 1 odnosi się do kolumny D.

formula

string

Formuła niestandardowa służąca do obliczenia wartości. Formuła musi się zaczynać znakiem =.

dataSourceColumnReference

object (DataSourceColumnReference)

Odwołanie do kolumny źródła danych, z której ta wartość jest odczytywana.

PivotValueSummarizeFunction

Funkcja do podsumowywania wartości w tabeli przestawnej.

Wartości w polu enum
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED Wartość domyślna, której nie należy używać.
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żyta w postaci oryginalnej. Jest prawidłowa tylko wtedy, gdy ustawiono opcję PivotValue.formula.
NONE Wskazuje, że wartość została już podsumowana, a funkcja podsumowywania nie została wyraźnie określona. Używane w tabelach przestawnych źródeł danych Looker, w których wartość jest już podsumowana.

PivotValueCalculatedDisplayType

Możliwe sposoby obliczania wartości w tabeli przestawnej na potrzeby wyświetlania.

Wartości w polu enum
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED Wartość domyślna, której nie należy używać.
PERCENT_OF_ROW_TOTAL Wyświetla wartości kolumny jako procent wartości sumy wierszy.
PERCENT_OF_COLUMN_TOTAL Pokazuje wartości przekształcenia jako odsetek łącznych wartości kolumny.
PERCENT_OF_GRAND_TOTAL Wyświetla wartości kolumny jako procent wartości łącznej.

PivotValueLayout

Układ wartości przestawionych.

Wartości w polu enum
HORIZONTAL Wartości są rozmieszczone poziomo (jako kolumny).
VERTICAL Wartości są rozmieszczone w pionie (jako wiersze).