Class DataValidationBuilder

DataValidationBuilder

เครื่องมือสร้างกฎการตรวจสอบข้อมูล 

// Set the data validation for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
build()DataValidationสร้างกฎการตรวจสอบข้อมูลจากการตั้งค่าที่ใช้กับเครื่องมือสร้าง
copy()DataValidationBuilderสร้างเครื่องมือสร้างสำหรับกฎการตรวจสอบข้อมูลตามการตั้งค่าของกฎนี้
getAllowInvalid()Booleanแสดงผล true หากกฎแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูล หรือ false หากปฏิเสธอินพุตทั้งหมด
getCriteriaType()DataValidationCriteriaรับประเภทเกณฑ์ของกฎตามที่กำหนดไว้ใน enum ของ DataValidationCriteria
getCriteriaValues()Object[]รับอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์ของกฎ
getHelpText()Stringรับข้อความช่วยเหลือของกฎ หรือnullหากไม่มีการตั้งค่าข้อความช่วยเหลือ
requireCheckbox()DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดให้อินพุตเป็นค่าบูลีน โดยค่านี้จะแสดงผลเป็นช่องทำเครื่องหมาย
requireCheckbox(checkedValue)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดให้อินพุตเป็นค่าที่ระบุหรือเว้นว่างไว้
requireCheckbox(checkedValue, uncheckedValue)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเป็นค่าใดค่าหนึ่งที่ระบุ
requireDate()DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดวันที่
requireDateAfter(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่หลังจากค่าที่กำหนด
requireDateBefore(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ก่อนค่าที่กำหนด
requireDateBetween(start, end)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ที่อยู่ระหว่าง 2 หรือ 2 วันที่ระบุ
requireDateEqualTo(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่เท่ากับค่าที่กำหนด
requireDateNotBetween(start, end)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ที่ไม่อยู่ระหว่าง และไม่ใช่วันที่ที่ระบุทั้งสองวัน
requireDateOnOrAfter(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ในหรือหลังจากค่าที่ระบุ
requireDateOnOrBefore(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ในหรือก่อนค่าที่ระบุ
requireFormulaSatisfied(formula)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้สูตรที่ระบุต้องประมวลผลเป็น true
requireNumberBetween(start, end)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่อยู่ระหว่าง 2 หรือ 2 หมายเลขที่ระบุ
requireNumberEqualTo(number)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขเท่ากับค่าที่กำหนด
requireNumberGreaterThan(number)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดให้มีตัวเลขที่มากกว่าค่าที่กำหนด
requireNumberGreaterThanOrEqualTo(number)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่มากกว่าหรือเท่ากับค่าที่กำหนด
requireNumberLessThan(number)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่น้อยกว่าค่าที่กำหนด
requireNumberLessThanOrEqualTo(number)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่น้อยกว่าหรือเท่ากับค่าที่กำหนด
requireNumberNotBetween(start, end)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่ไม่อยู่ระหว่าง และไม่ใช่ตัวเลขที่ระบุทั้ง 2 จำนวน
requireNumberNotEqualTo(number)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่ไม่เท่ากับค่าที่กำหนด
requireTextContains(text)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตมีค่าที่กำหนด
requireTextDoesNotContain(text)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตไม่มีค่าที่ระบุ
requireTextEqualTo(text)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าที่กำหนด
requireTextIsEmail()DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้ข้อมูลที่ป้อนอยู่ในรูปแบบอีเมล
requireTextIsUrl()DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตอยู่ในรูปแบบของ URL
requireValueInList(values)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าใดค่าหนึ่งที่ระบุ
requireValueInList(values, showDropdown)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าใดค่าหนึ่งที่ระบุ พร้อมด้วยตัวเลือกในการซ่อนเมนูแบบเลื่อนลง
requireValueInRange(range)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าในช่วงที่กำหนด
requireValueInRange(range, showDropdown)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าในช่วงที่กำหนด โดยมีตัวเลือกให้ซ่อนเมนูแบบเลื่อนลง
setAllowInvalid(allowInvalidData)DataValidationBuilderตั้งค่าว่าจะแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูลไหม หรือว่าจะปฏิเสธอินพุตทั้งหมดเลยหรือไม่
setHelpText(helpText)DataValidationBuilderตั้งค่าข้อความช่วยเหลือที่จะปรากฏเมื่อผู้ใช้วางเมาส์เหนือเซลล์ที่ตั้งค่าการตรวจสอบข้อมูลไว้
withCriteria(criteria, args)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเป็นเกณฑ์ที่กำหนดโดยค่า DataValidationCriteria ซึ่งโดยปกติแล้วจะนำมาจาก criteria และ arguments ของกฎที่มีอยู่

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

build()

สร้างกฎการตรวจสอบข้อมูลจากการตั้งค่าที่ใช้กับเครื่องมือสร้าง

รีเทิร์น

DataValidation — การนำเสนอกฎการตรวจสอบข้อมูล

copy()

สร้างเครื่องมือสร้างสำหรับกฎการตรวจสอบข้อมูลตามการตั้งค่าของกฎนี้ 

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างตามการตั้งค่าของกฎนี้

getAllowInvalid()

แสดงผล true หากกฎแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูล หรือ false หากปฏิเสธอินพุตทั้งหมด ค่าเริ่มต้นสำหรับกฎการตรวจสอบข้อมูลใหม่คือ true

รีเทิร์น

Boolean — true หากกฎอนุญาตอินพุตที่ไม่ผ่านการตรวจสอบข้อมูล false หากไม่เป็นเช่นนั้น

getCriteriaType()

รับประเภทเกณฑ์ของกฎตามที่กำหนดไว้ใน enum ของ DataValidationCriteria หากต้องการดูอาร์กิวเมนต์สำหรับเกณฑ์ ให้ใช้ getCriteriaValues() หากต้องการใช้ค่าเหล่านี้เพื่อสร้างหรือแก้ไขกฎการตรวจสอบข้อมูล โปรดดู withCriteria(criteria, args) 

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

รีเทิร์น

DataValidationCriteria — ประเภทของเกณฑ์การตรวจสอบข้อมูล

getCriteriaValues()

รับอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์ของกฎ หากต้องการดูประเภทเกณฑ์ ให้ใช้ getCriteriaType() หากต้องการใช้ค่าเหล่านี้เพื่อสร้างหรือแก้ไขกฎการตรวจสอบข้อมูล ให้ดูที่ withCriteria(criteria, args) 

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

รีเทิร์น

Object[] — อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะกับประเภทเกณฑ์ของกฎ จำนวนอาร์กิวเมนต์และประเภทตรงกับเมธอด require...() ที่เกี่ยวข้องของคลาส DataValidationBuilder

getHelpText()

รับข้อความช่วยเหลือของกฎ หรือnullหากไม่มีการตั้งค่าข้อความช่วยเหลือ

รีเทิร์น

String — ข้อความช่วยเหลือของกฎ หรือ null ถ้าไม่ได้ตั้งค่าข้อความช่วยเหลือไว้

requireCheckbox()

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

// Set the data validation for cell A1 to require a boolean value; the value is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireCheckbox(checkedValue)

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

// Set the data validation for cell A1 to require a custom checked value that is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
checkedValueObjectค่าที่กําหนดให้กับช่องที่ทำเครื่องหมาย

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireCheckbox(checkedValue, uncheckedValue)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเป็นค่าใดค่าหนึ่งที่ระบุ เมื่ออินพุตคือ checkedValue เซลล์จะแสดงผลเป็นช่องทำเครื่องหมายที่เลือก เมื่ออินพุตคือ uncheckedValue เซลล์จะแสดงผลเป็นช่องทำเครื่องหมายที่ไม่ได้ทำเครื่องหมาย 

// Set the data validation for cell A1 to require custom checked values that are rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
checkedValueObjectค่าที่กําหนดให้กับช่องที่ทำเครื่องหมาย
uncheckedValueObjectค่าที่กําหนดให้กับช่องที่ไม่ได้ทำเครื่องหมาย

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireDate()

ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดวันที่ 

// Set the data validation for cell A1 to require a date.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireDateAfter(date)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่หลังจากค่าที่กำหนด ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะช่องวัน เดือน และปี 

// Set the data validation for cell A1 to require a date after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
dateDateวันที่ล่าสุดที่ระบบไม่ยอมรับ

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireDateBefore(date)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ก่อนค่าที่กำหนด ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะช่องวัน เดือน และปี 

// Set the data validation for cell A1 to require a date before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
dateDateวันที่แรกที่ยอมรับไม่ได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireDateBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ที่อยู่ระหว่าง 2 หรือ 2 วันที่ระบุ ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะช่องวัน เดือน และปี 

// Set the data validation for cell A1 to require a date in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
startDateวันที่แรกสุดที่ยอมรับได้
endDateวันที่ล่าสุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireDateEqualTo(date)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่เท่ากับค่าที่กำหนด ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะช่องวัน เดือน และปี 

// Set the data validation for cell A1 to require a date equal to January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013'))
    .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
dateDateวันที่ยอมรับเพียงอย่างเดียว

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireDateNotBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ที่ไม่อยู่ระหว่าง และไม่ใช่วันที่ที่ระบุทั้งสองวัน ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะช่องวัน เดือน และปี 

// Set the data validation for cell A1 to require a date not in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
startDateวันที่แรกที่ยอมรับไม่ได้
endDateวันที่ล่าสุดที่ระบบไม่ยอมรับ

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireDateOnOrAfter(date)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ในหรือหลังจากค่าที่ระบุ ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะช่องวัน เดือน และปี 

// Set the data validation for cell A1 to require a date on or after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
dateDateวันที่แรกสุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireDateOnOrBefore(date)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ในหรือก่อนค่าที่ระบุ ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะช่องวัน เดือน และปี 

// Set the data validation for cell A1 to require a date on or before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
dateDateวันที่ล่าสุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireFormulaSatisfied(formula)

ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้สูตรที่ระบุต้องประมวลผลเป็น true 

// Set the data validation for cell A1 to equal B1 with a custom formula.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
formulaStringสูตรที่กำหนดเองซึ่งจะประเมินเป็น true หากอินพุตถูกต้อง

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireNumberBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่อยู่ระหว่าง 2 หรือ 2 หมายเลขที่ระบุ 

// Set the data validation for cell A1 to require a number between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
startNumberค่าต่ำสุดที่ยอมรับได้
endNumberค่าสูงสุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireNumberEqualTo(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขเท่ากับค่าที่กำหนด 

// Set the data validation for cell A1 to require a number equal to 3.1415926536.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
numberNumberค่าที่ยอมรับได้เพียงค่าเดียว

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireNumberGreaterThan(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดให้มีตัวเลขที่มากกว่าค่าที่กำหนด 

// Set the data validation for cell A1 to require a number greater than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
numberNumberค่าสูงสุดที่ยอมรับไม่ได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireNumberGreaterThanOrEqualTo(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่มากกว่าหรือเท่ากับค่าที่กำหนด 

// Set the data validation for cell A1 to require a number greater than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
numberNumberค่าต่ำสุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireNumberLessThan(number)

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

// Set the data validation for cell A1 to require a number less than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
numberNumberค่าต่ำสุดที่ยอมรับไม่ได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireNumberLessThanOrEqualTo(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่น้อยกว่าหรือเท่ากับค่าที่กำหนด 

// Set the data validation for cell A1 to require a number less than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
numberNumberค่าสูงสุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireNumberNotBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่ไม่อยู่ระหว่าง และไม่ใช่ตัวเลขที่ระบุทั้ง 2 จำนวน 

// Set the data validation for cell A1 to require a number not between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
startNumberค่าต่ำสุดที่ยอมรับไม่ได้
endNumberค่าสูงสุดที่ยอมรับไม่ได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireNumberNotEqualTo(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่ไม่เท่ากับค่าที่กำหนด 

// Set the data validation for cell A1 to require a number not equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
numberNumberค่าที่ไม่ยอมรับเพียงอย่างเดียว

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireTextContains(text)

ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตมีค่าที่กำหนด 

// Set the data validation for cell A1 to require any value that includes "Google".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
textStringค่าที่ต้องมีในอินพุต

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireTextDoesNotContain(text)

ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตไม่มีค่าที่ระบุ 

// Set the data validation for cell A1 to require any value that does not include "@".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
textStringค่าที่ต้องไม่มีอยู่ในอินพุต

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireTextEqualTo(text)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าที่กำหนด 

// Set the data validation for cell A1 to require "Yes".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
textStringค่าที่ยอมรับได้เพียงค่าเดียว

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireTextIsEmail()

ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้ข้อมูลที่ป้อนอยู่ในรูปแบบอีเมล 

// Set the data validation for cell A1 to require text in the form of an email address.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireTextIsUrl()

ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตอยู่ในรูปแบบของ URL 

// Set the data validation for cell A1 to require text in the form of a URL.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireValueInList(values)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าใดค่าหนึ่งที่ระบุ 

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
valuesString[]อาร์เรย์ของค่าที่ยอมรับได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireValueInList(values, showDropdown)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าใดค่าหนึ่งที่ระบุ พร้อมด้วยตัวเลือกในการซ่อนเมนูแบบเลื่อนลง 

// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
valuesString[]อาร์เรย์ของค่าที่ยอมรับได้
showDropdownBooleantrue หากสเปรดชีตควรแสดงเมนูแบบเลื่อนลงสำหรับค่าดังกล่าว หรือให้ false หากไม่ต้องการ

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireValueInRange(range)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าในช่วงที่กำหนด 

// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
rangeRangeช่วงที่มีค่าที่ยอมรับได้

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

requireValueInRange(range, showDropdown)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าในช่วงที่กำหนด โดยมีตัวเลือกให้ซ่อนเมนูแบบเลื่อนลง 

// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
rangeRangeช่วงที่มีค่าที่ยอมรับได้
showDropdownBooleantrue หากสเปรดชีตควรแสดงเมนูแบบเลื่อนลงสำหรับค่าดังกล่าว หรือให้ false หากไม่ต้องการ

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

setAllowInvalid(allowInvalidData)

ตั้งค่าว่าจะแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูลไหม หรือว่าจะปฏิเสธอินพุตทั้งหมดเลยหรือไม่ ค่าเริ่มต้นสำหรับกฎการตรวจสอบข้อมูลใหม่คือ true

พารามิเตอร์

ชื่อTypeคำอธิบาย
allowInvalidDataBooleantrue หากกฎควรอนุญาตอินพุตที่ไม่ผ่านการตรวจสอบข้อมูล false หากไม่อนุญาต

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

setHelpText(helpText)

ตั้งค่าข้อความช่วยเหลือที่จะปรากฏเมื่อผู้ใช้วางเมาส์เหนือเซลล์ที่ตั้งค่าการตรวจสอบข้อมูลไว้

พารามิเตอร์

ชื่อTypeคำอธิบาย
helpTextStringข้อความช่วยเหลือที่จะตั้งค่า

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน

withCriteria(criteria, args)

ตั้งค่ากฎการตรวจสอบข้อมูลเป็นเกณฑ์ที่กำหนดโดยค่า DataValidationCriteria ซึ่งโดยปกติแล้วจะนำมาจาก criteria และ arguments ของกฎที่มีอยู่ 

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

พารามิเตอร์

ชื่อTypeคำอธิบาย
criteriaDataValidationCriteriaประเภทของเกณฑ์การตรวจสอบข้อมูล
argsObject[]อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะกับประเภทเกณฑ์ จำนวนอาร์กิวเมนต์และประเภทตรงกับเมธอด require...() ที่เกี่ยวข้องข้างต้น

รีเทิร์น

DataValidationBuilder — เครื่องมือสร้างนี้สำหรับการทำเชน