Class PivotGroup

PivotGroup

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addManualGroupingRule(groupName, groupMembers)PivotGroupเพิ่มกฎการจัดกลุ่มด้วยตนเองสำหรับกลุ่ม Pivot นี้
areLabelsRepeated()Booleanแสดงผลว่าป้ายกำกับแสดงเป็นแบบซ้ำหรือไม่
clearGroupingRule()PivotGroupนำกฎการจัดกลุ่มออกจากกลุ่ม Pivot นี้
clearSort()PivotGroupนำการจัดเรียงที่ใช้กับกลุ่มนี้ออก
getDateTimeGroupingRule()DateTimeGroupingRule|nullแสดงกฎการจัดกลุ่มวันที่และเวลาในกลุ่ม Pivot หรือ null หากไม่ได้ตั้งกฎการจัดกลุ่มวันที่และเวลา
getDimension()Dimensionแสดงผลว่านี่คือกลุ่มแถวหรือกลุ่มคอลัมน์
getGroupLimit()PivotGroupLimit|nullแสดงผลขีดจำกัดกลุ่ม Pivot ในกลุ่ม Pivot
getIndex()Integerแสดงดัชนีของกลุ่ม Pivot นี้ในลำดับกลุ่มปัจจุบัน
getPivotTable()PivotTableแสดง PivotTable ที่การจัดกลุ่มนี้เป็นของ
getSourceDataColumn()Integerแสดงผลจำนวนคอลัมน์ข้อมูลต้นทางที่กลุ่มนี้สรุป
getSourceDataSourceColumn()DataSourceColumn|nullแสดงผลคอลัมน์แหล่งข้อมูลที่กลุ่ม 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()

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

รีเทิร์น

Boolean — true หากป้ายกำกับซ้ำกัน มิฉะนั้นจะแสดงผล 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|null — กฎการจัดกลุ่มวันที่และเวลา

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

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 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|null - ขีดจำกัดกลุ่ม 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|null — คอลัมน์แหล่งข้อมูลที่กลุ่ม 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 หากลำดับการจัดเรียงเป็นจากมากไปน้อย

รีเทิร์น

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

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

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 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.
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']);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 นี้อยู่หรือไม่

รีเทิร์น

Boolean — true หากแสดงค่ารวมสำหรับกลุ่ม Pivot นี้ มิฉะนั้นจะแสดงผล false

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

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

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