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 นี้

พารามิเตอร์

ชื่อTypeคำอธิบาย
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

พารามิเตอร์

ชื่อTypeคำอธิบาย
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 ที่ระบุออก

พารามิเตอร์

ชื่อTypeคำอธิบาย
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()

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setDisplayName(name)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setGroupLimit(countLimit)

กําหนดขีดจํากัดของกลุ่ม Pivot ในกลุ่ม Pivot การดำเนินการนี้รองรับเฉพาะ DataSourcePivotTable

พารามิเตอร์

ชื่อTypeคำอธิบาย
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

พารามิเตอร์

ชื่อTypeคำอธิบาย
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 นี้ในตารางหรือไม่

พารามิเตอร์

ชื่อTypeคำอธิบาย
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']);

พารามิเตอร์

ชื่อTypeคำอธิบาย
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