Class DataValidationBuilder

DataValidationBuilder

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

// 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);

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
build()	DataValidation	Tạo quy tắc xác thực dữ liệu từ chế độ cài đặt áp dụng cho trình tạo.
copy()	DataValidationBuilder	Tạo trình tạo cho quy tắc xác thực dữ liệu dựa trên chế độ cài đặt của quy tắc này.
getAllowInvalid()	Boolean	Trả về true nếu quy tắc hiển thị cảnh báo khi dữ liệu nhập không thành công hoặc false nếu quy tắc từ chối hoàn toàn 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 loạt các đối số cho các tiêu chí của quy tắc đó.
getHelpText()	String	Nhận văn bản trợ giúp của quy tắc hoặc null nếu chưa đặt văn bản trợ giúp nào.
requireCheckbox()	DataValidationBuilder	Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là giá trị boolean; giá trị này được hiển thị dưới dạng hộp đánh dấu.
requireCheckbox(checkedValue)	DataValidationBuilder	Thiết lập 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 để trống.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	Thiết lập 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ị đã chỉ định.
requireDate()	DataValidationBuilder	Thiết lập quy tắc xác thực dữ liệu bắt buộc phải có ngày.
requireDateAfter(date)	DataValidationBuilder	Thiết lập 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	Thiết lập quy tắc xác thực dữ liệu yêu cầu phải có 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 ngày nằm trong khoảng hoặc là một trong hai ngày đã chỉ định.
requireDateEqualTo(date)	DataValidationBuilder	Thiết lập quy tắc xác thực dữ liệu yêu cầu một 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 nằm trong hai ngày đã chỉ định.
requireDateOnOrAfter(date)	DataValidationBuilder	Thiết lập 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	Thiết lập 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	Thiết lập quy tắc xác thực dữ liệu yêu cầu công thức đã cho có giá trị là 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 trong hoặc là một trong hai số được chỉ định.
requireNumberEqualTo(number)	DataValidationBuilder	Thiết lập 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	Thiết lập 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	Thiết lập 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	Thiết lập 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	Thiết lập 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 nằm trong hai số được chỉ định.
requireNumberNotEqualTo(number)	DataValidationBuilder	Thiết lập 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	Thiết lập 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	Thiết lập 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	Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng với giá trị đã cho.
requireTextIsEmail()	DataValidationBuilder	Thiết lập 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	Thiết lập 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	Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng một trong các giá trị đã cho.
requireValueInList(values, showDropdown)	DataValidationBuilder	Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng với một trong các giá trị đã cho, với tuỳ chọn ẩn trình đơn thả xuống.
requireValueInRange(range)	DataValidationBuilder	Thiết lập quy tắc xác thực dữ liệu để yêu cầu giá trị nhập vào bằng một giá trị trong phạm vi đã cho.
requireValueInRange(range, showDropdown)	DataValidationBuilder	Thiết lập 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 một giá trị trong dải ô đã cho, với tuỳ chọn ẩn trình đơn thả xuống.
setAllowInvalid(allowInvalidData)	DataValidationBuilder	Thiết lập xem có hiển thị cảnh báo khi dữ liệu nhập không thành công hay không hoặc có từ chối toàn bộ dữ liệu đầu vào hay không.
setHelpText(helpText)	DataValidationBuilder	Thiết lập văn bản trợ giúp xuất hiện khi người dùng di chuột qua ô đã đặ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í được xác định bằng các giá trị DataValidationCriteria, 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 quy tắc xác thực dữ liệu từ chế độ cài đặt áp dụng cho trình tạo.

Cầu thủ trả bóng

DataValidation — nội dung trình bày quy tắc xác thực dữ liệu

---

copy()

Tạo trình tạo cho quy tắc xác thực dữ liệu dựa trên 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.
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);

Cầu thủ trả bóng

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

---

getAllowInvalid()

Trả về true nếu quy tắc hiển thị cảnh báo khi dữ liệu nhập không thành công hoặc false nếu quy tắc từ chối hoàn toàn dữ liệu đầu vào. Theo mặc định cho các 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 nhập dữ liệu không thành công; false nếu không xác thực được dữ liệu

---

getCriteriaType()

Lấy loại tiêu chí của quy tắc như được xác định trong enum DataValidationCriteria. Để lấy đối số cho tiêu chí, hãy sử dụng getCriteriaValues(). Nếu bạn muốn dùng các giá trị này để tạo hoặc sửa đổi 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.
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.')
}

Cầu thủ trả bóng

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

---

getCriteriaValues()

Lấy một loạt các đối số cho các tiêu chí của quy tắc đó. Để xem 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 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.
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.')
}

Cầu thủ trả bóng

Object[] – một mảng các đố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()

Nhận văn bản trợ giúp của quy tắc hoặc null nếu chưa đặt văn bản trợ giúp nào.

Cầu thủ trả bóng

String — văn bản trợ giúp của quy tắc hoặc null nếu chưa đặt văn bản trợ giúp nào

---

requireCheckbox()

Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào là 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireCheckbox(checkedValue)

Thiết lập 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 để trống. Khi giá trị nhập 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 giá trị nhập trống, ô hiển thị dưới dạng hộp đánh dấu đã bỏ đánh dấu.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
checkedValue	Object	Giá trị được gán cho hộp đã đánh dấu.

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireCheckbox(checkedValue, uncheckedValue)

Thiết lập 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ị đã chỉ định. Khi giá trị nhập là checkedValue, ô này sẽ hiển thị dưới dạng hộp đánh dấu đã đánh dấu. Khi giá trị nhập là uncheckedValue, ô sẽ hiển thị dưới dạng hộp đánh dấu đã bỏ đánh dấu.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
checkedValue	Object	Giá trị được gán cho hộp đã đánh dấu.
uncheckedValue	Object	Giá trị được gán cho hộp đánh dấu.

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireDate()

Thiết lập quy tắc xác thực dữ liệu bắt buộc phải có ngày.

// 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);

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireDateAfter(date)

Thiết lập 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ỉ dùng các trường ngày, tháng và năm.

// 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);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireDateBefore(date)

Thiết lập quy tắc xác thực dữ liệu yêu cầu phải có 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ỉ dùng các trường ngày, tháng và năm.

// 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);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireDateBetween(start, end)

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

// 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);

Các tham số

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

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireDateEqualTo(date)

Thiết lập quy tắc xác thực dữ liệu yêu cầu một 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ỉ dùng các trường ngày, tháng và năm.

// 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);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

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 nằm trong hai ngày đã chỉ định. Các trường thời gian của đối tượng Date sẽ bị bỏ qua; chỉ dùng các trường ngày, tháng và năm.

// 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);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireDateOnOrAfter(date)

Thiết lập 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ỉ dùng các trường ngày, tháng và năm.

// 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);

Các tham số

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

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireDateOnOrBefore(date)

Thiết lập 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ỉ dùng các trường ngày, tháng và năm.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
date	Date	Ngày được chấp nhận mới nhất.

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireFormulaSatisfied(formula)

Thiết lập quy tắc xác thực dữ liệu yêu cầu công thức đã cho có giá trị là 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);

Các tham số

Tên	Loại	Nội dung mô tả
formula	String	Một công thức tuỳ chỉnh đánh giá là true nếu giá trị nhập vào là hợp lệ.

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireNumberBetween(start, end)

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

// 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);

Các tham số

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

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireNumberEqualTo(number)

Thiết lập 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireNumberGreaterThan(number)

Thiết lập 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireNumberGreaterThanOrEqualTo(number)

Thiết lập 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireNumberLessThan(number)

Thiết lập 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireNumberLessThanOrEqualTo(number)

Thiết lập 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung mô tả
number	Number	Giá trị cao nhất được chấp nhận.

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

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 nằm trong hai số được chỉ định.

// 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);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireNumberNotEqualTo(number)

Thiết lập 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireTextContains(text)

Thiết lập 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".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung mô tả
text	String	Giá trị mà giá trị nhập phải chứa.

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireTextDoesNotContain(text)

Thiết lập 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 "@".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung mô tả
text	String	Giá trị mà giá trị nhập không được chứa.

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireTextEqualTo(text)

Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng với giá trị đã cho.

// 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);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireTextIsEmail()

Thiết lập 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireTextIsUrl()

Thiết lập 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireValueInList(values)

Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung 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 để tạo chuỗi

---

requireValueInList(values, showDropdown)

Thiết lập quy tắc xác thực dữ liệu để yêu cầu dữ liệu đầu vào bằng với một trong các giá trị đã cho, với tuỳ 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung 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 hiển thị trình đơn thả xuống cho các giá trị; false nếu không thấy.

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

requireValueInRange(range)

Thiết lập quy tắc xác thực dữ liệu để yêu cầu giá trị nhập vào 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Các tham số

Tên	Loại	Nội dung mô tả
range	Range	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 để tạo chuỗi

---

requireValueInRange(range, showDropdown)

Thiết lập 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 một giá trị trong dải ô đã cho, với tuỳ 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build();
cell.setDataValidation(rule);

Các tham số

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

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

setAllowInvalid(allowInvalidData)

Thiết lập xem có hiển thị cảnh báo khi dữ liệu nhập không thành công hay không hoặc có từ chối toàn bộ dữ liệu đầu vào hay không. Theo mặc định cho các quy tắc xác thực dữ liệu mới là true.

Các tham số

Tên	Loại	Nội dung 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.

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

setHelpText(helpText)

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

Các tham số

Tên	Loại	Nội dung mô tả
helpText	String	Văn bản trợ giúp để thiết lập.

Cầu thủ trả bóng

DataValidationBuilder — trình tạo này để tạo chuỗi

---

withCriteria(criteria, args)

Đặt quy tắc xác thực dữ liệu thành tiêu chí được xác định bằng các giá trị DataValidationCriteria, 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.
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);

Các tham số

Tên	Loại	Nội dung 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 của các đối số đó khớp 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 để tạo chuỗi