Class PivotGroup

PivotGroup

Truy cập và sửa đổi các nhóm họp nhóm trong bảng tổng hợp.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
addManualGroupingRule(groupName, groupMembers)PivotGroupThêm quy tắc nhóm thủ công cho nhóm bảng tổng hợp này.
areLabelsRepeated()BooleanTrả về việc nhãn có được hiển thị như lặp lại hay không.
clearGroupingRule()PivotGroupXoá mọi quy tắc nhóm khỏi nhóm bảng tổng hợp này.
clearSort()PivotGroupXoá mọi chế độ sắp xếp được áp dụng cho nhóm này.
getDateTimeGroupingRule()DateTimeGroupingRuleTrả 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ó ngày giờ đã đặt quy tắc nhóm.
getDimension()DimensionTrả về cho biết đây là một nhóm hàng hay nhóm cột.
getGroupLimit()PivotGroupLimitTrả về giới hạn nhóm bảng tổng hợp trên nhóm bảng tổng hợp đó.
getIndex()IntegerTrả 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.
getPivotTable()PivotTableTrả về PivotTable chứa nhóm này.
getSourceDataColumn()IntegerTrả về số lượng cột dữ liệu nguồn mà nhóm này tóm tắt.
getSourceDataSourceColumn()DataSourceColumnTrả về cột nguồn dữ liệu mà nhóm bảng tổng hợp hoạt động.
hideRepeatedLabels()PivotGroupẨn các nhãn lặp lại cho nhóm này.
isSortAscending()BooleanTrả về true nếu thứ tự sắp xếp tăng dần, trả về false nếu thứ tự sắp xếp là giảm dần.
moveToIndex(index)PivotGroupDi chuyển nhóm này đến vị trí đã chỉ định trong danh sách các nhóm hàng hoặc cột hiện tại.
remove()voidXoá nhóm bảng tổng hợp này khỏi bảng.
removeManualGroupingRule(groupName)PivotGroupXoá quy tắc nhóm thủ công với groupName được chỉ định.
resetDisplayName()PivotGroupĐặ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.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupĐặt quy tắc nhóm ngày giờ trên nhóm bảng tổng hợp.
setDisplayName(name)PivotGroupĐặt tên hiển thị của nhóm này trong bảng tổng hợp.
setGroupLimit(countLimit)PivotGroupĐặt giới hạn nhóm bảng tổng hợp trên nhóm bảng tổng hợp đó.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupĐặt một quy tắc nhóm biểu đồ cho nhóm bảng tổng hợp này.
showRepeatedLabels()PivotGroupKhi có nhiều nhóm hàng hoặc cột, phương pháp này sẽ hiển thị nhãn của nhóm này cho mỗi mục của nhóm tiếp theo.
showTotals(showTotals)PivotGroupĐặ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.
sortAscending()PivotGroupĐặt thứ tự sắp xếp là tăng dần.
sortBy(value, oppositeGroupValues)PivotGroupSắp xếp nhóm này theo PivotValue được chỉ định cho các giá trị từ oppositeGroupValues.
sortDescending()PivotGroupĐặt thứ tự sắp xếp theo thứ tự giảm dần.
totalsAreShown()BooleanTrả về xem tổng giá trị có hiển thị cho nhóm bảng tổng hợp này hay không.

Tài liệu chi tiết

addManualGroupingRule(groupName, groupMembers)

Thêm quy tắc nhóm thủ công cho nhóm bảng tổng hợp này.

Tham số

TênLoạiMô tả
groupNameStringTên của quy tắc nhóm này.
groupMembersObject[]Các giá trị có trong quy tắc nhóm này.

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

areLabelsRepeated()

Trả về việc nhãn có được hiển thị như lặp lại hay không.

Cầu thủ trả bóng

Boolean – true nếu nhãn bị lặp lại; nếu không sẽ trả về false.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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 tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearSort()

Xoá mọi chế độ sắp xếp được áp dụng cho nhóm này.

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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ó ngày giờ đã đặt quy tắc nhóm.

Cầu thủ trả bóng

DateTimeGroupingRule — Quy tắc nhóm ngày giờ.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDimension()

Trả về cho biết đâ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

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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 trên 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 đã được đặt.

Cầu thủ trả bóng

PivotGroupLimit — Giới hạn nhóm bảng tổng hợp.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getPivotTable()

Trả về PivotTable chứa nhóm này.

Cầu thủ trả bóng

PivotTable — bảng tổng hợp chứa nhóm này.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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ỉ số này được lấy từ thang điểm 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 trả về 1.

Cầu thủ trả bóng

Integer – số cột dữ liệu nguồn

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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 bảng tổng hợp hoạt động. Trả về null nếu bảng tổng hợp bảng không phải là {DataSourcePivotTableApi}.

Cầu thủ trả bóng

DataSourceColumn — Cột nguồn dữ liệu mà nhóm bảng tổng hợp sẽ hoạt động.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

hideRepeatedLabels()

Ẩn các nhãn lặp lại cho nhóm này. Nếu nhãn đã bị ẩn, thì kết quả là không hoạt động. Nếu phương thức này được gọi trước khi có nhiều nhóm hàng hoặc nhóm cột, khi có thêm thì các nhãn lặp lại sẽ bị ẩn.

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isSortAscending()

Trả về true nếu thứ tự sắp xếp tăng dần, trả về false nếu thứ tự sắp xếp là giảm dần.

Cầu thủ trả bóng

Boolean – true nếu thứ tự sắp xếp tăng dần.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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í đã chỉ định trong danh sách các nhóm hàng hoặc cột hiện tại. Các chỉ mục dựa trên giá trị 0. Ví dụ: nếu nhóm này được chuyển đến vị trí đầu tiên, thì phải được gọi bằng 0.

Tham số

TênLoạiMô tả
indexIntegerChỉ mục để di chuyển nhóm này vào.

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

removeManualGroupingRule(groupName)

Xoá quy tắc nhóm thủ công với groupName được chỉ định.

Tham số

TênLoạiMô tả
groupNameStringTên của quy tắc nhóm cần xoá.

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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 tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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 này, hãy dùng clearGroupingRule().

Tham số

TênLoạiMô tả
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeLoại quy tắc cần đặt.

Cầu thủ trả bóng

PivotGroup — Nhóm tổng hợp, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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ênLoạiMô tả
nameStringTên hiển thị cần đặt.

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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 trên nhóm bảng tổng hợp đó. Thao tác này chỉ được hỗ trợ đối với DataSourcePivotTable.

Tham số

TênLoạiMô tả
countLimitIntegerGiớ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 tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHistogramGroupingRule(minValue, maxValue, intervalSize)

Đặt mộ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ổ chức các giá trị theo thành các nhóm có kích thước không đổi. Tất cả giá trị từ minValue đến maxValue được đặt vào các nhóm kích thước interval. Tất cả giá trị dưới minValue đượ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ênLoạiMô tả
minValueIntegerGiá trị tối thiểu cho các mục được đặt vào các nhóm. Có giá trị thấp hơn mức này được kết hợp vào một nhóm duy nhất.
maxValueIntegerGiá trị tối đa cho các mục được đặt vào các nhóm. Giá trị lớn hơn giá trị này được kết hợp vào một nhóm duy nhất.
intervalSizeInteger

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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 pháp này sẽ hiển thị nhãn của nhóm này cho mỗi mục của nhóm tiếp theo. Nếu nhãn đã lặp lại, thì điều này sẽ dẫn đến không hoạt động. Nếu phương thức này được gọi trước khi có nhiều nhóm hàng hoặc nhóm cột, thì khi một nhóm bổ sung được thêm vào, các nhãn lặp lại được hiển thị.

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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ênLoạiMô tả
showTotalsBooleanLiệu có hiển thị tổng số hay không.

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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 tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • 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.
var sheet = SpreadsheetApp.getActiveSheet();
var pivotTable = sheet.getPivotTables()[0];
var itemGroup = pivotTable.getRowGroups()[0];
var sumQuantityValue = pivotTable.getPivotValues()[0];
itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);

Tham số

TênLoạiMô tả
valuePivotValueGiá trị tổng hợp để sắp xếp.
oppositeGroupValuesObject[]Giá trị của một nhóm bảng tổng hợp đối diện (một nhóm cột nếu sắp xếp một nhóm nhóm hàng hoặc 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 cho việc ngắt liên kết.

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

sortDescending()

Đặt thứ tự sắp xếp theo thứ tự giảm dần.

Cầu thủ trả bóng

PivotGroup – nhóm tổng hợp để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

totalsAreShown()

Trả về xem tổng giá trị có hiển thị cho nhóm bảng tổng hợp này hay không.

Cầu thủ trả bóng

Boolean — true nếu tổng giá trị được hiển thị cho nhóm bảng tổng hợp này; nếu không thì trả về false.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets