PivotTable
Một bảng tổng hợp.
Biểu diễn dưới dạng JSON |
---|
{ "rows": [ { object ( |
Trường | |
---|---|
rows[]
|
Mỗi nhóm hàng trong bảng tổng hợp. |
columns[]
|
Mỗi nhóm cột trong bảng tổng hợp. |
criteria
|
Không bắt buộc liên kết các bộ lọc trên mỗi độ lệch 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. Khoá 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ị này là tiêu chí cho cột đó.
Ví dụ: nếu nguồn là
Trường này đã ngừng hoạt động và được thay thế bằng |
filterSpecs[]
|
Các bộ lọc được áp dụng cho các cột nguồn trước khi tổng hợp dữ liệu cho bảng tổng hợp.
Cả |
values[]
|
Danh sách các giá trị để đưa vào bảng tổng hợp. |
valueLayout
|
Liệu các giá trị sẽ được liệt kê theo chiều ngang (dưới dạng cột) hay chiều dọc (dưới dạng hàng). |
dataExecutionStatus
|
Chỉ có đầu ra. Trạng thái thực thi dữ liệu cho bảng tổng hợp của nguồn dữ liệu. |
Trường hợp source_data . Nguồn của dữ liệu bảng tổng hợp.
source_data chỉ có thể là một trong các trạng thái sau:
|
|
source
|
Dải ô mà bảng tổng hợp đang đọc dữ liệu. |
dataSourceId
|
Mã của nguồn dữ liệu mà bảng tổng hợp đang đọc dữ liệu. |
PivotGroup
Một nhóm (hàng hoặc cột) trong bảng tổng hợp.
Biểu diễn dưới dạng JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
Trường | |
---|---|
showTotals
|
Đúng nếu bảng tổng hợp phải bao gồm tổng số cho nhóm này. |
valueMetadata[]
|
Siêu dữ liệu về các giá trị trong nhóm. |
sortOrder
|
Thứ tự sắp xếp các giá trị trong nhóm này. |
valueBucket
|
Bộ chứa của nhóm bảng tổng hợp đối diện cần sắp xếp. Nếu không được chỉ định, sắp xếp sẽ được sắp xếp theo thứ tự bảng chữ cái theo giá trị của nhóm này. |
repeatHeadings
|
Đú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ác cột bỏ qua. Theo mặc định, chúng tôi giảm thiểu việc lặp lại tiêu đề bằng cách không hiển thị các tiêu đề có cấp cao hơn khi chúng giống nhau. Ví dụ: mặc dù hàng thứ ba bên dưới tương ứng với "Quý 1 tháng 3", nhưng "Q1" không hiển thị vì thừa với các hàng trước. Nếu Lặp lại tiêu đề thành true sẽ lặp lại "Q1" cho "Tháng 2" và "Tháng 3".
|
label
|
Các nhãn để sử dụng cho các nhóm hàng/cột có thể tuỳ chỉnh được. Ví dụ: trong bảng tổng hợp sau đây, nhãn hàng là
|
groupRule
|
Quy tắc nhóm để áp dụng cho nhóm hàng/cột này. |
groupLimit
|
Giới hạn số lượng trên các hàng hoặc cột áp dụng cho nhóm tổng hợp này. |
Trường hợp source . Nguồn dữ liệu của nhóm tổng hợp.
source chỉ có thể là một trong các trạng thái sau:
|
|
sourceColumnOffset
|
Độ lệch cột của dải ô nguồn mà nhóm này dựa trên.
Ví dụ: nếu nguồn là |
dataSourceColumnReference
|
Tham chiếu đến cột nguồn dữ liệu mà nhóm này dựa trên. |
PivotGroupValueMetadata
Siêu dữ liệu về một giá trị trong nhóm tổng hợp.
Biểu diễn dưới dạng JSON |
---|
{
"value": {
object (
|
Trường | |
---|---|
value
|
Giá trị đã tính toán tương ứng với siêu dữ liệu. (Xin lưu ý rằng |
collapsed
|
Đúng nếu dữ liệu tương ứng với giá trị bị thu gọn. |
PivotGroupSortValueBucket
Thông tin về các 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 (
|
Trường | |
---|---|
valuesIndex
|
Độ lệch trong danh sách
|
buckets[]
|
Xác định nhóm giá trị được chọn để sắp xếp. Ví dụ: trong 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 một giá trị trong nhóm cột đầu tiên và giá trị thứ hai tương ứng với một 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 cho biết rằng 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ê thì giá trị này sẽ tương ứng với việc sử dụng "Tổng" của nhóm đó. |
PivotGroupRule
Chế độ cài đặt không bắt buộc trên PivotGroup
giúp xác định các nhóm cho các giá trị trong cột dữ liệu nguồn thay vì chia nhỏ từng giá trị riêng lẻ. Bạn chỉ có thể thêm một PivotGroup
có quy tắc nhóm cho từng cột trong dữ liệu nguồn. Tuy nhiên, trên một cột nhất định bất kỳ, bạn có thể thêm cả PivotGroup
có quy tắc và PivotGroup
không có quy tắc đó.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp rule . Quy tắc áp dụng cho PivotGroup .
rule chỉ có thể là một trong các trạng thái sau:
|
|
manualRule
|
|
histogramRule
|
|
dateTimeRule
|
|
ManualRule
Cho phép bạn sắp xếp các giá trị trong cột dữ liệu nguồn theo cách thủ công thành các nhóm theo tên bạn chọn. Ví dụ: một bảng tổng hợp tổng 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 chuyển thành bảng tổng hợp tổng hợp dữ liệu theo múi giờ bằng cách cung cấp một danh sách các nhóm (ví dụ: groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) cho quy tắc nhóm thủ công. Lưu ý rằng có thể đạt được hiệu quả 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 (
|
Trường | |
---|---|
groups[]
|
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 với từng tên nhóm. |
ManualRuleGroup
Tên nhóm và danh sách các mục từ dữ liệu nguồn sẽ được đặt trong nhóm bằng tên này.
Biểu diễn dưới dạng JSON |
---|
{ "groupName": { object ( |
Trường | |
---|---|
groupName
|
Tên nhóm (phải ở dạng chuỗi). Mỗi nhóm trong một |
items[]
|
Các mục trong dữ liệu nguồn cần đượ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 |
HistogramRule
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ả các giá trị từ
HistogramRule.start
đến
HistogramRule.end
được đặt vào các nhóm có kích thước
HistogramRule.interval
. Ngoài ra, mọi giá trị bên dưới HistogramRule.start
sẽ được đặt vào một nhóm và tất cả các giá trị trên HistogramRule.end
sẽ được đặt vào một nhóm khác. Bạn chỉ bắt buộc phải cung cấp 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 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 bảng tổng hợp giống như bảng dưới đây bằng cách áp dụng quy tắc nhóm biểu đồ với 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 } |
Trường | |
---|---|
interval
|
Kích thước của các nhóm được tạo. Phải dương. |
start
|
Giá trị nhỏ nhất mà các mục được đặt vào các nhóm có kích thước không đổi. Các giá trị bên dưới bắt đầu được gộp vào một nhóm. Trường này là không bắt buộc. |
end
|
Giá trị lớn nhất mà các mục được đặt vào các nhóm có kích thước không đổi. Các giá trị vượt quá giá trị cuối cùng được gộp lại vào một nhóm duy nhất. Trường này là không bắt buộc. |
DateTimeRule
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 các phần đã chọn của giá trị ngày hoặc giờ. 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ờ có
DateTimeRuleType
là YEAR_MONTH sẽ dẫn đến bảng tổng hợp sau đây.
+--------------+--------------+
| 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 (
|
Trường | |
---|---|
type
|
Loại nhóm ngày-giờ sẽ áp dụng. |
DateTimeRuleType
Các loại quy tắc nhóm ngày giờ hiện có. Tài liệu này giả định ngôn ngữ của bảng tính là "en-US", mặc dù ngày và giờ hiển thị thực tế lại sử dụng ngôn ngữ trên bảng tính đối với 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 ngày theo giây, từ 0 đến 59. |
MINUTE
|
Nhóm ngày theo phút, từ 0 đến 59. |
HOUR
|
Nhóm ngày theo giờ bằng hệ thống 24 giờ, từ 0 đến 23. |
HOUR_MINUTE
|
Nhóm ngày theo giờ và phút bằng hệ thống 24 giờ, ví dụ: 19:45. |
HOUR_MINUTE_AMPM
|
Nhóm ngày theo giờ và phút bằng hệ thống 12 giờ, ví dụ: 7:45 tối. Chỉ định AM/PM được dịch dựa trên ngôn ngữ của bảng tính. |
DAY_OF_WEEK
|
Nhóm ngày theo ngày trong tuần, ví dụ như 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 ngày theo ngày trong năm, từ 1 đến 366. Xin lưu ý rằng ngày sau ngày 29 tháng 2 rơi vào các nhóm năm nhuận khác với 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 ngày theo ngày và tháng, ví dụ: từ ngày 22 đến tháng 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ụ như 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ụ: Quý 1 (đại diện cho tháng 1 đến 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ụ: Quý 4 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 các hàng hoặc cột trong nhóm tổng hợp.
Biểu diễn dưới dạng JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
Trường | |
---|---|
countLimit
|
Giới hạn số lượng. |
applyOrder
|
Thứ tự áp dụng giới hạn về nhóm cho bảng tổng hợp. Giới hạn đối với nhóm tổng hợp được áp dụng từ số đơn đặt hàng thấp hơn đến số cao hơn. Số đơn đặt hàng được chuẩn hoá thành số nguyên liên tiếp từ 0.
Đối với yêu cầu ghi, để tuỳ chỉnh đầy đủ các đơn đặt hàng đang áp dụng, tất cả giới hạn của nhóm tổng hợp phải đặt trường này bằng một số duy nhất. Nếu không, thứ tự sẽ được xác định theo chỉ mục trong danh sách |
PivotFilterCriteria
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 (
|
Trường | |
---|---|
visibleValues[]
|
Các giá trị cần đưa vào. Các giá trị không được liệt kê ở đây sẽ bị loại trừ. |
condition
|
Điều kiện phải đúng thì các giá trị mới xuất hiện. (
Giá trị điều kiện tham chiếu đến các dải ô trong ký hiệu A1 được đánh giá tương ứng với trang tính trong bảng tổng hợp. Tệp đối chiếu được xử lý tuyệt đối, do đó không được điền xuống bảng tổng hợp. Ví dụ: giá trị điều kiện là
Bạn có thể tham chiếu dữ liệu nguồn của bảng tổng hợp 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à có một điều kiện được áp dụng cho cột "Doanh thu" thuộc loại
|
visibleByDefault
|
Liệu các giá trị có hiển thị theo mặc định hay không. Nếu đúng, |
PivotFilterSpec
Tiêu chí lọc bảng tổng hợp liên kết với một độ lệch của cột nguồn cụ thể.
Biểu diễn dưới dạng JSON |
---|
{ "filterCriteria": { object ( |
Trường | |
---|---|
filterCriteria
|
Tiêu chí cho cột. |
Trường hợp source . Cột nguồn mà bộ lọc này áp dụng.
source chỉ có thể là một trong các trạng thái sau:
|
|
columnOffsetIndex
|
Độ lệch cột dựa trên 0 của dải ô nguồn. |
dataSourceColumnReference
|
Tham chiếu đến cột nguồn dữ liệu. |
PivotValue
Định nghĩa về cách tính giá trị trong bảng tổng hợp.
Biểu diễn dưới dạng JSON |
---|
{ "summarizeFunction": enum ( |
Trường | |
---|---|
summarizeFunction
|
Một hàm để tóm tắt giá trị. Nếu bạn đặt |
name
|
Tên để sử dụng cho giá trị. |
calculatedDisplayType
|
Nếu được chỉ định, hãy cho biết rằng các giá trị tổng hợp sẽ hiển thị dưới dạng kết quả tính toán với một giá trị tổng hợp khác. Ví dụ: nếu được TÍNHDisplayType được chỉ định là PERCENT_OF_GRAND_TOTAL, tất cả các giá trị tổng hợp được hiển thị dưới dạng phần trăm của tổng số tổng. Trong trình chỉnh sửa Trang tính, hàm này được gọi là "Hiển thị dưới dạng" trong phần giá trị của bảng tổng hợp. |
Trường hợp value . Dữ liệu cần sử dụng cho các giá trị trong bảng tổng hợp. Bạn phải đặt đúng một giá trị.
value chỉ có thể là một trong các trạng thái sau:
|
|
sourceColumnOffset
|
Độ lệch cột của dải ô nguồn chứa giá trị này.
Ví dụ: nếu nguồn là |
formula
|
Một công thức tuỳ chỉnh để tính toán giá trị. Công thức phải bắt đầu bằng một ký tự |
dataSourceColumnReference
|
Tham chiếu đến cột nguồn dữ liệu mà giá trị này đọc. |
PivotValueSummarizeFunction
Một hàm để tóm tắt giá trị tổng hợp.
Enum | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
Mặc định là không sử dụng. |
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 phải được sử dụng nguyên trạng. Chỉ hợp lệ nếu bạn đặt PivotValue.formula .
|
NONE
|
Cho biết giá trị đã được tóm tắt và hàm tóm tắt không được chỉ định rõ ràng. Dùng cho bảng tổng hợp nguồn dữ liệu Looker, nơi giá trị đã được tóm tắt. |
PivotValueCalculatedDisplayType
Các cách có thể áp dụng để tính toán giá trị tổng hợp để 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ị các 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ị các giá trị tổng hợp dưới dạng phần trăm của tổng giá trị cột. |
PERCENT_OF_GRAND_TOTAL
|
Hiển thị các giá trị tổng hợp dưới dạng phần trăm của tổng giá trị tổng. |
PivotValueLayout
Bố cục của các giá trị tổng hợp.
Enum | |
---|---|
HORIZONTAL
|
Giá trị được bố trí 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). |