เข้าถึงและแก้ไขแผนภูมิแหล่งข้อมูลที่มีอยู่
ใช้คลาสนี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
cancelDataRefresh() | DataSourceChart | ยกเลิกการรีเฟรชข้อมูลที่เชื่อมโยงกับออบเจ็กต์นี้หากยังทำงานอยู่ |
forceRefreshData() | DataSourceChart | รีเฟรชข้อมูลของออบเจ็กต์นี้โดยไม่คำนึงถึงสถานะปัจจุบันของ |
getDataSource() | DataSource | รับแหล่งข้อมูลที่ออบเจ็กต์ลิงก์อยู่ |
getStatus() | DataExecutionStatus | รับสถานะการเรียกใช้ข้อมูลของออบเจ็กต์ |
refreshData() | DataSourceChart | รีเฟรชข้อมูลของออบเจ็กต์ |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | รอจนกว่าการดำเนินการปัจจุบันจะเสร็จสมบูรณ์ แล้วหมดเวลาหลังจากใช้งานไปตามจำนวนวินาทีที่ระบุ |
เอกสารโดยละเอียด
cancelDataRefresh()
ยกเลิกการรีเฟรชข้อมูลที่เชื่อมโยงกับออบเจ็กต์นี้หากยังทำงานอยู่
ตัวอย่างนี้แสดงวิธียกเลิกการรีเฟรชสูตร
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
มีข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้เมธอด
SpreadsheetApp#enable...Execution()
เพื่อเปิดใช้การดำเนินการกับข้อมูลสําหรับประเภทแหล่งข้อมูลที่เฉพาะเจาะจง
รีเทิร์น
DataSourceChart
— ออบเจ็กต์ข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
รีเฟรชข้อมูลของออบเจ็กต์นี้โดยไม่คำนึงถึงสถานะปัจจุบันของ ดูรายละเอียดเพิ่มเติมได้ที่ refreshData()
หากต้องการยกเลิกการรีเฟรชออบเจ็กต์นี้ที่ดำเนินการอยู่ในปัจจุบัน โปรดดู cancelDataRefresh()
มีข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้เมธอด SpreadsheetApp#enable...Execution()
เพื่อเปิดใช้การดำเนินการกับข้อมูลสําหรับประเภทแหล่งข้อมูลที่เฉพาะเจาะจง
รีเทิร์น
DataSourceChart
— ออบเจ็กต์ข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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()
เพื่อเปิดใช้การดำเนินการกับข้อมูลสําหรับประเภทแหล่งข้อมูลที่เฉพาะเจาะจง
รีเทิร์น
DataSourceChart
— ออบเจ็กต์ข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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