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
|
Việc liên kết bộ lọc theo độ dời cột nguồn là không bắt buộ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 ánh xạ là độ dời 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ả |
values[]
|
Danh sách các giá trị cần đưa vào bảng tổng hợp. |
valueLayout
|
Liệu các giá trị có 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) hay khô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 hợp hợp nhất
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:
|
|
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 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 |
---|
{ "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, hệ thống sẽ sắp xếp theo thứ tự bảng chữ cái theo các giá trị của nhóm này. |
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ị các tiêu đề 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 "Q1 Mar" (Quý 1 tháng 3), nhưng "Q1" không xuất hiện vì trùng lặp với các hàng trước đó. Việc đặt repeatHeadings thành true sẽ khiến "Q1" được lặp lại cho "Feb" và "Mar".
|
label
|
Nhãn để sử dụng cho các nhóm hàng/cột có thể tuỳ chỉnh. Ví dụ: trong bảng tổng hợp sau, 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 hợp hợp nhất
source . Nguồn dữ liệu của nhóm tổng hợp.
source chỉ có thể là một trong những loạ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
|
Thông tin 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 một nhóm 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
|
True nếu dữ liệu tương ứng với giá trị bị 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 danh sách |
buckets[]
|
Xác định bộ chứa 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 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ê, thì điều này cho biết hàng phải được sắp xếp theo "Tổng cộng" trên các nhóm cột. Nếu chỉ có 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 bộ chứa đó. |
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
|
Một |
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ể được chuyển thành một 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 = 'Central', items = ['AL', 'AR', 'IA', ...]) cho quy tắc nhóm thủ công. Xin 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 ( |
Trường | |
---|---|
groups[]
|
Danh sách tên nhóm và các mục tương ứng trong 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 trong dữ liệu nguồn cầ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 |
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ả 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 biết 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 một 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 đồ tần suất 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 bộ chứa được tạo. Phải dương. |
start
|
Giá trị tối thiểu 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ị 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 điểm cuối được gộp vào một bộ chứa 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 cho biết 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ẽ dẫn đến 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ữ của bảng tính là "en-US", mặc dù việc hiển thị ngày và giờ thực tế 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 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 theo 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 PM. 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ụ: 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ụ: 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 – 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ụ: 22/11/2008. |
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 áp dụng, tất cả các giới hạn nhóm trục 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. 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 ô theo ký hiệu A1 được đánh giá tương ứng với trang tính bảng tổng hợp. Các tệp tham chiếu được xử lý tuyệt đối, vì vậy 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 có tên là "Doanh thu" và "Chi phí" và một điều kiện được áp dụng cho cột "Doanh thu" với 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í bộ lọc của bảng tổng hợp được liên kết với một độ dời 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 hợp nhất
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 số. 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 hợp hợp nhất
value . Dữ liệu để 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
|
Độ dời 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
Hàm tóm tắt mộ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 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 .
|
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
|
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ị 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 sắp xếp theo chiều ngang (dưới dạng cột). |
VERTICAL
|
Các giá trị được sắp xếp theo chiều dọc (dưới dạng hàng). |