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)

Từng nhóm hàng trong bảng tổng hợp.

object (PivotGroup)

Từng nhóm cột trong bảng tổng hợp.

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

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

Trường này không còn được dùng nữa, thay vào đó là 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ả hai criteria và filterSpecs được điền sẵn trong các câu trả lời. Nếu cả hai trường đượ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ị 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).

object (DataExecutionStatus)

Chỉ có đầu ra. Trạng thái thực thi dữ liệu của bảng tổng hợp nguồn dữ liệu.

object (GridRange)

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

string

Mã nhận dạng 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)

Nhóm của nhóm bảng tổng hợp đối diện cần sắp xếp. 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.

boolean

Đúng nếu các tiêu đề trong nhóm bảng tổng hợp này lặp lại. Giá trị này chỉ hợp lệ đối với 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".

+--------------+
| 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ể được tuỳ chỉnh. 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ủa cột là Product (có thể đổi tên 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 xoá bảng tổng hợp hiện có rồi tạo bảng tổng hợp mới với các thông số tương tự.

+--------------+---------+-------+
| 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 hàng hoặc cột sẽ áp dụng cho nhóm bảng tổng hợp này.

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, một sourceColumnOffset trong số 0 có nghĩa là nhóm này đề cập đến cột C, trong khi độ lệch 1 sẽ tham chiếu đến cột D.

object (DataSourceColumnReference)

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

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

object (ExtendedValue)

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

boolean

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

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

integer

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

object (ExtendedValue)

Xác định nhóm 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 đó.

{

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

Đáp ManualRule.

object (HistogramRule)

Đáp HistogramRule.

object (DateTimeRule)

Đáp DateTimeRule.

{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}

object (ManualRuleGroup)

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.

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

object (ExtendedValue)

Tên nhóm, phải là một chuỗi. Mỗi nhóm trong một giá trị nhất định ManualRule phải có 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. Mục có thể xuất hiện trong tối đa một nhóm trong một nhóm nhất định ManualRule. 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 bộ chứa đã được tạo. Phải là số dương.

number

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 bộ chứa. Trường này là không bắt buộc.

number

Giá trị tối đa 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ị ở 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.

{
  "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 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ố 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 PivotTable.rows sau đó chọn PivotTable.columns danh sách.

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

string

Các giá trị cần được đưa vào. Các giá trị không được liệt kê ở đây đều bị loại trừ.

object (BooleanCondition)

Một điều kiện phải đúng thì các giá trị mới được hiển thị. ( 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. Các tệp tham 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" đượ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ộ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 NUMBER_GREATER và giá trị =Cost, sau đó chỉ những cột có "Doanh thu" > "Chi phí" được bao gồm.

boolean

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

{
  "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 formula được đặt, các giá trị duy nhất được hỗ trợ là SUM và CUSTOM. Nếu sourceColumnOffset được đặt, sau đó CUSTOM 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ẽ được hiển thị theo kết quả của phép tính có giá trị tổng hợp khác. Ví dụ: nếu tínhDisplayType được chỉ định là PERCENT_OF_GRAND_TOTAL, thì tất cả giá trị tổng hợp sẽ hiển thị dưới dạng tỷ lệ phần trăm của tổng cộng. Trong trình chỉnh sửa Trang tính, tác vụ 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 nơi giá trị này đọc.

Ví dụ: nếu nguồn là C10:E15, một sourceColumnOffset trong số 0 có nghĩa là giá trị này đề cập đến cột C, trong khi độ lệch 1 sẽ tham chiếu đến cột D.

string

Một công thức tuỳ chỉnh để tính giá trị. Công thức phải bắt đầu bằng = .

object (DataSourceColumnReference)

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