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
|
Một liên kết không bắt buộc của các bộ lọc theo mỗi mức chênh 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ị là tiêu chí cho cột đó.
Ví dụ: nếu nguồn là
Trường này không còn được dùng nữa mà thay bằng
|
filterSpecs[]
|
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ả hai
|
values[]
|
Danh sách các giá trị để đưa vào bảng tổng hợp. |
valueLayout
|
Liệu các giá trị nên đượ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 nguồn dữ liệu. |
Trường kết hợp
source_data . Nguồn của dữ liệu trong bảng tổng hợp.
source_data chỉ có thể là một trong những loại sau:
|
|
source
|
Dải ô mà bảng tổng hợp đang đọc dữ liệu. |
dataSourceId
|
Mã nhận dạng 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
|
Nhóm đối diện của nhóm tổng hợp để sắp xếp theo. Nếu bạn không chỉ định, các giá trị của nhóm này sẽ được sắp xếp theo thứ tự bảng chữ cái. |
repeatHeadings
|
Đúng nếu tiêu đề trong nhóm tổng hợp này cần đượ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 tiêu đề bằng cách không hiển thị tiêu đề cấp cao hơn tại những vị trí 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", "Quý 1" không được hiển thị vì không cần thiết với các hàng trước đó. Việc đặt repeatTitles thành true sẽ khiến "Q1" được lặp lại cho "Tháng 2" và "Mar".
|
label
|
Các nhãn để sử dụng cho các nhóm hàng/cột có thể được tuỳ chỉnh. 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 hàng hoặc cột áp dụng cho nhóm tổng hợp này. |
Trường kết hợp
source . Nguồn dữ liệu của nhóm bảng tổng hợp.
source
chỉ có thể là một trong các trạng thái sau:
|
|
sourceColumnOffset
|
Độ dời cột của dải ô nguồn mà hoạt động 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 cho nhóm này. |
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 ( |
Trường | |
---|---|
value
|
Giá trị được tính toán mà siêu dữ liệu tương ứng. (Lưu ý rằng
|
collapsed
|
Đúng nếu dữ liệu tương ứng với giá trị được thu gọn. |
PivotGroupSortValueBucket
Thông tin về giá trị nào trong nhóm tổng hợp nên đượ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
|
buckets[]
|
Xác định bộ chứa mà từ đó các 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, thì nhóm hàng có thể liệt kê tối đa hai 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 hàng nê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ị duy nhất được liệt kê, điều này tương ứng với việc sử dụng cột "Tổng" của nhóm đó. |
PivotGroupRule
Một chế độ cài đặt không bắt buộc trên PivotGroup
xác định các bộ chứa cho các giá trị trong cột dữ liệu nguồn thay vì tách riêng từng giá trị. Bạn chỉ có thể thêm một PivotGroup
có quy tắc nhóm cho mỗi cột trong dữ liệu nguồn, mặc dù trên bất kỳ cột nào, bạn cũng 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 hợp nhất
rule . Quy tắc để áp dụng cho
PivotGroup .
rule chỉ có thể là một trong những loại sau:
|
|
manualRule
|
Một |
histogramRule
|
Đáp
|
dateTimeRule
|
Một |
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 có tên do bạn chọn. Ví dụ: bảng tổng hợp tổng hợp dân số theo tiểu bang:
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
có thể chuyển thành bảng tổng hợp tổng hợp dân số theo múi giờ bằng cách cung cấp danh sách các nhóm (ví dụ: groupName = 'Trung', các mục = ['AL', 'AR', 'IA', ...]) cho một quy tắc nhóm thủ công. Xin lưu ý rằng bạn 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 trong dữ liệu nguồn ánh xạ đến từng tên nhóm. |
ManualRuleGroup
Tên nhóm và danh sách các mục trong dữ liệu nguồn nên được đặt trong nhóm có tên này.
Biểu diễn dưới dạng JSON |
---|
{ "groupName": { object ( |
Trường | |
---|---|
groupName
|
Tên nhóm, phải là một 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 nhóm nhất định
|
HistogramRule
Cho phép bạn sắp xếp các giá trị số trong một 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
đượ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
sẽ được đặt trong một nhóm và tất cả các giá trị trên HistogramRule.end
sẽ được đặt trong một nhóm khác. Chỉ cần HistogramRule.interval
, mặc dù nếu bạn cung cấp cả HistogramRule.start
và HistogramRule.end
, thì HistogramRule.start
phải nhỏ hơn HistogramRule.end
. Ví dụ: một bảng tổng hợp cho thấy 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 bên dưới bằng cách áp dụng quy tắc nhóm biểu đồ với một
HistogramRule.start
trên 25, một
HistogramRule.interval
là 20 và một
HistogramRule.end
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 bộ chứa được tạo. Phải là số dương. |
start
|
Giá trị tối thiểu mà tại đó các mục được đặt vào các nhóm có kích thước không đổi. Các giá trị dưới giá trị 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ị tối đa mà các mục được đặt vào các bộ chứa có kích thước không đổi. Các giá trị ở trên được gộp chung 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 giá trị ngày giờ trong một cột dữ liệu nguồn thành các nhóm dựa trên phần được chọn của giá trị ngày hoặc giờ tương ứng. Ví dụ: hãy xem xét một bảng tổng hợp cho thấy 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 |
...
+----------+--------------+
Việc áp dụng quy tắc nhóm ngày-giờ với DateTimeRuleType
là YEAR_MONTH sẽ tạo ra 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 ( |
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ữ trong bảng tính là "en-US", mặc dù cách hiển thị ngày và giờ trên thực tế sử dụng ngôn ngữ của 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. Ký hiệu AM/PM được dịch dựa trên ngôn ngữ trong bảng tính. |
DAY_OF_WEEK
|
Nhóm ngày theo ngày trong tuần, ví dụ như Chủ Nhật. 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 các ngày sau ngày 29 tháng 2 sẽ thuộc các nhóm khác nhau trong năm nhuận so 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ụ: 22-Th11. 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ữ trong 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ụ: từ tháng 11 năm 2008 đến 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à theo 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 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 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ố thứ tự thấp hơn đến số thứ tự cao hơn. Số thứ tự đượ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 nhóm bảng 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/ẩ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 được đưa vào. Những giá trị không có trong danh sách này sẽ bị loại trừ. |
condition
|
Một điều kiện phải đúng để các giá trị hiển thị. (
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. Các tệp tham chiếu được xử lý tuyệt đối nên không được điền xuống bảng tổng hợp. Ví dụ: giá trị điều kiện của
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ột có tên là "Doanh thu" và "Chi phí" và một điều kiện được áp dụng cho "Doanh thu" cột 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 của bảng tổng hợp được liên kết với một mức chênh lệch 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 kết hợp
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:
|
|
columnOffsetIndex
|
Độ dời 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 một giá trị trong bảng tổng hợp.
Biểu diễn dưới dạng JSON |
---|
{ "summarizeFunction": enum ( |
Trường | |
---|---|
summarizeFunction
|
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 phải được hiển thị dưới dạng kết quả của phép tính với một giá trị tổng hợp khác. Ví dụ: nếu bạn chỉ định calculatedDisplayType là PERCENT_OF_GRAND_TOTAL, thì tất cả các giá trị trong bảng tổng hợp sẽ hiển thị dưới dạng tỷ lệ phần trăm của tổng. Trong trình chỉnh sửa Trang tính, mục 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 kết 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 những loại sau:
|
|
sourceColumnOffset
|
Độ lệch cột của dải ô nguồn mà giá trị này đọc từ đó.
Ví dụ: nếu nguồn là
|
formula
|
Công thức tuỳ chỉnh để tính giá trị. Công thức phải bắt đầu bằng ký tự |
dataSourceColumnReference
|
Tham chiếu đến cột nguồn dữ liệu mà giá trị này đọc từ đó. |
PivotValueSummarizeFunction
Một hàm dùng để tóm tắt giá trị tổng hợp.
Enum | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
Mặc định, không sử dụng. |
SUM
|
Tương ứng với hàm SUM .
|
COUNTA
|
Tương ứng với
COUNTA
.
|
COUNT
|
Tương ứng với hàm COUNT .
|
COUNTUNIQUE
|
Tương ứng với
COUNTUNIQUE
.
|
AVERAGE
|
Tương ứng với hàm AVERAGE .
|
MAX
|
Tương ứng với
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
PRODUCT
.
|
STDEV
|
Tương ứng với
STDEV
.
|
STDEVP
|
Tương ứng với
STDEVP
.
|
VAR
|
Tương ứng với
VAR
.
|
VARP
|
Tương ứng với
VARP
.
|
CUSTOM
|
Cho biết công thức này sẽ được sử dụng theo nguyên trạng. Chỉ hợp lệ nếu
PivotValue.formula
đã được đặt.
|
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, trong đó giá trị đã được tóm tắt. |
PivotValueCalculatedDisplayType
Các cách có thể 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
|
Cho biết các giá trị tổng hợp dưới dạng tỷ lệ 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 tỷ lệ phần trăm của tổng giá trị cột. |
PERCENT_OF_GRAND_TOTAL
|
Cho biết các giá trị tổng hợp dưới dạng tỷ lệ phần trăm của giá trị tổng cộng. |
PivotValueLayout
Bố cục của các giá trị tổng hợp.
Enum | |
---|---|
HORIZONTAL
|
Các giá trị được bố trí theo chiều ngang (dưới dạng cột). |
VERTICAL
|
Các giá trị được bố trí theo chiều dọc (dưới dạng hàng). |