Truy cập và sửa đổi các nhóm phân tách của bảng tổng hợp.
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
add | Pivot | Thêm một quy tắc nhóm thủ công cho nhóm bảng tổng hợp này. |
are | Boolean | Trả về xem nhãn có được hiển thị nhiều lần hay không. |
clear | Pivot | Xoá mọi quy tắc nhóm khỏi nhóm bảng tổng hợp này. |
clear | Pivot | Xoá mọi tiêu chí sắp xếp đã áp dụng cho nhóm này. |
get | Date | Trả về quy tắc nhóm ngày giờ trên nhóm bảng tổng hợp hoặc null nếu không có quy tắc nhóm ngày giờ nào được đặt. |
get | Dimension | Trả về cho dù đây là một nhóm hàng hay nhóm cột. |
get | Pivot | Trả về giới hạn nhóm bảng tổng hợp của nhóm bảng tổng hợp. |
get | Integer | Trả về chỉ mục của nhóm bảng tổng hợp này theo thứ tự nhóm hiện tại. |
get | Pivot | Trả về Pivot mà nhóm này thuộc về. |
get | Integer | Trả về số lượng cột dữ liệu nguồn mà nhóm này tóm tắt. |
get | Data | Trả về cột nguồn dữ liệu mà nhóm tổng hợp hoạt động. |
hide | Pivot | Ẩn các nhãn trùng lặp cho nhóm này. |
is | Boolean | Trả về true nếu sắp xếp theo thứ tự tăng dần, trả về false nếu sắp xếp theo thứ tự giảm dần. |
move | Pivot | Di chuyển nhóm này đến vị trí được chỉ định trong danh sách hiện tại của các nhóm hàng hoặc cột. |
remove() | void | Xoá nhóm bảng tổng hợp này khỏi bảng. |
remove | Pivot | Xoá quy tắc nhóm thủ công có group được chỉ định. |
reset | Pivot | Đặt lại tên hiển thị của nhóm này trong bảng tổng hợp về giá trị mặc định. |
set | Pivot | Đặt quy tắc nhóm ngày giờ trên nhóm bảng tổng hợp. |
set | Pivot | Đặt tên hiển thị của nhóm này trong bảng tổng hợp. |
set | Pivot | Đặt giới hạn nhóm bảng tổng hợp cho nhóm bảng tổng hợp. |
set | Pivot | Đặt quy tắc nhóm biểu đồ cho nhóm bảng tổng hợp này. |
show | Pivot | Khi có nhiều nhóm hàng hoặc cột, phương thức này sẽ hiển thị nhãn của nhóm này cho mỗi mục nhập của nhóm tiếp theo. |
show | Pivot | Đặt xem có hiển thị tổng giá trị cho nhóm bảng tổng hợp này trong bảng hay không. |
sort | Pivot | Đặt thứ tự sắp xếp là tăng dần. |
sort | Pivot | Sắp xếp nhóm này theo Pivot được chỉ định cho các giá trị từ opposite. |
sort | Pivot | Đặt thứ tự sắp xếp thành giảm dần. |
totals | Boolean | Trả về liệu tổng giá trị hiện có được hiển thị cho nhóm tổng hợp này hay không. |
Tài liệu chi tiết
addManualGroupingRule(groupName, groupMembers)
Thêm một quy tắc nhóm thủ công cho nhóm bảng tổng hợp này.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
group | String | Tên của quy tắc nhóm này. |
group | Object[] | Các giá trị có trong quy tắc nhóm này. |
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
areLabelsRepeated()
Trả về xem nhãn có được hiển thị nhiều lần hay không.
Cầu thủ trả bóng
Boolean – true nếu nhãn được lặp lại; nếu không thì trả về false.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
clearGroupingRule()
Xoá mọi quy tắc nhóm khỏi nhóm bảng tổng hợp này.
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
clearSort()
Xoá mọi tiêu chí sắp xếp đã áp dụng cho nhóm này.
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getDateTimeGroupingRule()
Trả về quy tắc nhóm ngày giờ trên nhóm bảng tổng hợp hoặc null nếu không có quy tắc nhóm ngày giờ nào được đặt.
Cầu thủ trả bóng
DateTimeGroupingRule|null – Quy tắc nhóm ngày-giờ.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getDimension()
Trả về cho dù đây là một nhóm hàng hay nhóm cột.
Cầu thủ trả bóng
Dimension – phương diện đại diện cho loại nhóm này
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getGroupLimit()
Trả về giới hạn nhóm bảng tổng hợp của nhóm bảng tổng hợp. Trả về null nếu không có giới hạn nhóm bảng tổng hợp nào được đặt.
Cầu thủ trả bóng
PivotGroupLimit|null – Giới hạn nhóm bảng tổng hợp.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getIndex()
Trả về chỉ mục của nhóm bảng tổng hợp này theo thứ tự nhóm hiện tại.
Cầu thủ trả bóng
Integer – chỉ mục của nhóm bảng tổng hợp
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getPivotTable()
Trả về PivotTable mà nhóm này thuộc về.
Cầu thủ trả bóng
PivotTable – bảng tổng hợp mà nhóm này thuộc về.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getSourceDataColumn()
Trả về số lượng cột dữ liệu nguồn mà nhóm này tóm tắt. Chỉ mục này dựa trên 1, nếu nhóm này tóm tắt dữ liệu nguồn trong cột "A" của bảng tính, phương thức này sẽ trả về 1.
Cầu thủ trả bóng
Integer – số cột dữ liệu nguồn
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getSourceDataSourceColumn()
Trả về cột nguồn dữ liệu mà nhóm tổng hợp hoạt động. Trả về null nếu bảng tổng hợp không phải là {DataSourcePivotTableApi}.
Cầu thủ trả bóng
DataSourceColumn|null – Cột nguồn dữ liệu mà nhóm tổng hợp hoạt động.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
hideRepeatedLabels()
Ẩn các nhãn trùng lặp cho nhóm này. Nếu nhãn đã bị ẩn, thì thao tác này sẽ không có hiệu lực. Nếu phương thức này được gọi trước khi có nhiều nhóm hàng hoặc cột, thì khi một nhóm bổ sung được thêm vào, các nhãn lặp lại sẽ bị ẩn.
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
isSortAscending()
Trả về true nếu sắp xếp theo thứ tự tăng dần, trả về false nếu sắp xếp theo thứ tự giảm dần.
Cầu thủ trả bóng
Boolean – true nếu thứ tự sắp xếp là tăng dần.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
moveToIndex(index)
Di chuyển nhóm này đến vị trí được chỉ định trong danh sách hiện tại của các nhóm hàng hoặc cột. Các chỉ mục này dựa trên 0. Ví dụ: nếu nhóm này cần được di chuyển đến vị trí đầu tiên, thì phương thức này phải được gọi bằng 0.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
index | Integer | Chỉ mục để di chuyển nhóm này đến. |
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
remove()
Xoá nhóm bảng tổng hợp này khỏi bảng.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
removeManualGroupingRule(groupName)
Xoá quy tắc nhóm thủ công có groupName được chỉ định.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
group | String | Tên của quy tắc nhóm cần xoá. |
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
resetDisplayName()
Đặt lại tên hiển thị của nhóm này trong bảng tổng hợp về giá trị mặc định.
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setDateTimeGroupingRule(dateTimeGroupingRuleType)
Đặt quy tắc nhóm ngày giờ trên nhóm bảng tổng hợp.
Để xoá quy tắc, hãy dùng clearGroupingRule().
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
date | Date | Loại quy tắc cần đặt. |
Cầu thủ trả bóng
PivotGroup – Nhóm pivot để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setDisplayName(name)
Đặt tên hiển thị của nhóm này trong bảng tổng hợp.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
name | String | Tên hiển thị cần đặt. |
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setGroupLimit(countLimit)
Đặt giới hạn nhóm bảng tổng hợp cho nhóm bảng tổng hợp. Thao tác này chỉ được hỗ trợ cho DataSourcePivotTable.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
count | Integer | Giới hạn số lượng hàng hoặc cột cần đặt. Phải là số dương. |
Cầu thủ trả bóng
PivotGroup – Nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setHistogramGroupingRule(minValue, maxValue, intervalSize)
Đặt quy tắc nhóm biểu đồ cho nhóm bảng tổng hợp này. Quy tắc biểu đồ tần suất sắp xếp các giá trị trong một cột dữ liệu nguồn thành các nhóm có kích thước cố định. Tất cả các giá trị từ minValue đến maxValue đều được đặt vào các nhóm có kích thước interval. Tất cả các giá trị dưới minValue đều được đặt vào một nhóm, cũng như tất cả các giá trị lớn hơn maxValue.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
min | Integer | Giá trị tối thiểu để đặt các mục vào nhóm. Các giá trị nhỏ hơn giá trị này sẽ được kết hợp thành một nhóm duy nhất. |
max | Integer | Giá trị tối đa của các mục cần được đặt vào các bộ chứa. Các giá trị lớn hơn giá trị này sẽ được kết hợp thành một nhóm duy nhất. |
interval | Integer |
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
showRepeatedLabels()
Khi có nhiều nhóm hàng hoặc cột, phương thức này sẽ hiển thị nhãn của nhóm này cho mỗi mục nhập của nhóm tiếp theo. Nếu các nhãn đã được lặp lại, thì thao tác này sẽ không có tác dụng. Nếu phương thức này được gọi trước khi có nhiều nhóm hàng hoặc cột, thì khi một nhóm bổ sung được thêm vào, các nhãn lặp lại sẽ xuất hiện.
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
showTotals(showTotals)
Đặt xem có hiển thị tổng giá trị cho nhóm bảng tổng hợp này trong bảng hay không.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
show | Boolean | Có hiển thị tổng số hay không. |
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
sortAscending()
Đặt thứ tự sắp xếp là tăng dần.
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
sortBy(value, oppositeGroupValues)
Sắp xếp nhóm này theo PivotValue được chỉ định cho các giá trị từ oppositeGroupValues.
// Sorts the item group by the "SUM of Quantity" pivot value for the specified // salespersons. const sheet = SpreadsheetApp.getActiveSheet(); const pivotTable = sheet.getPivotTables()[0]; const itemGroup = pivotTable.getRowGroups()[0]; const sumQuantityValue = pivotTable.getPivotValues()[0]; itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
value | Pivot | Giá trị trục để sắp xếp. |
opposite | Object[] | Giá trị của một nhóm xoay ngược (một nhóm cột nếu sắp xếp một nhóm hàng hoặc một nhóm hàng nếu sắp xếp một nhóm cột) được dùng để sắp xếp. Thứ tự của các giá trị này xác định mức độ ưu tiên để phân định thắng thua. |
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
sortDescending()
Đặt thứ tự sắp xếp thành giảm dần.
Cầu thủ trả bóng
PivotGroup – nhóm trục để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
totalsAreShown()
Trả về liệu tổng giá trị hiện có được hiển thị cho nhóm tổng hợp này hay không.
Cầu thủ trả bóng
Boolean — true nếu các giá trị tổng được hiển thị cho nhóm bảng tổng hợp này; nếu không, hàm sẽ trả về false.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets