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ódłowym, który 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 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 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ć 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 uniisource_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 ma 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 przestawień mają być powtarzane. 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 opcji repeatHeadings na „PRAWDA” spowoduje powtórzenie 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ż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, który ma być stosowany w przypadku tej grupy przestawnej.

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

integer

Przesunięcie kolumny zakresu źródłowego, na którym opiera się ta 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 dotyczące wartości w grupowaniu elementów tabeli przestawnej.

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

object (ExtendedValue)

Obliczona wartość, z którą są zgodne 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

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 wybierane są wartości 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 według „Suma całkowita” nad grupami kolumn. Jeśli podana jest tylko jedna wartość, odpowiada ona wartości „Łącznej” 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ą funkcję PivotGroup z regułą grupową, ale do każdej kolumny możesz dodać funkcję PivotGroup z regułą i funkcję 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. rule może być tylko jednym z tych elementów:
manualRule

object (ManualRule)

ManualRule.

histogramRule

object (HistogramRule)

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

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ą 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 grupowanie wartości liczbowych w kolumnie danych źródłowych w zbiorniki o stałym rozmiarze. Wszystkie wartości z HistogramRule.start do HistogramRule.end są umieszczane w grupach rozmiarów 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. 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ż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.start równą 25, wartością HistogramRule.interval równą 20 i wartością HistogramRule.end ró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ć liczbą dodatnią.

start

number

Minimalna wartość, z jaką elementy są umieszczane w segmentach o stałej wielkości. Wartości poniżej wartości początkowej są grupowane w jednym zasobniku. To pole jest opcjonalne.

end

number

Maksymalna wartość, przy której elementy są umieszczane w zasobnikach o stałym rozmiarze. 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. Rozważ na przykład tabelę przestawną z transakcjami sprzedaży posortowanymi 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 grupowania daty i godziny, który ma być zastosowany.

DateTimeRuleType

Dostępne typy reguł grupowania „data i godzina”. Ta dokumentacja zakłada, ż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 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 Grupuj daty według godzin w systemie 24-godzinnym (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. 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 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 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 Możesz pogrupować daty według roku, np. 2008 r.
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 Grupuj daty według roku i kwartału, np. 2008 IV kwartał.
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 grup przestawnych są stosowane od najniższego do wyższego numeru kolejności. 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 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ó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ępuje tego – nawet jeśli jakaś wartość jest na liście, to i tak 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 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” &gt; „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 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. Kolumna źródłowa, do której ma zastosowanie dany filtr. sourcemoże być tylko jedną z tych wartości:
columnOffsetIndex

integer

Od zera przesunięcie kolumny zakresu źródłowego.

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 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 do użycia dla 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 nosi nazwę „Wyświetlaj jako” w sekcji wartości tabeli przestawnej.

Pole sumy value Dane, których chcesz używać do wartości w tabeli przestawnej. Musisz ustawić dokładnie jedną wartość. valuemoże być tylko jedną z tych wartości:
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

niestandardowa formuła służąca do obliczenia 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 Domyślna wartość, której nie należy używać.
SUM Odpowiada SUM .
COUNTA Odpowiada COUNTA .
COUNT Odpowiada COUNT .
COUNTUNIQUE Odpowiada COUNTUNIQUE .
AVERAGE Odpowiada AVERAGE .
MAX Odpowiada MAX .
MIN Odpowiada funkcji MIN.
MEDIAN Odpowiada MEDIAN .
PRODUCT Odpowiada funkcji PRODUCT.
STDEV Odpowiada STDEV .
STDEVP Odpowiada funkcji STDEVP.
VAR Odpowiada VAR .
VARP Odpowiada 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, 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ą rozmieszczone w pionie (jako wiersze).