Class DataValidationBuilder

DataValidationBuilder

Trình tạo cho các quy tắc xác thực dữ liệu.

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

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
build()	DataValidation	Tạo một quy tắc xác thực dữ liệu từ các chế độ cài đặt được áp dụng cho trình tạo.
copy()	DataValidationBuilder	Tạo một trình tạo cho quy tắc xác thực dữ liệu dựa trên các chế độ cài đặt của quy tắc này.
getAllowInvalid()	Boolean	Trả về true nếu quy tắc cho thấy cảnh báo khi dữ liệu đầu vào không xác thực được dữ liệu hoặc false nếu quy tắc hoàn toàn từ chối dữ liệu đầu vào.
getCriteriaType()	DataValidationCriteria	Lấy loại tiêu chí của quy tắc như được xác định trong enum DataValidationCriteria.
getCriteriaValues()	Object[]	Lấy một mảng đối số cho tiêu chí của quy tắc.
getHelpText()	String	Lấy văn bản trợ giúp của quy tắc hoặc null nếu bạn chưa đặt văn bản trợ giúp.
requireCheckbox()	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là một giá trị boolean; giá trị này được hiển thị dưới dạng hộp đánh dấu.
requireCheckbox(checkedValue)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là giá trị được chỉ định hoặc giá trị trống.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là một trong các giá trị được chỉ định.
requireDate()	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày.
requireDateAfter(date)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày sau giá trị đã cho.
requireDateBefore(date)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày trước giá trị đã cho.
requireDateBetween(start, end)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày nằm trong khoảng hoặc là một trong hai ngày được chỉ định.
requireDateEqualTo(date)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu ngày bằng với giá trị đã cho.
requireDateNotBetween(start, end)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày không nằm trong khoảng và không phải là một trong hai ngày được chỉ định.
requireDateOnOrAfter(date)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày vào hoặc sau giá trị đã cho.
requireDateOnOrBefore(date)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày vào hoặc trước giá trị đã cho.
requireFormulaSatisfied(formula)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu công thức đã cho đánh giá thành true.
requireNumberBetween(start, end)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một số nằm giữa hoặc là một trong hai số đã chỉ định.
requireNumberEqualTo(number)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một số bằng với giá trị đã cho.
requireNumberGreaterThan(number)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một số lớn hơn giá trị đã cho.
requireNumberGreaterThanOrEqualTo(number)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một số lớn hơn hoặc bằng giá trị đã cho.
requireNumberLessThan(number)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một số nhỏ hơn giá trị đã cho.
requireNumberLessThanOrEqualTo(number)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một số nhỏ hơn hoặc bằng giá trị đã cho.
requireNumberNotBetween(start, end)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một số không nằm trong khoảng và không phải là một trong hai số đã chỉ định.
requireNumberNotEqualTo(number)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu một số không bằng giá trị đã cho.
requireTextContains(text)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào chứa giá trị đã cho.
requireTextDoesNotContain(text)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào không chứa giá trị đã cho.
requireTextEqualTo(text)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng với giá trị đã cho.
requireTextIsEmail()	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào ở dạng địa chỉ email.
requireTextIsUrl()	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào ở dạng URL.
requireValueInList(values)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng một trong các giá trị đã cho.
requireValueInList(values, showDropdown)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng một trong các giá trị đã cho, có lựa chọn ẩn trình đơn thả xuống.
requireValueInRange(range)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng một giá trị trong phạm vi đã cho.
requireValueInRange(range, showDropdown)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng một giá trị trong phạm vi đã cho, có lựa chọn ẩn trình đơn thả xuống.
setAllowInvalid(allowInvalidData)	DataValidationBuilder	Đặt xem có hiện cảnh báo khi dữ liệu đầu vào không xác thực được hay không, hoặc có từ chối hoàn toàn dữ liệu đầu vào hay không.
setHelpText(helpText)	DataValidationBuilder	Đặt văn bản trợ giúp xuất hiện khi người dùng di chuột lên ô mà bạn đã đặt tính năng xác thực dữ liệu.
withCriteria(criteria, args)	DataValidationBuilder	Đặt quy tắc xác thực dữ liệu thành tiêu chí do các giá trị DataValidationCriteria xác định, thường được lấy từ criteria và arguments của một quy tắc hiện có.

Tài liệu chi tiết

build()

Tạo một quy tắc xác thực dữ liệu từ các chế độ cài đặt được áp dụng cho trình tạo.

Cầu thủ trả bóng

DataValidation – biểu thị quy tắc xác thực dữ liệu

---

copy()

Tạo một trình tạo cho quy tắc xác thực dữ liệu dựa trên các chế độ cài đặt của quy tắc này.

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

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

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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);

Cầu thủ trả bóng

DataValidationBuilder – một trình tạo dựa trên các chế độ cài đặt của quy tắc này

---

getAllowInvalid()

Trả về true nếu quy tắc cho thấy cảnh báo khi dữ liệu đầu vào không xác thực được dữ liệu hoặc false nếu quy tắc hoàn toàn từ chối dữ liệu đầu vào. Giá trị mặc định cho quy tắc xác thực dữ liệu mới là true.

Cầu thủ trả bóng

Boolean – true nếu quy tắc cho phép dữ liệu đầu vào không xác thực được; false nếu không

---

getCriteriaType()

Lấy loại tiêu chí của quy tắc như được xác định trong enum DataValidationCriteria. Để lấy các đối số cho tiêu chí, hãy sử dụng getCriteriaValues(). Để sử dụng các giá trị này nhằm tạo hoặc sửa đổi một quy tắc xác thực dữ liệu, hãy xem withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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.');
}

Cầu thủ trả bóng

DataValidationCriteria – loại tiêu chí xác thực dữ liệu

---

getCriteriaValues()

Lấy một mảng đối số cho tiêu chí của quy tắc. Để lấy loại tiêu chí, hãy sử dụng getCriteriaType(). Để sử dụng các giá trị này nhằm tạo hoặc sửa đổi một quy tắc xác thực dữ liệu, hãy xem withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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.');
}

Cầu thủ trả bóng

Object[] – một mảng đối số phù hợp với loại tiêu chí của quy tắc; số lượng đối số và loại đối số khớp với phương thức require...() tương ứng của lớp DataValidationBuilder

---

getHelpText()

Lấy văn bản trợ giúp của quy tắc hoặc null nếu bạn chưa đặt văn bản trợ giúp.

Cầu thủ trả bóng

String – văn bản trợ giúp của quy tắc hoặc null nếu không có văn bản trợ giúp nào được đặt

---

requireCheckbox()

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là một giá trị boolean; giá trị này được hiển thị dưới dạng hộp đánh dấu.

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

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireCheckbox(checkedValue)

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là giá trị được chỉ định hoặc giá trị trống. Khi dữ liệu đầu vào khớp với giá trị đã chỉ định, ô sẽ hiển thị dưới dạng hộp đánh dấu đã đánh dấu. Khi đầu vào trống, ô sẽ hiển thị dưới dạng hộp đánh dấu chưa được đánh dấu.

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

Tham số

Tên	Loại	Mô tả
checkedValue	Object	Giá trị được chỉ định cho hộp đánh dấu.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireCheckbox(checkedValue, uncheckedValue)

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là một trong các giá trị được chỉ định. Khi đầu vào là checkedValue, ô sẽ hiển thị dưới dạng hộp đánh dấu đã đánh dấu. Khi đầu vào là uncheckedValue, ô sẽ hiển thị dưới dạng hộp đánh dấu chưa được đánh dấu.

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

Tham số

Tên	Loại	Mô tả
checkedValue	Object	Giá trị được chỉ định cho hộp đánh dấu.
uncheckedValue	Object	Giá trị được chỉ định cho một hộp chưa được đánh dấu.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireDate()

Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày.

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

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireDateAfter(date)

Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày sau giá trị đã cho. Các trường thời gian của đối tượng Date sẽ bị bỏ qua; chỉ các trường ngày, tháng và năm được sử dụng.

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

Tham số

Tên	Loại	Mô tả
date	Date	Ngày không được chấp nhận muộn nhất.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireDateBefore(date)

Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày trước giá trị đã cho. Các trường thời gian của đối tượng Date sẽ bị bỏ qua; chỉ các trường ngày, tháng và năm được sử dụng.

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

Tham số

Tên	Loại	Mô tả
date	Date	Ngày sớm nhất không được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireDateBetween(start, end)

Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày nằm trong khoảng hoặc là một trong hai ngày được chỉ định. Các trường thời gian của đối tượng Date sẽ bị bỏ qua; chỉ các trường ngày, tháng và năm được sử dụng.

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

Tham số

Tên	Loại	Mô tả
start	Date	Ngày sớm nhất có thể chấp nhận.
end	Date	Ngày chấp nhận muộn nhất.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireDateEqualTo(date)

Đặt quy tắc xác thực dữ liệu để yêu cầu ngày bằng với giá trị đã cho. Các trường thời gian của đối tượng Date sẽ bị bỏ qua; chỉ các trường ngày, tháng và năm được sử dụng.

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

Tham số

Tên	Loại	Mô tả
date	Date	Ngày duy nhất được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireDateNotBetween(start, end)

Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày không nằm trong khoảng và không phải là một trong hai ngày được chỉ định. Các trường thời gian của đối tượng Date sẽ bị bỏ qua; chỉ các trường ngày, tháng và năm được sử dụng.

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

Tham số

Tên	Loại	Mô tả
start	Date	Ngày sớm nhất không được chấp nhận.
end	Date	Ngày không được chấp nhận muộn nhất.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireDateOnOrAfter(date)

Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày vào hoặc sau giá trị đã cho. Các trường thời gian của đối tượng Date sẽ bị bỏ qua; chỉ các trường ngày, tháng và năm được sử dụng.

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

Tham số

Tên	Loại	Mô tả
date	Date	Ngày sớm nhất có thể chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireDateOnOrBefore(date)

Đặt quy tắc xác thực dữ liệu để yêu cầu một ngày vào hoặc trước giá trị đã cho. Các trường thời gian của đối tượng Date sẽ bị bỏ qua; chỉ các trường ngày, tháng và năm được sử dụng.

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

Tham số

Tên	Loại	Mô tả
date	Date	Ngày chấp nhận muộn nhất.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireFormulaSatisfied(formula)

Đặt quy tắc xác thực dữ liệu để yêu cầu công thức đã cho đánh giá thành true.

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

Tham số

Tên	Loại	Mô tả
formula	String	Một công thức tuỳ chỉnh đánh giá là true nếu dữ liệu đầu vào hợp lệ.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireNumberBetween(start, end)

Đặt quy tắc xác thực dữ liệu để yêu cầu một số nằm giữa hoặc là một trong hai số đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
start	Number	Giá trị thấp nhất được chấp nhận.
end	Number	Giá trị cao nhất có thể chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireNumberEqualTo(number)

Đặt quy tắc xác thực dữ liệu để yêu cầu một số bằng với giá trị đã cho.

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

Tham số

Tên	Loại	Mô tả
number	Number	Giá trị duy nhất được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireNumberGreaterThan(number)

Đặt quy tắc xác thực dữ liệu để yêu cầu một số lớn hơn giá trị đã cho.

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

Tham số

Tên	Loại	Mô tả
number	Number	Giá trị cao nhất không được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireNumberGreaterThanOrEqualTo(number)

Đặt quy tắc xác thực dữ liệu để yêu cầu một số lớn hơn hoặc bằng giá trị đã cho.

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

Tham số

Tên	Loại	Mô tả
number	Number	Giá trị thấp nhất được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireNumberLessThan(number)

Đặt quy tắc xác thực dữ liệu để yêu cầu một số nhỏ hơn giá trị đã cho.

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

Tham số

Tên	Loại	Mô tả
number	Number	Giá trị thấp nhất không được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireNumberLessThanOrEqualTo(number)

Đặt quy tắc xác thực dữ liệu để yêu cầu một số nhỏ hơn hoặc bằng giá trị đã cho.

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

Tham số

Tên	Loại	Mô tả
number	Number	Giá trị cao nhất có thể chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireNumberNotBetween(start, end)

Đặt quy tắc xác thực dữ liệu để yêu cầu một số không nằm trong khoảng và không phải là một trong hai số đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
start	Number	Giá trị thấp nhất không được chấp nhận.
end	Number	Giá trị cao nhất không được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireNumberNotEqualTo(number)

Đặt quy tắc xác thực dữ liệu để yêu cầu một số không bằng giá trị đã cho.

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

Tham số

Tên	Loại	Mô tả
number	Number	Giá trị duy nhất không được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireTextContains(text)

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào chứa giá trị đã cho.

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

Tham số

Tên	Loại	Mô tả
text	String	Giá trị mà dữ liệu đầu vào phải chứa.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireTextDoesNotContain(text)

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào không chứa giá trị đã cho.

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

Tham số

Tên	Loại	Mô tả
text	String	Giá trị mà dữ liệu đầu vào không được chứa.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireTextEqualTo(text)

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng với giá trị đã cho.

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

Tham số

Tên	Loại	Mô tả
text	String	Giá trị duy nhất được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireTextIsEmail()

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào ở dạng địa chỉ email.

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

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireTextIsUrl()

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào ở dạng URL.

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

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireValueInList(values)

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng một trong các giá trị đã cho.

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

Tham số

Tên	Loại	Mô tả
values	String[]	Một mảng các giá trị được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireValueInList(values, showDropdown)

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng một trong các giá trị đã cho, có lựa chọn ẩn trình đơn thả xuống.

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

Tham số

Tên	Loại	Mô tả
values	String[]	Một mảng các giá trị được chấp nhận.
showDropdown	Boolean	true nếu bảng tính phải hiện một trình đơn thả xuống cho các giá trị; false nếu không.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireValueInRange(range)

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng một giá trị trong phạm vi đã cho.

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

Tham số

Tên	Loại	Mô tả
range	Range	Một dải ô chứa các giá trị được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

requireValueInRange(range, showDropdown)

Đặt quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào phải bằng một giá trị trong phạm vi đã cho, có lựa chọn ẩn trình đơn thả xuống.

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

Tham số

Tên	Loại	Mô tả
range	Range	Một dải ô chứa các giá trị được chấp nhận.
showDropdown	Boolean	true nếu bảng tính phải hiện một trình đơn thả xuống cho các giá trị; false nếu không.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

setAllowInvalid(allowInvalidData)

Đặt xem có hiện cảnh báo khi dữ liệu đầu vào không xác thực được hay không, hoặc có từ chối hoàn toàn dữ liệu đầu vào hay không. Giá trị mặc định cho quy tắc xác thực dữ liệu mới là true.

Tham số

Tên	Loại	Mô tả
allowInvalidData	Boolean	true nếu quy tắc cho phép dữ liệu đầu vào không xác thực được dữ liệu; false nếu không.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

setHelpText(helpText)

Đặt văn bản trợ giúp xuất hiện khi người dùng di chuột lên ô mà bạn đã đặt tính năng xác thực dữ liệu.

Tham số

Tên	Loại	Mô tả
helpText	String	Văn bản trợ giúp cần đặt.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết

---

withCriteria(criteria, args)

Đặt quy tắc xác thực dữ liệu thành tiêu chí do các giá trị DataValidationCriteria xác định, thường được lấy từ criteria và arguments của một quy tắc hiện có.

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

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

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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);

Tham số

Tên	Loại	Mô tả
criteria	DataValidationCriteria	Loại tiêu chí xác thực dữ liệu.
args	Object[]	Một mảng các đối số phù hợp với loại tiêu chí; số lượng đối số và loại đối số tương ứng với phương thức require...() tương ứng ở trên.

Cầu thủ trả bóng

DataValidationBuilder – trình tạo này, để liên kết