Class DataSourceSheet

ชีตแหล่งข้อมูล

เข้าถึงและแก้ไขชีตแหล่งข้อมูลที่มีอยู่ หากต้องการสร้างชีตแหล่งข้อมูลใหม่ ให้ใช้ Spreadsheet.insertDataSourceSheet(spec)

ใช้คลาสนี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addFilter(columnName, filterCriteria)DataSourceSheetเพิ่มตัวกรองที่ใช้กับชีตแหล่งข้อมูล
asSheet()Sheetแสดงผลชีตแหล่งข้อมูลเป็นออบเจ็กต์ชีตปกติ
autoResizeColumn(columnName)DataSourceSheetปรับความกว้างของคอลัมน์ที่ระบุโดยอัตโนมัติ
autoResizeColumns(columnNames)DataSourceSheetปรับความกว้างของคอลัมน์ที่ระบุโดยอัตโนมัติ
cancelDataRefresh()DataSourceSheetยกเลิกการรีเฟรชข้อมูลที่เชื่อมโยงกับออบเจ็กต์นี้หากกำลังทำงานอยู่
forceRefreshData()DataSourceSheetรีเฟรชข้อมูลของออบเจ็กต์นี้โดยไม่คำนึงถึงสถานะปัจจุบัน
getColumnWidth(columnName)Integer|nullแสดงผลความกว้างของคอลัมน์ที่ระบุ
getDataSource()DataSourceรับแหล่งข้อมูลที่ออบเจ็กต์ลิงก์อยู่
getFilters()DataSourceSheetFilter[]แสดงตัวกรองทั้งหมดที่ใช้กับชีตแหล่งข้อมูล
getSheetValues(columnName)Object[]แสดงผลค่าทั้งหมดสำหรับชีตแหล่งข้อมูลสำหรับชื่อคอลัมน์ที่ระบุ
getSheetValues(columnName, startRow, numRows)Object[]แสดงค่าทั้งหมดสำหรับชีตแหล่งข้อมูลสำหรับชื่อคอลัมน์ที่ระบุจาก แถวเริ่มต้น (อิงตาม 1) ที่ระบุและสูงสุดถึง numRows ที่ระบุ
getSortSpecs()SortSpec[]รับข้อกำหนดการจัดเรียงทั้งหมดในชีตแหล่งข้อมูล
getStatus()DataExecutionStatusรับสถานะการดำเนินการข้อมูลของออบเจ็กต์
refreshData()DataSourceSheetรีเฟรชข้อมูลของออบเจ็กต์
removeFilters(columnName)DataSourceSheetนำตัวกรองทั้งหมดที่ใช้กับคอลัมน์ชีตแหล่งข้อมูลออก
removeSortSpec(columnName)DataSourceSheetนำข้อกำหนดการจัดเรียงในคอลัมน์ในชีตแหล่งข้อมูลออก
setColumnWidth(columnName, width)DataSourceSheetกำหนดความกว้างของคอลัมน์ที่ระบุ
setColumnWidths(columnNames, width)DataSourceSheetกำหนดความกว้างของคอลัมน์ที่ระบุ
setSortSpec(columnName, ascending)DataSourceSheetตั้งค่าข้อกำหนดการจัดเรียงในคอลัมน์ในชีตแหล่งข้อมูล
setSortSpec(columnName, sortOrder)DataSourceSheetตั้งค่าข้อกำหนดการจัดเรียงในคอลัมน์ในชีตแหล่งข้อมูล
waitForCompletion(timeoutInSeconds)DataExecutionStatusรอจนกว่าการดำเนินการปัจจุบันจะเสร็จสมบูรณ์ โดยจะหมดเวลาหลังจากผ่านไปตามจำนวนวินาทีที่ระบุ

เอกสารโดยละเอียด

addFilter(columnName, filterCriteria)

เพิ่มตัวกรองที่ใช้กับชีตแหล่งข้อมูล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNameStringชื่อของคอลัมน์ที่จะใช้ตัวกรองนี้
filterCriteriaFilterCriteriaเกณฑ์การกรองที่จะใช้

รีเทิร์น

DataSourceSheet — ชีตแหล่งข้อมูลสำหรับการเชื่อมโยงเมธอด

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

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

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

asSheet()

แสดงผลชีตแหล่งข้อมูลเป็นออบเจ็กต์ชีตปกติ

รีเทิร์น

Sheet — สเปรดชีตปกติ

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

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

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

autoResizeColumn(columnName)

ปรับความกว้างของคอลัมน์ที่ระบุโดยอัตโนมัติ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNameStringชื่อคอลัมน์

รีเทิร์น

DataSourceSheet - ชีตแหล่งข้อมูลนี้สำหรับการเชื่อมโยง

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

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

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

autoResizeColumns(columnNames)

ปรับความกว้างของคอลัมน์ที่ระบุโดยอัตโนมัติ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNamesString[]รายการชื่อคอลัมน์ที่จะอัปเดต

รีเทิร์น

DataSourceSheet - ชีตแหล่งข้อมูลนี้สำหรับการเชื่อมโยง

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

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 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() เพื่อเปิดใช้การเรียกใช้ข้อมูลสำหรับแหล่งข้อมูลประเภทใดประเภทหนึ่ง

รีเทิร์น

DataSourceSheet — ออบเจ็กต์ข้อมูล

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

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

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

forceRefreshData()

รีเฟรชข้อมูลของออบเจ็กต์นี้โดยไม่คำนึงถึงสถานะปัจจุบัน ดูรายละเอียดเพิ่มเติมได้ที่ refreshData() หากต้องการยกเลิกการรีเฟรชออบเจ็กต์นี้ที่กำลังดำเนินการอยู่ โปรดดูcancelDataRefresh()

แสดงข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้วิธีการ SpreadsheetApp#enable...Execution() เพื่อเปิดใช้การเรียกใช้ข้อมูลสำหรับแหล่งข้อมูลประเภทใดประเภทหนึ่ง

รีเทิร์น

DataSourceSheet — ออบเจ็กต์ข้อมูล

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

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

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

getColumnWidth(columnName)

แสดงผลความกว้างของคอลัมน์ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNameStringชื่อคอลัมน์

รีเทิร์น

Integer|null — ความกว้างของคอลัมน์ หรือ null หากคอลัมน์ใช้ความกว้างเริ่มต้น

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

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

getFilters()

แสดงตัวกรองทั้งหมดที่ใช้กับชีตแหล่งข้อมูล

รีเทิร์น

DataSourceSheetFilter[] — อาร์เรย์ของตัวกรองทั้งหมดที่ใช้กับชีตแหล่งข้อมูล

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

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

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

getSheetValues(columnName)

แสดงผลค่าทั้งหมดสำหรับชีตแหล่งข้อมูลสำหรับชื่อคอลัมน์ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNameStringชื่อคอลัมน์แหล่งข้อมูลที่จะดึงค่า

รีเทิร์น

Object[] - อาร์เรย์ค่าหนึ่งมิติ

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

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

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

getSheetValues(columnName, startRow, numRows)

แสดงค่าทั้งหมดสำหรับชีตแหล่งข้อมูลสำหรับชื่อคอลัมน์ที่ระบุจาก แถวเริ่มต้น (อิงตาม 1) ที่ระบุและสูงสุดถึง numRows ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNameStringชื่อคอลัมน์แหล่งข้อมูลที่จะดึงค่า
startRowIntegerตำแหน่งแถวที่จะเริ่มดึงค่า
numRowsIntegerจำนวนแถวที่จะดึงข้อมูล

รีเทิร์น

Object[] - อาร์เรย์ค่าหนึ่งมิติ

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

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

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

getSortSpecs()

รับข้อกำหนดการจัดเรียงทั้งหมดในชีตแหล่งข้อมูล

รีเทิร์น

SortSpec[] — รายการข้อกำหนดการจัดเรียง

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

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 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()ดีกว่าforceRefreshData()เพื่อป้องกันการแก้ไขแหล่งข้อมูลโดยไม่คาดคิด

แสดงข้อยกเว้นหากไม่ได้เปิดใช้ประเภทแหล่งข้อมูล ใช้วิธีการ SpreadsheetApp#enable...Execution() เพื่อเปิดใช้การเรียกใช้ข้อมูลสำหรับแหล่งข้อมูลประเภทใดประเภทหนึ่ง

รีเทิร์น

DataSourceSheet — ออบเจ็กต์ข้อมูล

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

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

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

removeFilters(columnName)

นำตัวกรองทั้งหมดที่ใช้กับคอลัมน์ชีตแหล่งข้อมูลออก

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNameStringชื่อของคอลัมน์ที่จะนำตัวกรองออก

รีเทิร์น

DataSourceSheet — ชีตแหล่งข้อมูลสำหรับการเชื่อมโยงเมธอด

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

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

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

removeSortSpec(columnName)

นำข้อกำหนดการจัดเรียงในคอลัมน์ในชีตแหล่งข้อมูลออก

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNameStringชื่อคอลัมน์

รีเทิร์น

DataSourceSheet - ชีตแหล่งข้อมูลสำหรับการเชื่อมโยง

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

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

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

setColumnWidth(columnName, width)

กำหนดความกว้างของคอลัมน์ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNameStringชื่อคอลัมน์
widthIntegerความกว้างใหม่ของคอลัมน์

รีเทิร์น

DataSourceSheet - ชีตแหล่งข้อมูลนี้สำหรับการเชื่อมโยง

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

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

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

setColumnWidths(columnNames, width)

กำหนดความกว้างของคอลัมน์ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNamesString[]รายการชื่อคอลัมน์ที่จะอัปเดต
widthIntegerความกว้างใหม่ของคอลัมน์

รีเทิร์น

DataSourceSheet - ชีตแหล่งข้อมูลนี้สำหรับการเชื่อมโยง

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

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

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

setSortSpec(columnName, ascending)

ตั้งค่าข้อกำหนดการจัดเรียงในคอลัมน์ในชีตแหล่งข้อมูล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNameStringชื่อคอลัมน์ที่จะจัดเรียง
ascendingBooleanหากเป็น true ให้จัดเรียงคอลัมน์จากน้อยไปมาก หากเป็น false ให้จัดเรียงคอลัมน์จากมากไปน้อย

รีเทิร์น

DataSourceSheet - ชีตแหล่งข้อมูลสำหรับการเชื่อมโยง

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

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

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

setSortSpec(columnName, sortOrder)

ตั้งค่าข้อกำหนดการจัดเรียงในคอลัมน์ในชีตแหล่งข้อมูล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnNameStringชื่อคอลัมน์ที่จะจัดเรียง
sortOrderSortOrderลำดับการจัดเรียง

รีเทิร์น

DataSourceSheet - ชีตแหล่งข้อมูลสำหรับการเชื่อมโยง

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

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

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

waitForCompletion(timeoutInSeconds)

รอจนกว่าการดำเนินการปัจจุบันจะเสร็จสมบูรณ์ โดยจะหมดเวลาหลังจากผ่านไปตามจำนวนวินาทีที่ระบุ โยนข้อยกเว้นหากการดำเนินการไม่เสร็จสมบูรณ์เมื่อหมดเวลา แต่จะไม่ยกเลิก การดำเนินการข้อมูล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
timeoutInSecondsIntegerเวลารอการเรียกใช้ข้อมูลเป็นวินาที สูงสุดคือ 300 วินาที

รีเทิร์น

DataExecutionStatus — สถานะการเรียกใช้ข้อมูล

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

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

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