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)

Mỗi nhóm hàng trong bảng tổng hợp.

object (PivotGroup)

Mỗi nhóm cột trong bảng tổng hợp.

map (key: integer, value: object ( PivotFilterCriteria))

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à C10:E15, thì khoá của 0 sẽ chứa bộ lọc cho cột C, trong khi khoá 1 dành cho cột D.

Trường này đã ngừng hoạt động và được thay thế bằng filterSpecs.

object (PivotFilterSpec)

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ả criteria và filterSpecs đều được điền vào phản hồi. Nếu cả hai trường đều được chỉ định trong một yêu cầu cập nhật, thì trường này sẽ được ưu tiên.

object (PivotValue)

Danh sách các giá trị để đưa vào bảng tổng hợp.

enum (PivotValueLayout)

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

object (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.

object (GridRange)

Dải ô mà bảng tổng hợp đang đọc dữ liệu.

string

Mã của nguồn dữ liệu mà bảng tổng hợp đang đọc dữ liệu.

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

Đúng nếu bảng tổng hợp phải bao gồm tổng số cho nhóm này.

object (PivotGroupValueMetadata)

Siêu dữ liệu về các giá trị trong nhóm.

enum (SortOrder)

Thứ tự sắp xếp các giá trị trong nhóm này.

object (PivotGroupSortValueBucket)

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.

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á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".

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+

string

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à Region (có thể đổi tên thành State) và nhãn cột là Product (có thể đổi tên thành Item). Các 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 một bảng tổng hợp hiện có, vui lòng xoá bảng tổng hợp hiện có, sau đó tạo bảng tổng hợp mới có cùng các tham số.

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+

object (PivotGroupRule)

Quy tắc nhóm để áp dụng cho nhóm hàng/cột này.

object (PivotGroupLimit)

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.

integer

Độ 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à C10:E15, thì sourceColumnOffset của 0 có nghĩa là nhóm này tham chiếu đến cột C, trong khi chênh lệch 1 sẽ tham chiếu đến cột D.

object (DataSourceColumnReference)

Tham chiếu đến cột nguồn dữ liệu mà nhóm này dựa trên.

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

object (ExtendedValue)

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

boolean

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

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

integer

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

object (ExtendedValue)

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 đó.

{

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

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.

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

object (ExtendedValue)

Tên nhóm (phải ở dạng chuỗi). Mỗi nhóm trong một ManualRule nhất định phải có một tên nhóm duy nhất.

object (ExtendedValue)

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

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

number

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

number

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.

number

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.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

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

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

integer

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

integer

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 PivotTable.rows và sau đó là danh sách PivotTable.columns.

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

string

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ừ.

object (BooleanCondition)

Điều kiện phải đúng thì các giá trị mới xuất hiện. ( visibleValues không ghi đè giá trị 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.)

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à =A1 trên "Bảng tổng hợp 1" được coi là 'Pivot Table 1'!$A$1.

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 NUMBER_GREATER và giá trị =Cost, thì chỉ các cột chứa "Doanh thu" > "Chi phí".

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, mọi giá trị đáp ứng condition (nếu được chỉ định) sẽ hiển thị. Nếu giá trị là false, thì các giá trị thuộc cả visibleValues và đáp ứng condition sẽ xuất hiện.

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

Tiêu chí cho cột.

integer

Độ lệch cột dựa trên 0 của dải ô nguồn.

object (DataSourceColumnReference)

Tham chiếu đến cột nguồn dữ liệu.

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

Một hàm để tóm tắt giá trị. Nếu bạn đặt formula, thì 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ợ.

string

Tên để sử dụng cho giá trị.

enum (PivotValueCalculatedDisplayType)

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.

integer

Độ lệch cột của dải ô nguồn chứa giá trị này.

Ví dụ: nếu nguồn là C10:E15, thì sourceColumnOffset của 0 có nghĩa là giá trị này liên quan đến cột C, trong khi giá trị bù trừ 1 sẽ tham chiếu đến cột D.

string

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ự =.

object (DataSourceColumnReference)

Tham chiếu đến cột nguồn dữ liệu mà giá trị này đọc.