Trang này được dịch bởi Cloud Translation API.

Pivot Tables

Bảng tổng hợp

Bảng tổng hợp.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng 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`. }

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

Các trường
`rows[]`	`object (PivotGroup)` Mỗi nhóm hàng trong bảng tổng hợp.
`columns[]`	`object (PivotGroup)` Mỗi nhóm cột trong bảng tổng hợp.
`criteria (deprecated)`	`map (key: integer, value: object ( PivotFilterCriteria))` Mặt hàng này đã ngừng hoạt động! Ánh xạ tuỳ chọn của bộ lọc cho mỗi phần bù cột nguồn. Các bộ lọc được áp dụng trước khi tổng hợp dữ liệu vào bảng tổng hợp. Khóa của bản đồ là độ lệch cột của dải ô nguồn mà bạn muốn lọc và giá trị là tiêu chí cho cột đó. Ví dụ: nếu nguồn là `C10:E15`, khoá `0` sẽ có bộ lọc cho cột `C`, trong khi khoá `1` là dành cho cột `D`. Trường này không còn được sử dụng và thay bằng `filterSpecs`.
`filterSpecs[]`	`object (PivotFilterSpec)` Các bộ lọc được áp dụng cho cột nguồn trước khi tổng hợp dữ liệu cho bảng tổng hợp. Cả `criteria` và `filterSpecs` đều được điền các câu trả lời. Nếu cả hai trường đều được chỉ định trong yêu cầu cập nhật, trường này sẽ được ưu tiên.
`values[]`	`object (PivotValue)` Danh sách các giá trị cần đưa vào bảng tổng hợp.
`valueLayout`	`enum (PivotValueLayout)` Liệu giá trị nên được liệt kê theo chiều ngang (dưới dạng cột) hay theo chiều dọc (dưới dạng hàng).
`dataExecutionStatus`	`object (DataExecutionStatus)` Chỉ đầu ra. Trạng thái thực thi dữ liệu cho bảng tổng hợp nguồn dữ liệu.
Trường nhóm `source_data`. Nguồn của dữ liệu bảng tổng hợp. `source_data` chỉ có thể là một trong những loại sau đây:
`source`	`object (GridRange)` Dải ô mà bảng tổng hợp đang đọc dữ liệu.
`dataSourceId`	`string` Mã của nguồn dữ liệu mà bảng tổng hợp đang đọc dữ liệu.

Bảng tổng hợp

Một nhóm duy nhất (hàng hoặc cột) trong bảng tổng hợp.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng 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`. }

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

Các trường
`showTotals`	`boolean` Đúng nếu bảng tổng hợp phải bao gồm tổng số cho nhóm này.
`valueMetadata[]`	`object (PivotGroupValueMetadata)` Siêu dữ liệu về các giá trị trong nhóm.
`sortOrder`	`enum (SortOrder)` Thứ tự mà các giá trị trong nhóm này phải được sắp xếp.
`valueBucket`	`object (PivotGroupSortValueBucket)` Nhóm của bảng tổng hợp đối diện để sắp xếp theo. Nếu không được chỉ định, sắp xếp theo thứ tự bảng chữ cái theo giá trị của nhóm này.
`repeatHeadings`	`boolean` Đúng nếu các tiêu đề trong nhóm tổng hợp này phải được lặp lại. Giá trị này chỉ hợp lệ cho các nhóm hàng và bị cột bỏ qua. Theo mặc định, chúng tôi giảm thiểu việc lặp lại các tiêu đề bằng cách không hiển thị các tiêu đề cấp cao hơn khi các tiêu đề đó giống nhau. Ví dụ: mặc dù hàng thứ ba dưới đây tương ứng với "Q1/03", "Q1" không được hiển thị vì hàng thừa với các hàng trước. Việc đặt lặp lạiTiêu đề thành true sẽ lặp lại "Q1" cho "Feb" và "Mar". `+--------------+ \| Q1 \| Jan \| \| \| Feb \| \| \| Mar \| +--------+-----+ \| Q1 Total \| +--------------+`
`label`	`string` Nhãn để sử dụng cho nhóm hàng/cột có thể được tùy chỉnh. Ví dụ: trong bảng tổng hợp sau, nhãn hàng là `Region` (có thể được đổi tên thành `State`) và nhãn cột là `Product` (có thể đổi tên thành `Item`). Bảng tổng hợp được tạo trước tháng 12 năm 2017 không có nhãn tiêu đề. Nếu bạn muốn thêm nhãn tiêu đề vào bảng tổng hợp hiện có, vui lòng xóa bảng tổng hợp hiện có, sau đó tạo bảng tổng hợp mới có cùng tham số. `+--------------+---------+-------+ \| SUM of Units \| Product \| \| \| Region \| Pen \| Paper \| +--------------+---------+-------+ \| New York \| 345 \| 98 \| \| Oregon \| 234 \| 123 \| \| Tennessee \| 531 \| 415 \| +--------------+---------+-------+ \| Grand Total \| 1110 \| 636 \| +--------------+---------+-------+`
`groupRule`	`object (PivotGroupRule)` Quy tắc nhóm để áp dụng cho nhóm hàng/cột này.
`groupLimit`	`object (PivotGroupLimit)` Giới hạn số lượng trên hàng hoặc cột để áp dụng cho nhóm bảng tổng hợp này.
Trường nhóm `source`. Nguồn dữ liệu của nhóm bảng tổng hợp. `source` chỉ có thể là một trong những loại sau đây:
`sourceColumnOffset`	`integer` Độ lệch cột của dải ô nguồn mà nhóm này dựa vào. Ví dụ: nếu nguồn là `C10:E15`, `sourceColumnOffset` là `0` nghĩa là nhóm này tham chiếu đến cột `C`, trong khi độ lệch `1` là cột `D`.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` Tham chiếu đến cột nguồn dữ liệu mà nhóm này dựa vào.

PivotGroupValueMetadata

Siêu dữ liệu về một giá trị trong nhóm bảng tổng hợp.

Biểu diễn dưới dạng JSON
{ "value": { object (`ExtendedValue`) }, "collapsed": boolean }

Các trường

value

object (ExtendedValue)

Giá trị được tính toán mà siêu dữ liệu tương ứng. (Lưu ý rằng formulaValue không hợp lệ vì các giá trị sẽ được tính toán.)

collapsed

boolean

Đúng nếu dữ liệu tương ứng với giá trị được thu gọn.

Bảng tổng hợp nhóm giá trị

Thông tin về những giá trị trong một nhóm tổng hợp sẽ được dùng để sắp xếp.

Biểu diễn dưới dạng JSON
{ "valuesIndex": integer, "buckets": [ { object (`ExtendedValue`) } ] }

Các trường

Các trường
`valuesIndex`	`integer` Độ lệch trong danh sách `PivotTable.values` mà các giá trị trong nhóm này phải được sắp xếp theo.
`buckets[]`	`object (ExtendedValue)` Xác định nhóm mà từ đó các giá trị được chọn để sắp xếp. Ví dụ: trong một bảng tổng hợp có một nhóm hàng và hai nhóm cột, nhóm hàng có thể liệt kê tối đa 2 giá trị. Giá trị đầu tiên tương ứng với giá trị trong nhóm cột đầu tiên và giá trị thứ hai tương ứng với giá trị trong nhóm cột thứ hai. Nếu không có giá trị nào được liệt kê, điều này có nghĩa là hàng cần được sắp xếp theo "Tổng cộng" trên các nhóm cột. Nếu một giá trị được liệt kê, điều này sẽ tương ứng với việc sử dụng "Tổng" của nhóm đó.

valuesIndex

integer

Độ lệch trong danh sách PivotTable.values mà các giá trị trong nhóm này phải được sắp xếp theo.

buckets[]

object (ExtendedValue)

Xác định nhóm mà từ đó các giá trị được chọn để sắp xếp.

Ví dụ: trong một bảng tổng hợp có một nhóm hàng và hai nhóm cột, nhóm hàng có thể liệt kê tối đa 2 giá trị. Giá trị đầu tiên tương ứng với giá trị trong nhóm cột đầu tiên và giá trị thứ hai tương ứng với giá trị trong nhóm cột thứ hai. Nếu không có giá trị nào được liệt kê, điều này có nghĩa là hàng cần được sắp xếp theo "Tổng cộng" trên các nhóm cột. Nếu một giá trị được liệt kê, điều này sẽ tương ứng với việc sử dụng "Tổng" của nhóm đó.

PivotGroupRule

Tuỳ chọn cài đặt không bắt buộc trên PivotGroup xác định các nhóm cho giá trị trong cột dữ liệu nguồn thay vì chia nhỏ từng giá trị riêng lẻ. Chỉ có thể thêm một PivotGroup với quy tắc nhóm cho mỗi cột trong dữ liệu nguồn. Tuy nhiên, trên bất kỳ cột nào, bạn có thể thêm cả PivotGroup có quy tắc và PivotGroup không chứa quy tắc này.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng 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`. }

{

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

Các trường
Trường nhóm `rule`. Quy tắc áp dụng cho `PivotGroup`. `rule` chỉ có thể là một trong những loại sau đây:
`manualRule`	`object (ManualRule)` `ManualRule`.
`histogramRule`	`object (HistogramRule)` `HistogramRule`.
`dateTimeRule`	`object (DateTimeRule)` `DateTimeRule`.

Quy tắc thủ công

Cho phép bạn tự sắp xếp các giá trị trong cột dữ liệu nguồn thành các nhóm có tên mà bạn chọn. Ví dụ: một bảng tổng hợp tập hợp dân số theo trạng thái:

+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK    |               0.7 |
| AL    |               4.8 |
| AR    |               2.9 |
...
+-------+-------------------+

có thể được biến thành bảng tổng hợp tập hợp dân số theo múi giờ bằng cách cung cấp danh sách nhóm (ví dụ: groupName = 'Trung tâm', mục = ['AL', 'AR', 'IA', ...]) cho quy tắc nhóm thủ công. Lưu ý rằng bạn có thể đạt được hiệu ứng tương tự bằng cách thêm cột múi giờ vào dữ liệu nguồn và điều chỉnh bảng tổng hợp.

+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central   |             106.3 |
| Eastern   |             151.9 |
| Mountain  |              17.4 |
...
+-----------+-------------------+

Biểu diễn dưới dạng JSON
{ "groups": [ { object (`ManualRuleGroup`) } ] }

Các trường

Các trường
`groups[]`	`object (ManualRuleGroup)` Danh sách tên nhóm và các mục tương ứng từ dữ liệu nguồn liên kết đến từng tên nhóm.

groups[]

object (ManualRuleGroup)

Danh sách tên nhóm và các mục tương ứng từ dữ liệu nguồn liên kết đến từng tên nhóm.

Nhóm quy tắc thủ công

Tên nhóm và danh sách các mục từ dữ liệu nguồn phải được đặt trong nhóm có tên này.

Biểu diễn dưới dạng JSON
{ "groupName": { object (`ExtendedValue`) }, "items": [ { object (`ExtendedValue`) } ] }

Các trường

Các trường
`groupName`	`object (ExtendedValue)` Tên nhóm phải là một chuỗi. Mỗi nhóm trong một `ManualRule` nhất định phải có một tên nhóm riêng biệt.
`items[]`	`object (ExtendedValue)` Các mục trong dữ liệu nguồn phải được đặt vào nhóm này. Mỗi mục có thể là một chuỗi, số hoặc boolean. Các mục có thể xuất hiện trong tối đa một nhóm trong một `ManualRule` nhất định. Các mục không xuất hiện trong bất kỳ nhóm nào sẽ tự xuất hiện.

groupName

object (ExtendedValue)

Tên nhóm phải là một chuỗi. Mỗi nhóm trong một ManualRule nhất định phải có một tên nhóm riêng biệt.

items[]

object (ExtendedValue)

Các mục trong dữ liệu nguồn phải được đặt vào nhóm này. Mỗi mục có thể là một chuỗi, số hoặc boolean. Các mục có thể xuất hiện trong tối đa một nhóm trong một ManualRule nhất định. Các mục không xuất hiện trong bất kỳ nhóm nào sẽ tự xuất hiện.

Quy tắc biểu đồ

Cho phép bạn sắp xếp các giá trị số trong cột dữ liệu nguồn thành các nhóm có kích thước không đổi. Tất cả giá trị từ HistogramRule.start đến HistogramRule.end đều được đặt vào các nhóm có kích thước HistogramRule.interval. Ngoài ra, tất cả các giá trị dưới HistogramRule.start được đặt trong một nhóm và tất cả giá trị trên HistogramRule.end được đặt trong một nhóm khác. Chỉ yêu cầu HistogramRule.interval, mặc dù nếu cả HistogramRule.start và HistogramRule.end đều được cung cấp thì HistogramRule.start phải nhỏ hơn HistogramRule.end. Ví dụ: một bảng tổng hợp hiển thị số tiền mua hàng trung bình theo độ tuổi có hơn 50 hàng:

+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16  |            $27.13 |
| 17  |             $5.24 |
| 18  |            $20.15 |
...
+-----+-------------------+

có thể được chuyển thành một bảng tổng hợp trông giống như bảng dưới đây bằng cách áp dụng quy tắc nhóm biểu đồ có HistogramRule.start là 25, HistogramRule.interval là 20 và HistogramRule.end là 65.

+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25        |            $19.34 |
| 25-45       |            $31.43 |
| 45-65       |            $35.87 |
| > 65        |            $27.55 |
+-------------+-------------------+
| Grand Total |            $29.12 |
+-------------+-------------------+

Biểu diễn dưới dạng JSON
{ "interval": number, "start": number, "end": number }

Các trường

Các trường
`interval`	`number` Kích thước của nhóm được tạo. Phải dương.
`start`	`number` Giá trị tối thiểu mà tại đó các mục được đặt trong bộ chứa có kích thước không đổi. Các giá trị bên dưới phần bắt đầu được gộp chung vào một bộ chứa. Trường này là tùy chọn.
`end`	`number` Giá trị tối đa mà tại đó các mục được đặt trong bộ chứa có kích thước không đổi. Các giá trị ở trên được kết hợp thành một nhóm. Trường này là tùy chọn.

interval

number

Kích thước của nhóm được tạo. Phải dương.

start

number

Giá trị tối thiểu mà tại đó các mục được đặt trong bộ chứa có kích thước không đổi. Các giá trị bên dưới phần bắt đầu được gộp chung vào một bộ chứa. Trường này là tùy chọn.

end

number

Giá trị tối đa mà tại đó các mục được đặt trong bộ chứa có kích thước không đổi. Các giá trị ở trên được kết hợp thành một nhóm. Trường này là tùy chọn.

Quy tắc ngày giờ

Cho phép bạn sắp xếp các giá trị ngày-giờ trong cột dữ liệu nguồn thành các nhóm dựa trên những phần được chọn của giá trị ngày hoặc giờ của chúng. Ví dụ: hãy xem xét một bảng tổng hợp hiển thị các giao dịch bán hàng theo ngày:

+----------+--------------+
| Date     | SUM of Sales |
+----------+--------------+
| 1/1/2017 |      $621.14 |
| 2/3/2017 |      $708.84 |
| 5/8/2017 |      $326.84 |
...
+----------+--------------+

Áp dụng quy tắc nhóm ngày giờ với kết quả DateTimeRuleType trong YEAR_MONTH trong bảng tổng hợp sau.

+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan     |   $53,731.78 |
| 2017-Feb     |   $83,475.32 |
| 2017-Mar     |   $94,385.05 |
...
+--------------+--------------+

Biểu diễn dưới dạng JSON
{ "type": enum (`DateTimeRuleType`) }

Các trường

Các trường
`type`	`enum (DateTimeRuleType)` Loại nhóm ngày giờ sẽ áp dụng.

type

enum (DateTimeRuleType)

Loại nhóm ngày giờ sẽ áp dụng.

Loại quy tắc ngày giờ

Các loại quy tắc nhóm ngày-giờ có sẵn. Tài liệu này giả định ngôn ngữ của bảng tính là "en-US", mặc dù việc hiển thị thực tế ngày và giờ sử dụng ngôn ngữ của bảng tính cho một số loại quy tắc.

Enum
`DATE_TIME_RULE_TYPE_UNSPECIFIED`	Loại mặc định, không sử dụng.
`SECOND`	Nhóm các ngày theo thứ tự từ 0 đến 59.
`MINUTE`	Nhóm ngày theo phút, từ 0 đến 59.
`HOUR`	Nhóm theo ngày bằng cách sử dụng hệ thống 24 giờ, từ 0 đến 23.
`HOUR_MINUTE`	Nhóm ngày theo giờ và phút sử dụng hệ thống 24 giờ, ví dụ: 19:45.
`HOUR_MINUTE_AMPM`	Nhóm ngày theo giờ và phút sử dụng hệ thống 12 giờ, ví dụ: 7:45 tối. Ký hiệu AM/PM được dịch dựa trên ngôn ngữ của bảng tính.
`DAY_OF_WEEK`	Nhóm các ngày theo tuần, ví dụ: Chủ Nhật. Các ngày trong tuần sẽ được dịch dựa trên ngôn ngữ của bảng tính.
`DAY_OF_YEAR`	Nhóm theo ngày trong năm, từ 1 đến 366. Lưu ý rằng các ngày sau ngày 29 tháng 2 rơi vào các nhóm khác nhau vào các năm nhuận so với các năm không nhuận.
`DAY_OF_MONTH`	Nhóm ngày theo ngày trong tháng, từ 1 đến 31.
`DAY_MONTH`	Nhóm theo ngày và tháng, ví dụ: 22-11. Tháng được dịch dựa trên ngôn ngữ của bảng tính.
`MONTH`	Nhóm ngày theo tháng, ví dụ: tháng 11. Tháng được dịch dựa trên ngôn ngữ của bảng tính.
`QUARTER`	Nhóm ngày theo quý, ví dụ: Q1 (đại diện cho tháng 1-tháng 3).
`YEAR`	Nhóm ngày theo năm, ví dụ: 2008.
`YEAR_MONTH`	Nhóm ngày theo năm và tháng, ví dụ: 2008-Tháng 11. Tháng được dịch dựa trên ngôn ngữ của bảng tính.
`YEAR_QUARTER`	Nhóm ngày theo năm và quý, ví dụ như Q4 năm 2008.
`YEAR_MONTH_DAY`	Nhóm ngày theo năm, tháng và ngày, ví dụ: 2008-11-22.

PivotGroupLimit

Giới hạn số lượng trên hàng hoặc cột trong nhóm bảng tổng hợp.

Biểu diễn dưới dạng JSON
{ "countLimit": integer, "applyOrder": integer }

Các trường

Các trường
`countLimit`	`integer` Giới hạn số lượng.
`applyOrder`	`integer` Thứ tự áp dụng giới hạn nhóm cho bảng tổng hợp. Giới hạn nhóm bảng tổng hợp được áp dụng từ số đơn đặt hàng thấp hơn đến cao hơn. Số đơn đặt hàng được chuẩn hóa thành số nguyên liên tiếp từ 0. Đối với yêu cầu ghi, để tùy chỉnh đầy đủ các đơn đặt hàng áp dụng, tất cả giới hạn nhóm bảng tổng hợp phải đặt một trường duy nhất cho trường này. Nếu không, thứ tự sẽ được xác định theo chỉ mục trong danh sách `PivotTable.rows`, sau đó đến danh sách `PivotTable.columns`.

countLimit

integer

Giới hạn số lượng.

applyOrder

integer

Thứ tự áp dụng giới hạn nhóm cho bảng tổng hợp.

Giới hạn nhóm bảng tổng hợp được áp dụng từ số đơn đặt hàng thấp hơn đến cao hơn. Số đơn đặt hàng được chuẩn hóa thành số nguyên liên tiếp từ 0.

Đối với yêu cầu ghi, để tùy chỉnh đầy đủ các đơn đặt hàng áp dụng, tất cả giới hạn nhóm bảng tổng hợp phải đặt một trường duy nhất cho trường này. Nếu không, thứ tự sẽ được xác định theo chỉ mục trong danh sách PivotTable.rows, sau đó đến danh sách PivotTable.columns.

Tiêu chí bộ lọc tổng hợp

Tiêu chí hiển thị/ẩn hàng trong bảng tổng hợp.

Biểu diễn dưới dạng JSON
{ "visibleValues": [ string ], "condition": { object (`BooleanCondition`) }, "visibleByDefault": boolean }

Các trường

Các trường
`visibleValues[]`	`string` Các giá trị nên được bao gồm. Các giá trị không được liệt kê ở đây đều bị loại trừ.
`condition`	`object (BooleanCondition)` Điều kiện phải đúng thì giá trị mới hiển thị. ( `visibleValues` không ghi đè thông tin này – ngay cả khi một giá trị được liệt kê ở đó, giá trị đó vẫn bị ẩn nếu không đáp ứng điều kiện.) Các giá trị điều kiện tham chiếu đến dải ô trong chú thích A1 được đánh giá tương ứng với trang tính bảng tổng hợp. Tệp đối chiếu được xử lý tuyệt đối nên không được điền vào bảng tổng hợp. Ví dụ: Giá trị điều kiện của `=A1` trên "Bảng tổng hợp 1" sẽ được coi là `'Pivot Table 1'!$A$1`. Dữ liệu nguồn của bảng tổng hợp có thể được tham chiếu theo tên tiêu đề cột. Ví dụ: nếu dữ liệu nguồn có các cột tên là "Doanh thu" và "Chi phí" và một điều kiện áp dụng cho cột "Doanh thu" với loại `NUMBER_GREATER` và giá trị `=Cost`, thì chỉ các cột mới có "Doanh thu" > "Chi phí".
`visibleByDefault`	`boolean` Liệu các giá trị có hiển thị theo mặc định hay không. Nếu đúng, `visibleValues` sẽ bị bỏ qua và tất cả giá trị đáp ứng `condition` (nếu được chỉ định) đều sẽ hiển thị. Nếu đặt là false, các giá trị thuộc cả `visibleValues` và `condition` đều sẽ xuất hiện.

visibleValues[]

string

Các giá trị nên được bao gồm. Các giá trị không được liệt kê ở đây đều bị loại trừ.

condition

object (BooleanCondition)

Điều kiện phải đúng thì giá trị mới hiển thị. ( visibleValues không ghi đè thông tin này – ngay cả khi một giá trị được liệt kê ở đó, giá trị đó vẫn bị ẩn nếu không đáp ứng điều kiện.)

Các giá trị điều kiện tham chiếu đến dải ô trong chú thích A1 được đánh giá tương ứng với trang tính bảng tổng hợp. Tệp đối chiếu được xử lý tuyệt đối nên không được điền vào bảng tổng hợp. Ví dụ: Giá trị điều kiện của =A1 trên "Bảng tổng hợp 1" sẽ được coi là 'Pivot Table 1'!$A$1.

Dữ liệu nguồn của bảng tổng hợp có thể được tham chiếu theo tên tiêu đề cột. Ví dụ: nếu dữ liệu nguồn có các cột tên là "Doanh thu" và "Chi phí" và một điều kiện áp dụng cho cột "Doanh thu" với loại NUMBER_GREATER và giá trị =Cost, thì chỉ các cột mới có "Doanh thu" > "Chi phí".

visibleByDefault

boolean

Liệu các giá trị có hiển thị theo mặc định hay không. Nếu đúng, visibleValues sẽ bị bỏ qua và tất cả giá trị đáp ứng condition (nếu được chỉ định) đều sẽ hiển thị. Nếu đặt là false, các giá trị thuộc cả visibleValues và condition đều sẽ xuất hiện.

Bảng tổng hợp

Tiêu chí lọc bảng tổng hợp liên quan đến độ lệch cột nguồn cụ thể.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng 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`. }

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

Các trường
`filterCriteria`	`object (PivotFilterCriteria)` Tiêu chí cho cột.
Trường nhóm `source`. Cột nguồn mà bộ lọc này áp dụng. `source` chỉ có thể là một trong những loại sau đây:
`columnOffsetIndex`	`integer` Độ lệch cột 0 của dải ô nguồn.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` Tham chiếu đến cột nguồn dữ liệu.

Giá trị tổng hợp

Định nghĩa cách tính giá trị trong bảng tổng hợp.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng 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`. }

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

Các trường
`summarizeFunction`	`enum (PivotValueSummarizeFunction)` Hàm tóm tắt giá trị. Nếu bạn đặt `formula`, các giá trị duy nhất được hỗ trợ là `SUM` và `CUSTOM`. Nếu bạn đặt `sourceColumnOffset`, thì `CUSTOM` sẽ không được hỗ trợ.
`name`	`string` Tên để sử dụng cho giá trị.
`calculatedDisplayType`	`enum (PivotValueCalculatedDisplayType)` Nếu được chỉ định, chỉ ra rằng các giá trị tổng hợp sẽ được hiển thị là kết quả của phép tính có giá trị tổng hợp khác. Ví dụ: nếu tính toán DisplayDisplayType được chỉ định là PERCENT_OF_GRAND_TOTAL, tất cả giá trị tổng hợp được hiển thị dưới dạng phần trăm của tổng. Trong trình chỉnh sửa Trang tính, đây được gọi là "Hiển thị dưới dạng" trong mục giá trị của bảng tổng hợp.
Trường nhóm `value`. Dữ liệu cần sử dụng cho các giá trị trong bảng tổng hợp. Phải đặt chính xác một giá trị. `value` chỉ có thể là một trong những loại sau đây:
`sourceColumnOffset`	`integer` Độ lệch cột của dải ô nguồn mà giá trị này được đọc. Ví dụ: nếu nguồn là `C10:E15`, `sourceColumnOffset` là `0` có nghĩa là giá trị này tham chiếu đến cột `C`, trong khi độ lệch `1` là cột `D`.
`formula`	`string` Công thức tùy chỉnh để tính toán giá trị. Công thức phải bắt đầu bằng một ký tự `=`.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` Tham chiếu đến cột nguồn dữ liệu mà giá trị này đọc.

Hàm PivotValueSummary

Hàm tóm tắt giá trị tổng hợp.

Enum
`PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED`	Không sử dụng mặc định.
`SUM`	Tương ứng với hàm `SUM`.
`COUNTA`	Tương ứng với hàm `COUNTA`.
`COUNT`	Tương ứng với hàm `COUNT`.
`COUNTUNIQUE`	Tương ứng với hàm `COUNTUNIQUE`.
`AVERAGE`	Tương ứng với hàm `AVERAGE`.
`MAX`	Tương ứng với hàm `MAX`.
`MIN`	Tương ứng với hàm `MIN`.
`MEDIAN`	Tương ứng với hàm `MEDIAN`.
`PRODUCT`	Tương ứng với hàm `PRODUCT`.
`STDEV`	Tương ứng với hàm `STDEV`.
`STDEVP`	Tương ứng với hàm `STDEVP`.
`VAR`	Tương ứng với hàm `VAR`.
`VARP`	Tương ứng với hàm `VARP`.
`CUSTOM`	Cho biết công thức nên được sử dụng nguyên trạng. Chỉ hợp lệ nếu bạn đã đặt `PivotValue.formula`.

PivotValueCalculatedDisplayType

Các cách xoay vòng giá trị tổng hợp có thể được hiển thị.

Enum
`PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED`	Giá trị mặc định, không sử dụng.
`PERCENT_OF_ROW_TOTAL`	Hiển thị giá trị tổng hợp dưới dạng phần trăm của tổng giá trị hàng.
`PERCENT_OF_COLUMN_TOTAL`	Hiển thị giá trị tổng hợp theo tỷ lệ phần trăm của tổng giá trị cột.
`PERCENT_OF_GRAND_TOTAL`	Hiển thị giá trị tổng hợp dưới dạng phần trăm của tổng giá trị lớn.

Giá trị tổng hợp

Bố cục của các giá trị tổng hợp.

Enum
`HORIZONTAL`	Giá trị được sắp xếp theo chiều ngang (dưới dạng cột).
`VERTICAL`	Giá trị được sắp xếp theo chiều dọc (dưới dạng hàng).