Pivot Tables

object (PivotGroup)

資料透視表中的每個資料列群組。

object (PivotGroup)

資料透視表中的每個欄組。

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

每個來源欄位偏移值的選用篩選器對應項目。

系統會在將資料匯入資料透視表前套用篩選器。對應表的鍵是您要篩選的來源範圍資料欄偏移量，而值是該資料欄的篩選條件。

舉例來說，如果來源是 C10:E15，0 的鍵會設有 C 資料欄的篩選器，而 1 鍵則是 D 資料欄。

這個欄位已淘汰，請改用 filterSpecs。

object (PivotFilterSpec)

在匯總資料透視表資料前，套用至來源欄的篩選器。

回應中會填入 criteria 和 filterSpecs。如果更新要求中同時指定了這兩個欄位，則以這個欄位為優先。

object (PivotValue)

要納入資料透視表的值清單。

enum (PivotValueLayout)

值應以水平 (資料欄) 或垂直 (資料列) 方式列出。

object (DataExecutionStatus)

僅供輸出。資料來源資料透視表的資料執行狀態。

object (GridRange)

資料透視表讀取資料的範圍。

string

資料透視表讀取資料的資料來源 ID。

boolean

如果樞紐分析表應納入此群組的總和，則為「是」。

object (PivotGroupValueMetadata)

分組中值的中繼資料。

enum (SortOrder)

這個群組中值的排序順序。

object (PivotGroupSortValueBucket)

要依據哪個相反的資料透視表群組進行排序。如未指定，系統會依照這個群組的值以字母順序排序。

boolean

如果這個樞紐群組中的標題應重複，則為「是」。這項屬性僅適用於資料列分組，資料欄會忽略這項屬性。

根據預設，我們會盡量減少標題重複的情況，也就是在相同層級不顯示重複的標題。舉例來說，雖然下方第三列對應「Q1 Mar」，但「Q1」不會顯示，因為與前面幾列重複。如果將 repeatHeadings 設為 true，系統就會在「Feb」和「Mar」中重複顯示「Q1」。

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

string

可用來為可自訂的資料列/欄組使用的標籤。舉例來說，在下列資料透視表中，列標籤為 Region (可重新命名為 State)，而欄標籤為 Product (可重新命名為 Item)。在 2017 年 12 月之前建立的資料透視表沒有標題標籤。如要在現有的樞紐分析表中新增標題標籤，請先刪除現有的樞紐分析表，然後使用相同的參數建立新的樞紐分析表。

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+

object (PivotGroupRule)

要套用至此列/欄群組的群組規則。

object (PivotGroupLimit)

要套用至此樞紐群組的資料列或資料欄數量上限。

integer

此分組所依據的來源範圍的資料欄偏移量。

舉例來說，如果來源是 C10:E15，0 的 sourceColumnOffset 代表這個群組參照 C 資料欄，而偏移量 1 則會參照 D 資料欄。

object (DataSourceColumnReference)

這個分組所依據的資料來源欄參照。

object (ExtendedValue)

中繼資料對應的計算值。(請注意，formulaValue 無效，因為系統會計算值)。

boolean

如果對應的資料已摺疊，則傳回「是」。

integer

PivotTable.values 清單中的偏移量，這個群組中的值應依此排序。

object (ExtendedValue)

決定從哪個值區選擇值來排序。

舉例來說，在包含一個資料列群組和兩個資料欄群組的資料透視表中，資料列群組最多可列出兩個值。第一個值對應至第一個欄組中的值，第二個值則對應至第二個欄組中的值。如果沒有列出任何值，表示資料列應根據各欄組的「總計」排序。如果列出單一值，則會對應到該值的「總計」。

object (ManualRule)

ManualRule。

object (HistogramRule)

HistogramRule。

object (DateTimeRule)

DateTimeRule。

object (ManualRuleGroup)

群組名稱清單，以及對應的來源資料項目，這些項目會對應至各個群組名稱。

object (ExtendedValue)

群組名稱，必須是字串。指定 ManualRule 中的每個群組都必須有專屬的群組名稱。

object (ExtendedValue)

來源資料中應放入這個群組的項目。每個項目可以是字串、數字或布林值。項目最多只能出現在特定 ManualRule 中的一個群組中。未顯示在任何群組中的項目會單獨顯示。

number

已建立的桶大小。必須為正數。

number

項目放入固定大小值區的最小值。小於起始值的值會歸入單一特徵分塊。這是選填欄位。

number

項目放入固定大小值區的上限值。大於 end 的值會歸為單一特徵分塊。這是選填欄位。

enum (DateTimeRuleType)

要套用的日期時間分組類型。

integer

計數限制。

integer

群組限制套用至資料透視表的順序。

資料透視表元素群組限制會從較低的順序號碼開始套用。系統會將訂單號碼正規化為從 0 開始的連續整數。

針對寫入要求，為充分自訂套用順序，所有樞紐群組限制都應使用這個欄位，並設定不重複的數字。否則，系統會依據 PivotTable.rows 清單中的索引，然後依據 PivotTable.columns 清單決定順序。

string

應納入的值。未列出的值會遭到排除。

object (BooleanCondition)

必須設為 true 才能顯示值的條件。(visibleValues 不會覆寫這個值，即使在該值中列出，如果不符合條件，仍會隱藏該值)。

以 A1 表示法參照範圍的條件值會相對於資料透視表工作表進行評估。系統會絕對處理參照，因此不會在資料透視表中填入參照。舉例來說，如果「樞紐資料表 1」的條件值為 =A1，系統會將其視為 'Pivot Table 1'!$A$1。

資料透視表的來源資料可透過資料欄標題名稱參照。舉例來說，如果來源資料含有名為「Revenue」和「Cost」的資料欄，且「Revenue」欄已套用類型為 NUMBER_GREATER 且值為 =Cost 的條件，則系統只會擷取「Revenue」>「Cost」的資料欄。

boolean

是否預設顯示值。如果為 true，系統會忽略 visibleValues，並顯示符合 condition (如果已指定) 的所有值。如果為 false，系統會顯示同時位於 visibleValues 且符合 condition 的值。

object (PivotFilterCriteria)

資料欄的條件。

integer

來源範圍的零基底欄偏移量。

object (DataSourceColumnReference)

資料來源欄的參照。

enum (PivotValueSummarizeFunction)

用於匯總值的函式。如果已設定 formula，則唯一支援的值為 SUM 和 CUSTOM。如果已設定 sourceColumnOffset，則不支援 CUSTOM。

string

要用於值的名稱。

enum (PivotValueCalculatedDisplayType)

如果指定此值，表示樞紐值應以其他樞紐值的計算結果顯示。舉例來說，如果指定的 calculatedDisplayType 為 PERCENT_OF_GRAND_TOTAL，所有樞紐值都會以總計的百分比顯示。在 Google 試算表編輯器中，資料透視表的值部分會稱為「顯示為」。

integer

這個值讀取的來源範圍欄位偏移量。

舉例來說，如果來源是 C10:E15，0 的 sourceColumnOffset 代表這個值會參照資料欄 C，而偏移量 1 會參照資料欄 D。

string

用於計算值的自訂公式。公式開頭必須為 = 字元。

object (DataSourceColumnReference)

這個值讀取的資料來源欄參照。