Class PivotGroup

PivotGroup

เข้าถึงและแก้ไขกลุ่มกลุ่มย่อยของตาราง Pivot

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addManualGroupingRule(groupName, groupMembers)PivotGroupเพิ่มกฎการจัดกลุ่มด้วยตนเองสำหรับกลุ่ม Pivot นี้
areLabelsRepeated()Booleanส่งคืนว่าป้ายกำกับแสดงเป็นรายการซ้ำหรือไม่
clearGroupingRule()PivotGroupนำกฎการจัดกลุ่มออกจากกลุ่ม Pivot นี้
clearSort()PivotGroupนำการจัดเรียงที่ใช้กับกลุ่มนี้ออก
getDateTimeGroupingRule()DateTimeGroupingRuleแสดงกฎการจัดกลุ่มวันที่และเวลาในกลุ่ม Pivot หรือ null หากไม่มีวันที่และเวลา มีการตั้งค่ากฎการจัดกลุ่ม
getDimension()Dimensionแสดงผลว่าเป็นกลุ่มแถวหรือคอลัมน์
getGroupLimit()PivotGroupLimitแสดงผลขีดจำกัดกลุ่ม Pivot ในกลุ่ม Pivot
getIndex()Integerแสดงผลดัชนีของกลุ่ม Pivot นี้ตามลำดับกลุ่มปัจจุบัน
getPivotTable()PivotTableแสดง PivotTable ของการจัดกลุ่มนี้
getSourceDataColumn()Integerแสดงผลจำนวนคอลัมน์ข้อมูลต้นฉบับที่กลุ่มนี้สรุป
getSourceDataSourceColumn()DataSourceColumnแสดงผลคอลัมน์แหล่งข้อมูลที่กลุ่ม Pivot ดำเนินการ
hideRepeatedLabels()PivotGroupซ่อนป้ายกำกับที่ซ้ำกันสำหรับการจัดกลุ่มนี้
isSortAscending()Booleanแสดงผล true หากการจัดเรียงเป็นแบบจากน้อยไปมาก แสดงผล false หากลำดับการจัดเรียงคือ จากมากไปน้อย
moveToIndex(index)PivotGroupย้ายกลุ่มนี้ไปยังตำแหน่งที่ระบุไว้ในรายการกลุ่มแถวหรือคอลัมน์ปัจจุบัน
remove()voidนำกลุ่ม Pivot นี้ออกจากตาราง
removeManualGroupingRule(groupName)PivotGroupนำกฎการจัดกลุ่มด้วยตนเองซึ่งมี groupName ที่ระบุออก
resetDisplayName()PivotGroupรีเซ็ตชื่อที่แสดงของกลุ่มนี้ในตาราง Pivot เป็นค่าเริ่มต้น
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupตั้งค่ากฎการจัดกลุ่มวันที่และเวลาในกลุ่ม Pivot
setDisplayName(name)PivotGroupตั้งชื่อที่แสดงของกลุ่มนี้ในตาราง Pivot
setGroupLimit(countLimit)PivotGroupกำหนดขีดจำกัดกลุ่ม Pivot ในกลุ่ม Pivot
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupตั้งกฎการจัดกลุ่มฮิสโตแกรมสำหรับกลุ่ม Pivot นี้
showRepeatedLabels()PivotGroupเมื่อมีการจัดกลุ่มแถวหรือคอลัมน์มากกว่า 1 รายการ วิธีนี้จะแสดงป้ายกำกับของการจัดกลุ่มนี้ สำหรับแต่ละรายการของกลุ่มที่ตามมา
showTotals(showTotals)PivotGroupกำหนดว่าจะแสดงค่ารวมของกลุ่ม Pivot นี้ในตารางหรือไม่
sortAscending()PivotGroupตั้งค่าลำดับการจัดเรียงจากน้อยไปหามาก
sortBy(value, oppositeGroupValues)PivotGroupจัดเรียงกลุ่มนี้ตาม PivotValue ที่ระบุสำหรับค่าจาก oppositeGroupValues
sortDescending()PivotGroupตั้งค่าลำดับการจัดเรียงจากมากไปน้อย
totalsAreShown()Booleanแสดงผลว่าค่ารวมของกลุ่ม Pivot นี้แสดงอยู่หรือไม่

เอกสารโดยละเอียด

addManualGroupingRule(groupName, groupMembers)

เพิ่มกฎการจัดกลุ่มด้วยตนเองสำหรับกลุ่ม Pivot นี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
groupNameStringชื่อของกฎการจัดกลุ่มนี้
groupMembersObject[]ค่าที่รวมอยู่ในกฎการจัดกลุ่มนี้

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

areLabelsRepeated()

ส่งคืนว่าป้ายกำกับแสดงเป็นรายการซ้ำหรือไม่

รีเทิร์น

Booleantrue หากมีป้ายกำกับซ้ำ ไม่เช่นนั้น จะแสดงผล false

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

clearGroupingRule()

นำกฎการจัดกลุ่มออกจากกลุ่ม Pivot นี้

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

clearSort()

นำการจัดเรียงที่ใช้กับกลุ่มนี้ออก

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDateTimeGroupingRule()

แสดงกฎการจัดกลุ่มวันที่และเวลาในกลุ่ม Pivot หรือ null หากไม่มีวันที่และเวลา มีการตั้งค่ากฎการจัดกลุ่ม

รีเทิร์น

DateTimeGroupingRule — กฎการจัดกลุ่มวันที่และเวลา

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDimension()

แสดงผลว่าเป็นกลุ่มแถวหรือคอลัมน์

รีเทิร์น

Dimension — มิติข้อมูลที่แสดงประเภทของกลุ่มนี้

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getGroupLimit()

แสดงผลขีดจำกัดกลุ่ม Pivot ในกลุ่ม Pivot แสดงผล null หากไม่มีขีดจำกัดกลุ่ม Pivot ได้รับการตั้งค่าแล้ว

รีเทิร์น

PivotGroupLimit — ขีดจำกัดกลุ่ม Pivot

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getIndex()

แสดงผลดัชนีของกลุ่ม Pivot นี้ตามลำดับกลุ่มปัจจุบัน

รีเทิร์น

Integer — ดัชนีของกลุ่ม Pivot

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getPivotTable()

แสดง PivotTable ของการจัดกลุ่มนี้

รีเทิร์น

PivotTable — ตาราง Pivot ที่กลุ่มนี้อยู่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getSourceDataColumn()

แสดงผลจำนวนคอลัมน์ข้อมูลต้นฉบับที่กลุ่มนี้สรุป ดัชนีนี้อิงตาม 1 หาก กลุ่มนี้สรุปแหล่งข้อมูลในคอลัมน์ "A" ของสเปรดชีตที่เมธอดนี้แสดง 1

รีเทิร์น

Integer — หมายเลขคอลัมน์ของข้อมูลต้นทาง

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getSourceDataSourceColumn()

แสดงผลคอลัมน์แหล่งข้อมูลที่กลุ่ม Pivot ดำเนินการ แสดง null หาก Pivot ตารางไม่ใช่ {DataSourcePivotTableApi}

รีเทิร์น

DataSourceColumn — คอลัมน์แหล่งข้อมูลที่กลุ่ม Pivot ดำเนินการ

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

hideRepeatedLabels()

ซ่อนป้ายกำกับที่ซ้ำกันสำหรับการจัดกลุ่มนี้ หากป้ายกำกับถูกซ่อนอยู่แล้ว การดำเนินการนี้จะไม่ดำเนินการ หากมีการเรียกเมธอดนี้ก่อนที่จะมีการจัดกลุ่มแถวหรือคอลัมน์หลายรายการ เมื่อมีการเรียกเมธอด เพิ่มการจัดกลุ่มแล้ว ป้ายกำกับซ้ำจะถูกซ่อน

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isSortAscending()

แสดงผล true หากการจัดเรียงเป็นแบบจากน้อยไปมาก แสดงผล false หากลำดับการจัดเรียงคือ จากมากไปน้อย

รีเทิร์น

Booleantrue หากลำดับการจัดเรียงมาจากน้อยไปมาก

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

moveToIndex(index)

ย้ายกลุ่มนี้ไปยังตำแหน่งที่ระบุไว้ในรายการกลุ่มแถวหรือคอลัมน์ปัจจุบัน เหล่านี้ ดัชนีมีฐานเป็น 0 ตัวอย่างเช่น ถ้ากลุ่มนี้ควรถูกย้ายไปยังตำแหน่งแรก ควรเรียกเมธอดด้วย 0

พารามิเตอร์

ชื่อประเภทคำอธิบาย
indexIntegerดัชนีที่จะย้ายการจัดกลุ่มนี้ไป

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

remove()

นำกลุ่ม Pivot นี้ออกจากตาราง

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeManualGroupingRule(groupName)

นำกฎการจัดกลุ่มด้วยตนเองซึ่งมี groupName ที่ระบุออก

พารามิเตอร์

ชื่อประเภทคำอธิบาย
groupNameStringชื่อของกฎการจัดกลุ่มที่จะนำออก

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

resetDisplayName()

รีเซ็ตชื่อที่แสดงของกลุ่มนี้ในตาราง Pivot เป็นค่าเริ่มต้น

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setDateTimeGroupingRule(dateTimeGroupingRuleType)

ตั้งค่ากฎการจัดกลุ่มวันที่และเวลาในกลุ่ม Pivot

หากต้องการนำกฎออก ให้ใช้ clearGroupingRule()

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeประเภทของกฎที่จะตั้งค่า

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setDisplayName(name)

ตั้งชื่อที่แสดงของกลุ่มนี้ในตาราง Pivot

พารามิเตอร์

ชื่อประเภทคำอธิบาย
nameStringชื่อที่แสดงที่จะตั้งค่า

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำห่วงโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setGroupLimit(countLimit)

กำหนดขีดจำกัดกลุ่ม Pivot ในกลุ่ม Pivot การดำเนินการนี้ใช้ได้กับ DataSourcePivotTable เท่านั้น

พารามิเตอร์

ชื่อประเภทคำอธิบาย
countLimitIntegerจำนวนแถวหรือคอลัมน์ที่จะตั้งค่าสูงสุด ต้องเป็นค่าบวก

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setHistogramGroupingRule(minValue, maxValue, intervalSize)

ตั้งกฎการจัดกลุ่มฮิสโตแกรมสำหรับกลุ่ม Pivot นี้ กฎฮิสโตแกรมจะจัดระเบียบค่าในองค์ประกอบ ของแหล่งข้อมูลดังกล่าวลงในที่เก็บข้อมูลที่มีขนาดคงที่ ค่าทั้งหมดตั้งแต่ minValue ถึง maxValue จะถูกวางเป็นกลุ่มขนาด interval ค่าทั้งหมดที่ต่ำกว่า minValue จะถูกวางในที่เก็บข้อมูลเดียว เช่นเดียวกับค่าทั้งหมดที่มากกว่า maxValue

พารามิเตอร์

ชื่อประเภทคำอธิบาย
minValueIntegerค่าต่ำสุดสำหรับการวางรายการลงในที่เก็บข้อมูล ค่าน้อยกว่านี้ จะรวมกันเป็นที่เก็บข้อมูลเดียว
maxValueIntegerค่าสูงสุดสำหรับรายการที่จะวางในที่เก็บข้อมูล ค่าที่มากกว่านี้ จะรวมกันเป็นที่เก็บข้อมูลเดียว
intervalSizeInteger

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

showRepeatedLabels()

เมื่อมีการจัดกลุ่มแถวหรือคอลัมน์มากกว่า 1 รายการ วิธีนี้จะแสดงป้ายกำกับของการจัดกลุ่มนี้ สำหรับแต่ละรายการของกลุ่มที่ตามมา หากมีป้ายกำกับซ้ำอยู่แล้ว จะทำให้เกิด ไม่มีการดำเนินการ หากมีการเรียกเมธอดนี้ก่อนที่จะมีการจัดกลุ่มแถวหรือคอลัมน์หลายรายการ เมื่อการเรียก มีการเพิ่มป้ายกำกับซ้ำ การจัดกลุ่มเพิ่มเติมจะปรากฏ

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

showTotals(showTotals)

กำหนดว่าจะแสดงค่ารวมของกลุ่ม Pivot นี้ในตารางหรือไม่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
showTotalsBooleanจะแสดงยอดรวมหรือไม่

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

sortAscending()

ตั้งค่าลำดับการจัดเรียงจากน้อยไปหามาก

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

sortBy(value, oppositeGroupValues)

จัดเรียงกลุ่มนี้ตาม PivotValue ที่ระบุสำหรับค่าจาก 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']);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuePivotValueค่า Pivot ที่ใช้จัดเรียง
oppositeGroupValuesObject[]ค่าของกลุ่ม Pivot ด้านตรงข้าม (กลุ่มคอลัมน์หากจัดเรียง กลุ่มแถว หรือกลุ่มแถวหากจัดเรียงกลุ่มคอลัมน์) ที่ใช้จัดเรียง ลำดับของ ค่าเหล่านี้จะกำหนดลำดับความสำคัญสำหรับไทเบรก

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

sortDescending()

ตั้งค่าลำดับการจัดเรียงจากมากไปน้อย

รีเทิร์น

PivotGroup — กลุ่ม Pivot สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

totalsAreShown()

แสดงผลว่าค่ารวมของกลุ่ม Pivot นี้แสดงอยู่หรือไม่

รีเทิร์น

Booleantrue หากระบบแสดงค่ารวมสำหรับกลุ่ม Pivot นี้ ไม่เช่นนั้น จะส่งคืน false

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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