เข้าถึงและแก้ไขสูตรแหล่งข้อมูลที่มีอยู่ หากต้องการสร้างสูตรแหล่งข้อมูลใหม่ ให้ใช้ Range.setFormula(formula)
ใช้คลาสนี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
forceRefreshData() | DataSourceFormula | รีเฟรชข้อมูลของออบเจ็กต์นี้โดยไม่คำนึงถึงสถานะปัจจุบัน |
getAnchorCell() | Range | แสดงผล Range ที่แสดงถึงเซลล์ที่จุดยึดสูตรแหล่งข้อมูลนี้ |
getDataSource() | DataSource | รับแหล่งข้อมูลที่ออบเจ็กต์ลิงก์อยู่ |
getDisplayValue() | String | แสดงผลค่าการแสดงผลสูตรแหล่งข้อมูล |
getFormula() | String | แสดงผลสูตรสำหรับสูตรแหล่งข้อมูลนี้ |
getStatus() | DataExecutionStatus | รับสถานะการเรียกใช้ข้อมูลของออบเจ็กต์ |
refreshData() | DataSourceFormula | รีเฟรชข้อมูลของออบเจ็กต์ |
setFormula(formula) | DataSourceFormula | อัปเดตสูตร |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | รอจนกว่าการดำเนินการปัจจุบันจะเสร็จสิ้น และหมดเวลาหลังจากครบจำนวนวินาทีที่ระบุ |
เอกสารประกอบโดยละเอียด
forceRefreshData()
รีเฟรชข้อมูลของออบเจ็กต์นี้โดยไม่คำนึงถึงสถานะปัจจุบัน ดูรายละเอียดเพิ่มเติมได้ที่ refreshData()
มีข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้เมธอด SpreadsheetApp#enable...Execution()
เพื่อเปิดใช้การดำเนินการกับข้อมูลสำหรับประเภทแหล่งข้อมูลที่เจาะจง
รีเทิร์น
DataSourceFormula
— ออบเจ็กต์ข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
getDataSource()
รับแหล่งข้อมูลที่ออบเจ็กต์ลิงก์อยู่
รีเทิร์น
DataSource
— แหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
แสดงผลค่าการแสดงผลสูตรแหล่งข้อมูล
รีเทิร์น
String
— ค่าที่แสดง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
แสดงผลสูตรสำหรับสูตรแหล่งข้อมูลนี้
รีเทิร์น
String
— สูตร
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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()
เพื่อเปิดใช้การดำเนินการกับข้อมูลสำหรับประเภทแหล่งข้อมูลที่เจาะจง
รีเทิร์น
DataSourceFormula
— ออบเจ็กต์ข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
อัปเดตสูตร
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
formula | String | สูตรใหม่ |
รีเทิร์น
DataSourceFormula
— สูตรแหล่งข้อมูลสำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
รอจนกว่าการดำเนินการปัจจุบันจะเสร็จสิ้น และหมดเวลาหลังจากครบจำนวนวินาทีที่ระบุ จะแสดงข้อยกเว้นหากการดำเนินการไม่เสร็จสมบูรณ์เมื่อหมดเวลา แต่ไม่ได้ยกเลิกการดำเนินการกับข้อมูล
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
timeoutInSeconds | Integer | เวลาที่รอการดำเนินการข้อมูล หน่วยเป็นวินาที โดยมีความยาวสูงสุด 300 วินาที |
รีเทิร์น
DataExecutionStatus
— สถานะการดำเนินการกับข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets