Pivot Tables

{
  "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.
}

object (PivotGroup)

Każde grupowanie wierszy w tabeli przestawnej.

object (PivotGroup)

Każde grupowanie kolumn w tabeli przestawnej.

map (key: integer, value: object ( PivotFilterCriteria))

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 C10:E15, klucz o wartości 0 będzie miał filtr kolumny C, a klucz 1 – dla kolumny D.

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

object (PivotFilterSpec)

Filtry zastosowane do kolumn źródłowych przed agregacją danych na potrzeby tabeli przestawnej.

W odpowiedziach podawane są wartości criteria i filterSpecs. Jeśli żądanie aktualizacji zawiera oba pola, to pole ma pierwszeństwo.

object (PivotValue)

Lista wartości do uwzględnienia w tabeli przestawnej.

enum (PivotValueLayout)

Określa, czy wartości mają być wymienione poziomo (jako kolumny) czy pionowo (jako wiersze).

object (DataExecutionStatus)

Tylko dane wyjściowe. Stan wykonywania danych w tabelach przestawnych źródła danych.

object (GridRange)

Zakres, z którego tabela przestawna odczytuje dane.

string

Identyfikator źródła danych, z którego tabela przestawna odczytuje dane.

{
  "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.
}

boolean

Prawda, jeśli tabela przestawna powinna zawierać sumy dla tej grupy.

object (PivotGroupValueMetadata)

Metadane dotyczące wartości w grupie.

enum (SortOrder)

Wartości w tej grupie powinny być sortowane w kolejności.

object (PivotGroupSortValueBucket)

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.

boolean

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”.

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

string

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 Region (którą można zmienić na State), a etykieta kolumny to Product (którą można zmienić na Item). 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ń istniejącą tabelę przestawną, a następnie utwórz nową tabelę przestawną 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 |
+--------------+---------+-------+

object (PivotGroupRule)

Reguła grupy, która ma być stosowana do tej grupy wierszy lub kolumn.

object (PivotGroupLimit)

Limit liczby wierszy lub kolumn, które mają być zastosowane do tej grupy przestawnej.

integer

Przesunięcie kolumny z zakresu źródłowego, na którym oparte jest to grupowanie.

Jeśli np. źródłem jest C10:E15, sourceColumnOffset o wartości 0 oznacza, że ta grupa odnosi się do kolumny C, a przesunięcie 1 – do kolumny D.

object (DataSourceColumnReference)

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

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

object (ExtendedValue)

Obliczona wartość, której odpowiadają metadane. (Funkcja formulaValue jest nieprawidłowa, ponieważ wartości zostaną obliczone).

boolean

Prawda, jeśli dane odpowiadające wartości są zwinięte.

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

integer

Przesunięcie na liście PivotTable.values, według którego mają być sortowane wartości w tej grupie.

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ść 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.

{

  // 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.
}

object (ManualRule)

ManualRule.

object (HistogramRule)

HistogramRule.

object (DateTimeRule)

DateTimeRule.

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

object (ManualRuleGroup)

Lista nazw grup i odpowiadających im elementów z danych źródłowych zmapowanych na nazwy poszczególnych grup.

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

object (ExtendedValue)

Nazwa grupy, która musi być ciągiem znaków. Każda grupa w danym elemencie ManualRule musi mieć unikalną nazwę grupy.

object (ExtendedValue)

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 ManualRule. Elementy, które nie występują w żadnej grupie, pojawią się samodzielnie.

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

number

Rozmiar tworzonych zasobników. Musi być liczbą dodatnią.

number

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.

number

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.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

Typ grupowania daty i godziny, który ma zostać zastosowany.

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

integer

Limit liczby.

integer

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 PivotTable.rows, a następnie listę PivotTable.columns.

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

string

Wartości, które należy podać. Wartości niewymienione w tym miejscu są wykluczone.

object (BooleanCondition)

Warunek, który musi zostać spełniony, aby wartości zostały wyświetlone. (visibleValues nie zastępuje tej wartości – nawet jeśli jest w niej wymieniona wartość, nadal jest ukryta, jeśli nie spełnia warunku).

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 =A1 w „tabeli przestawnej 1” jest traktowana 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”, a w kolumnie „Przychody” o typie NUMBER_GREATER i wartości =Cost został zastosowany warunek, uwzględniono tylko kolumny „Przychody” > „Koszt”.

boolean

Określa, czy wartości są domyślnie widoczne. Jeśli wartość to prawda, pola visibleValues są ignorowane, wyświetlane są wszystkie wartości spełniające kryteria condition (jeśli określono). Jeśli ma wartość false (fałsz), wyświetlane są wartości, które są zarówno w zadaniu visibleValues, jak i condition.

{
  "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.
}

object (PivotFilterCriteria)

Kryteria kolumny.

integer

Odsunięcie kolumny zakresu źródłowego od zera.

object (DataSourceColumnReference)

Odwołanie do kolumny źródła danych.

{
  "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.
}

enum (PivotValueSummarizeFunction)

Funkcja podsumowująca wartość. Jeśli ustawiona jest właściwość formula, jedyne obsługiwane wartości to SUM i CUSTOM. Jeśli ustawiona jest właściwość sourceColumnOffset, CUSTOM nie jest obsługiwana.

string

Nazwa, która ma być używana dla wartości.

enum (PivotValueCalculatedDisplayType)

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”.

integer

Przesunięcie kolumny zakresu źródłowego, z którego odczytuje tę wartość.

Jeśli np. źródłem jest C10:E15, sourceColumnOffset o wartości 0 oznacza, że ta wartość odnosi się do kolumny C, a przesunięcie 1 – do kolumny D.

string

Niestandardowa formuła do obliczania wartości. Formuła musi zaczynać się od znaku =.

object (DataSourceColumnReference)

Odwołanie do kolumny źródła danych, z której odczytuje tę wartość.