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żda grupa kolumn w tabeli przestawnej.

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

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

Filtry są stosowane przed agregowaniem danych do tabeli przestawnej. Klucz mapy to przesunięcie kolumny względem zakresu źródłowego, który chcesz filtrować, a wartością są kryteria tej kolumny.

Jeśli na przykład źródło to C10:E15, klucz właściwości 0 będzie zawierać filtr kolumny C, a klucz 1 będzie przeznaczony dla kolumny D.

To pole jest wycofane i zastąpione polem filterSpecs.

object (PivotFilterSpec)

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

Zarówno odpowiedzi criteria, jak i filterSpecs są wypełnione. Jeśli w żądaniu aktualizacji podasz oba pola, pierwszeństwo ma to pole.

object (PivotValue)

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

enum (PivotValueLayout)

Określa, czy wartości powinny być wyświetlane w poziomie (jako kolumny) czy pionowo (jako wiersze).

object (DataExecutionStatus)

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

object (GridRange)

Zakres, w którym 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

Wartość to „prawda”, jeśli tabela przestawna powinna zawierać sumy dla tej grupy.

object (PivotGroupValueMetadata)

Metadane dotyczące wartości w grupowaniu.

enum (SortOrder)

Kolejność wartości w tej grupie powinna być posortowana.

object (PivotGroupSortValueBucket)

Zasobnik drugiej grupy przestawnej, według którego chcesz sortować dane. Jeśli nie określono sortowania, sortowanie jest oparte na wartościach alfabetycznych według wartości tej grupy.

boolean

Wartość to „prawda”, jeśli nagłówki w tej grupie przestawnej powinny się powtarzać. Dotyczy to tylko grupowania wierszy i jest ignorowane przez kolumny.

Domyślnie ograniczamy liczbę powtórzeń nagłówków, nie wyświetlając nagłówków, które są na wyższym poziomie. Na przykład chociaż trzeci wiersz poniżej odpowiada wartości „Mar I kwartału”, wartość „Q1” nie jest wyświetlana, ponieważ jest nadmierna w poprzednich wierszach. Ustawienie wartości true upewnij się, że powtórzenia „Q1” są powtarzane w przypadku pól „luty” i „mar”.

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

string

Etykiety służące do grup wierszy i kolumn, które można dostosować. Na przykład w tabeli przestawnej etykieta wiersza to Region (która może zostać zmieniona na State), a etykieta kolumny to Product (które można zmienić na Item). Tabele przestawne utworzone przed grudniem 2017 roku nie mają etykiet nagłówków. Jeśli chcesz dodać etykiety nagłówka 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 grupowa stosowana do tej grupy wierszy/kolumn.

object (PivotGroupLimit)

Limit liczby wierszy lub kolumn w tej grupie przestawnej.

integer

Przesunięcie kolumny dla zakresu źródłowego, na którym opiera się to grupowanie.

Jeśli np. źródłem było C10:E15, sourceColumnOffset z 0 to ta grupa odnosi się do kolumny C, a przesunięcie 1 do kolumny D.

object (DataSourceColumnReference)

Odwołanie do kolumny źródła danych, na podstawie której powstało to grupowanie.

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

object (ExtendedValue)

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

boolean

Wartość to „prawda”, jeśli dane odpowiadające wartości są zwinięte.

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

integer

Przesunięcie z listy PivotTable.values, według której wartości w tej grupie powinny być sortowane.

object (ExtendedValue)

Określa zasobnik, z którego wybierane są wartości.

Na przykład w tabeli przestawnej z 1 grupą wierszy i 2 grupami kolumn grupa może zawierać maksymalnie 2 wartości. Pierwsza wartość odpowiada wartości w pierwszej grupie kolumn, a druga wartość odpowiada wartości w drugiej grupie kolumn. Jeśli na liście nie ma żadnych wartości, oznacza to, że wiersz powinien zostać posortowany według wartości „Łącznie” w grupach kolumn. Jeśli jest podana jedna wartość, oznacza to, że używana jest wartość „Łą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 grup.

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

object (ExtendedValue)

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

object (ExtendedValue)

Elementy w danych źródłowych, które powinny znaleźć się w tej grupie. Każdy element może być ciągiem, cyfrą lub wartością logiczną. Elementy mogą się pojawić w maksymalnie 1 grupie w ramach danego ManualRule. Elementy, które nie pojawiają się w żadnej grupie, pojawią się osobno.

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

number

Rozmiar tworzonych zasobników. Musi być dodatnia.

number

Minimalna wartość, przy której elementy są umieszczane w zasobnikach o stałym rozmiarze. Wartości poniżej zaczynają się w jednym zasobniku. To pole jest opcjonalne.

number

Maksymalna wartość, w jakiej elementy są umieszczane w zasobnikach o stałym rozmiarze. Wartości na końcu są łączone w jeden zasobnik. To pole jest opcjonalne.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

Typ grupowania daty i godziny do zastosowania.

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

integer

Limit.

integer

Kolejność, w jakiej limit grup jest stosowany do tabeli przestawnej.

Limity grup przestawnych są stosowane od najniższego do najwyższego numeru zamówienia. Numery zamówień są normalizowane do kolejnych liczb całkowitych z zakresu od 0.

Aby można było w pełni dostosować stosowane zamówienia, wszystkie limity grup przestawnych powinny mieć w tym polu unikalną liczbę. W innym przypadku kolejność indeksowania zależy od indeksu na liście PivotTable.rows, a następnie od listy PivotTable.columns.

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

string

Wartości, które należy uwzględnić. Wartości, które nie są tu wymienione, są wykluczone.

object (BooleanCondition)

Warunek, który musi być spełniony, aby wartości były wyświetlane. (visibleValues nie zastępuje tego – nawet jeśli wartość znajduje się na tej liście, jest ona 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 odniesieniu do arkusza tabeli przestawnej. Odwołania są traktowane w pełni, więc nie wypełniają tabeli przestawnej. 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łać nazwą nagłówka kolumny. Jeśli np. dane źródłowe mają kolumny o nazwie „Przychody” i „Koszt”, a w kolumnie „Przychody” typ NUMBER_GREATER i wartość =Cost są zastosowane warunek, zobaczysz tylko kolumny, w których uwzględnione są „Przychody” > „Koszt”.

boolean

Określa, czy wartości są domyślnie widoczne. Jeśli zasada ma wartość Prawda, visibleValues jest ignorowane, wyświetlane są wszystkie wartości, które spełniają condition (jeśli został określony). Jeśli ma wartość Fałsz, wyświetlane są wartości znajdujące się zarówno w polu visibleValues, jak i w polu 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 dotyczące kolumny.

integer

Przesunięcie kolumny na podstawie wartości zerowej dla zakresu źródłowego.

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 do podsumowania wartości. Jeśli ustawiona jest wartość formula, jedyne obsługiwane wartości to SUM i CUSTOM. Jeśli ustawiona jest wartość sourceColumnOffset, właściwość CUSTOM nie jest obsługiwana.

string

Nazwa wartości.

enum (PivotValueCalculatedDisplayType)

Jeśli jest określona, wskazuje, że wartości przestawne powinny być wyświetlane w wyniku obliczenia innej wartości. Jeśli na przykład obliczony parametr typuDisplayDisplay ma wartość PERCENT_OF_GRAND_TOTAL, wszystkie wartości przestawne są wyświetlane jako procent łącznej kwoty. W edytorze Arkuszy jest ono określane jako „Wyświetl jako” w sekcji wartości tabeli przestawnej.

integer

Przesunięcie kolumny z zakresu źródłowego, z którego odczytuwana jest ta wartość.

Na przykład jeśli źródło to C10:E15, sourceColumnOffset: 0 to wartość, która odnosi się do kolumny C, a przesunięcie 1 odnosi się 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ść.