เข้าถึงและแก้ไขตาราง Pivot ของแหล่งข้อมูลที่มีอยู่ หากต้องการสร้างตาราง Pivot ของแหล่งข้อมูลใหม่ ให้ใช้
Range.createDataSourcePivotTable(dataSource)
ใช้คลาสนี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
addColumnGroup(columnName) | PivotGroup | เพิ่มกลุ่มคอลัมน์ Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุ |
addFilter(columnName, filterCriteria) | PivotFilter | เพิ่มตัวกรองใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุซึ่งมีเกณฑ์ตัวกรองที่ระบุ |
addPivotValue(columnName, summarizeFunction) | PivotValue | เพิ่มค่า Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุโดยมีสรุปที่ระบุ |
addRowGroup(columnName) | PivotGroup | เพิ่มกลุ่มแถว Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุ |
asPivotTable() | PivotTable | แสดงผลตาราง Pivot ของแหล่งข้อมูลเป็นออบเจ็กต์ตาราง Pivot ปกติ |
cancelDataRefresh() | DataSourcePivotTable | ยกเลิกการรีเฟรชข้อมูลที่เชื่อมโยงกับออบเจ็กต์นี้ หากออบเจ็กต์ทำงานอยู่ |
forceRefreshData() | DataSourcePivotTable | รีเฟรชข้อมูลของออบเจ็กต์นี้โดยไม่คำนึงถึงสถานะปัจจุบัน |
getDataSource() | DataSource | รับแหล่งข้อมูลที่ออบเจ็กต์ลิงก์อยู่ |
getStatus() | DataExecutionStatus | รับสถานะการเรียกใช้ข้อมูลของออบเจ็กต์ |
refreshData() | DataSourcePivotTable | รีเฟรชข้อมูลของออบเจ็กต์ |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | รอจนกระทั่งการดำเนินการปัจจุบันเสร็จสมบูรณ์ และหมดเวลาหลังจากจำนวนวินาทีที่ระบุ |
เอกสารโดยละเอียด
addColumnGroup(columnName)
เพิ่มกลุ่มคอลัมน์ Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
columnName | String | ชื่อคอลัมน์แหล่งข้อมูลที่กลุ่ม Pivot อิงตาม |
รีเทิร์น
PivotGroup
— กลุ่ม Pivot ใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addFilter(columnName, filterCriteria)
เพิ่มตัวกรองใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุซึ่งมีเกณฑ์ตัวกรองที่ระบุ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
columnName | String | ชื่อคอลัมน์แหล่งข้อมูลที่ตัวกรองอิงตาม |
filterCriteria | FilterCriteria | เกณฑ์ที่ตัวกรองใช้ |
รีเทิร์น
PivotFilter
— ตัวกรองใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addPivotValue(columnName, summarizeFunction)
เพิ่มค่า Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุโดยมีสรุปที่ระบุ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
columnName | String | ชื่อคอลัมน์แหล่งข้อมูลที่ค่า Pivot จะอิงตามค่า |
summarizeFunction | PivotTableSummarizeFunction | ฟังก์ชันสรุปที่ค่า Pivot ใช้ |
รีเทิร์น
PivotValue
— ค่า Pivot ใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addRowGroup(columnName)
เพิ่มกลุ่มแถว Pivot ใหม่ตามคอลัมน์แหล่งข้อมูลที่ระบุ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
columnName | String | ชื่อคอลัมน์แหล่งข้อมูลที่กลุ่ม Pivot อิงตาม |
รีเทิร์น
PivotGroup
— กลุ่ม Pivot ใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asPivotTable()
แสดงผลตาราง Pivot ของแหล่งข้อมูลเป็นออบเจ็กต์ตาราง Pivot ปกติ
รีเทิร์น
PivotTable
— ตาราง Pivot
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
cancelDataRefresh()
ยกเลิกการรีเฟรชข้อมูลที่เชื่อมโยงกับออบเจ็กต์นี้ หากออบเจ็กต์ทำงานอยู่
ตัวอย่างนี้แสดงวิธียกเลิกการรีเฟรชสูตร
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
มีข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้เมธอด
SpreadsheetApp#enable...Execution()
เพื่อเปิดการเรียกใช้ข้อมูลจากแหล่งข้อมูลที่เฉพาะเจาะจง
ประเภท
รีเทิร์น
DataSourcePivotTable
— ออบเจ็กต์ข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
รีเฟรชข้อมูลของออบเจ็กต์นี้โดยไม่คำนึงถึงสถานะปัจจุบัน ดู refreshData()
สำหรับ
รายละเอียดเพิ่มเติม หากต้องการยกเลิกการรีเฟรชออบเจ็กต์นี้ที่กำลังทำงานอยู่ โปรดดู cancelDataRefresh()
มีข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้เมธอด SpreadsheetApp#enable...Execution()
เพื่อเปิดการเรียกใช้ข้อมูลจากแหล่งข้อมูลที่เฉพาะเจาะจง
ประเภท
รีเทิร์น
DataSourcePivotTable
— ออบเจ็กต์ข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSource()
รับแหล่งข้อมูลที่ออบเจ็กต์ลิงก์อยู่
รีเทิร์น
DataSource
— แหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getStatus()
รับสถานะการเรียกใช้ข้อมูลของออบเจ็กต์
รีเทิร์น
DataExecutionStatus
— สถานะการดำเนินการกับข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
รีเฟรชข้อมูลของออบเจ็กต์
มีข้อยกเว้นหากปัจจุบันอยู่ในสถานะ error
ใช้ DataSource#updateSpec()
เพื่ออัปเดตข้อกำหนด วิธีการคือ
ต้องการมากกว่า forceRefreshData()
เพื่อป้องกันการแก้ไขแหล่งข้อมูลที่ไม่คาดคิด
มีข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้เมธอด SpreadsheetApp#enable...Execution()
เพื่อเปิดการเรียกใช้ข้อมูลจากแหล่งข้อมูลที่เฉพาะเจาะจง
ประเภท
รีเทิร์น
DataSourcePivotTable
— ออบเจ็กต์ข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
รอจนกระทั่งการดำเนินการปัจจุบันเสร็จสมบูรณ์ และหมดเวลาหลังจากจำนวนวินาทีที่ระบุ จะมีข้อยกเว้นหากการดำเนินการไม่เสร็จสมบูรณ์เมื่อหมดเวลา แต่จะไม่ยกเลิก การดำเนินการกับข้อมูล
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
timeoutInSeconds | Integer | เวลาที่ต้องรอการดำเนินการข้อมูล หน่วยเป็นวินาที จำนวนสูงสุดคือ 300 วินาที |
รีเทิร์น
DataExecutionStatus
— สถานะการดำเนินการกับข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets