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)

数据透视表中的各行分组。

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。

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

如果数据透视表应包含此分组的总计，则为 true。

object (PivotGroupValueMetadata)

有关分组中值的元数据。

enum (SortOrder)

该组中值的排序顺序。

object (PivotGroupSortValueBucket)

要排序的相反数据透视组的分桶。如果未指定，则按照该组的值的字母顺序排序。

boolean

如果此数据透视组中的标题应重复，则为“true”。此字段仅对行分组有效，会被列忽略。

默认情况下，我们不会在相同标题下显示更高级别的标题，从而尽可能减少重复标题。例如，即使下面的第三行对应于“3 月 1 日”，“Q1”由于与前面的行重复，因此未显示。将 repeatHeadings 设置为 true 会导致“Q1”重复用于“2 月”和“Mar”

+--------------+
| 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、 sourceColumnOffset / 0 表示此组引用了 C，而 1 将引用列 D。

object (DataSourceColumnReference)

对此分组所依据的数据源列的引用。

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

object (ExtendedValue)

元数据对应的计算值。（请注意， formulaValue 无效，因为系统会计算这些值。）

boolean

如果与该值对应的数据已收起，则为 true。

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

integer

与 PivotTable.values 列出此分组中的值应作为排序依据。

object (ExtendedValue)

确定从哪个分桶中选择值进行排序。

例如，在包含一个行组和两个列组，则行组最多可列出两个值。第一个值对应于第一个列组中的某个值，第二个值对应于第二个列组中的一个值。如果未列出任何值，则表示应根据“总计”对该行进行排序对列组进行过滤如果列出了单个值，这对应于使用“总计”该存储分区的数据。

{

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

组名称列表，以及源数据中映射到每个组名称的相应项。

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

object (ExtendedValue)

组名称，必须是一个字符串。给定数据集中的每个组 ManualRule 具有唯一的组名称

object (ExtendedValue)

源数据中应放入此群组的项。每一项可以是字符串、数字或布尔值。给定项目最多只能出现在一个组中 ManualRule。未出现在任何组中的项会单独显示。

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

number

所创建的存储分区的大小。必须为正数。

number

项放入大小不变的桶中的最小值。低于起始值的值会汇总到单个分桶中。此字段是可选字段。

number

项放入大小不变的桶中的最大值。超出上限的值将汇总到一个分桶中。此字段是可选字段。

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

要应用的日期时间分组的类型。

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

integer

计数限制。

integer

组限制应用于数据透视表的顺序。

数据透视表元素组限制按照从低到高的顺序应用。订单号将标准化为从 0 开始的连续整数。

对于写入请求，为了全面自定义应用订单，所有数据透视表元素组限制都应为此字段设置唯一编号。否则，系统将根据 PivotTable.rows 列表，然后点击 PivotTable.columns 。

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

string

应包含的值。不包括此处未列出的值。

object (BooleanCondition)

为显示值必须设为 true 的条件。( visibleValues 不会覆盖此 - 即使其中列出了某个值，但如果它不符合该条件，它仍会处于隐藏状态。）

系统会相对于数据透视表工作表对引用范围（采用 A1 表示法）的条件值进行评估。引用是绝对处理的，因此不会在数据透视表中填充内容。例如，条件值 =A1 在“数据透视表 1”上会被视为 'Pivot Table 1'!$A$1。

可以通过列标题名称引用数据透视表的源数据。例如，如果源数据中有名为“Revenue”的列和“费用”并且对“Revenue”应用了条件包含类型的列 NUMBER_GREATER 和值 =Cost，则仅搜索>“费用”资源。

boolean

是否默认显示值。如果为 true， visibleValues 均会被忽略，所有符合 condition （如果已指定）。如果为 false， visibleValues 见 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)

列的条件。

integer

源范围的列偏移量（从零开始）。

object (DataSourceColumnReference)

对数据源列的引用。

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

用于汇总值的函数。如果 formula 则仅支持以下值： SUM 和 CUSTOM。如果 sourceColumnOffset 设置，则 CUSTOM 不受支持。

string

值的名称。

enum (PivotValueCalculatedDisplayType)

如果指定，则表示数据透视值应当作为使用另一个数据透视值的计算结果显示。例如，如果 computeDisplayType 指定为 PERCENT_OF_GRAND_TOTAL，则所有数据透视值都显示为占总计的百分比。在表格编辑器中，这称为“显示为”。

integer

从其中读取数据的源范围的列偏移量。

例如，如果来源是 C10:E15、 sourceColumnOffset / 0 表示此值引用了 C，而 1 将引用列 D。

string

用于计算值的自定义公式。公式必须以 = 字符。

object (DataSourceColumnReference)

对此值从中读取数据的数据源列的引用。