Class DataValidationBuilder

DataValidationBuilder

Trình tạo 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.
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ứcLoại dữ liệu trả vềMô tả ngắn
build()DataValidationTạo quy tắc xác thực dữ liệu từ các chế độ cài đặt áp dụng cho trình tạo.
copy()DataValidationBuilderTạ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()BooleanTrả về true nếu quy tắc hiển thị cảnh báo khi xác thực dữ liệu đầu vào không thành công hoặc false nếu từ chối hoàn toàn dữ liệu đầu vào.
getCriteriaType()DataValidationCriteriaLấy loại tiêu chí của quy tắc như đã 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()StringNhận 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 nào.
requireCheckbox()DataValidationBuilderThiế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 là giá trị boolean; giá trị này là hiển thị dưới dạng một hộp đánh dấu.
requireCheckbox(checkedValue)DataValidationBuilderThiế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)DataValidationBuilderThiế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ị được chỉ định.
requireDate()DataValidationBuilderThiết lập quy tắc xác thực dữ liệu để yêu cầu có ngày.
requireDateAfter(date)DataValidationBuilderThiế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)DataValidationBuilderThiết lập quy tắc xác thực dữ liệu để yêu cầu 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 hoặc giữa hai các ngày cụ thể.
requireDateEqualTo(date)DataValidationBuilderThiết lập quy tắc xác thực dữ liệu để yêu cầu một ngày bằng giá trị đã cho.
requireDateNotBetween(start, end)DataValidationBuilderThiết lập quy tắc xác thực dữ liệu để yêu cầu ngày không nằm trong khoảng và không nằm trong khoảng 2 ngày cụ thể.
requireDateOnOrAfter(date)DataValidationBuilderThiết lập quy tắc xác thực dữ liệu để yêu cầu ngày vào hoặc sau giá trị đã cho.
requireDateOnOrBefore(date)DataValidationBuilderThiết lập quy tắc xác thực dữ liệu để quy tắc này yêu cầu 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 để 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 khoảng hoặc là một trong hai các số cụ thể.
requireNumberEqualTo(number)DataValidationBuilderThiết lập quy tắc xác thực dữ liệu để yêu cầu một số bằng 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 nằm trong khoảng nào là 2 số cụ thể.
requireNumberNotEqualTo(number)DataValidationBuilderThiế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)DataValidationBuilderThiế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 chứa giá trị đã cho.
requireTextDoesNotContain(text)DataValidationBuilderThiế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)DataValidationBuilderThiế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 giá trị đã cho.
requireTextIsEmail()DataValidationBuilderThiế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 ở dạng địa chỉ email.
requireTextIsUrl()DataValidationBuilderThiế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 có dạng URL.
requireValueInList(values)DataValidationBuilderThiế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 một trong các giá trị đã cho.
requireValueInList(values, showDropdown)DataValidationBuilderThiế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 một trong các giá trị đã cho, với tuỳ chọn ẩn trình đơn thả xuống.
requireValueInRange(range)DataValidationBuilderThiế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 một giá trị trong dải ô đã cho.
requireValueInRange(range, showDropdown)DataValidationBuilderThiế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 một giá trị trong phạm vi đã cho, với tuỳ chọn ẩn trình đơn thả xuống.
setAllowInvalid(allowInvalidData)DataValidationBuilderĐặt xem có hiển thị cảnh báo khi dữ liệu đầu vào không xác thực được hoặc có từ chối dữ liệu đầu vào hay không hoàn toàn.
setHelpText(helpText)DataValidationBuilderĐặt văn bản trợ giúp xuất hiện khi người dùng di chuột qua ô cần xác thực dữ liệu thiết lập.
withCriteria(criteria, args)DataValidationBuilderĐặt quy tắc xác thực dữ liệu thành các tiêu chí do giá trị DataValidationCriteria xác định, thường được lấy từ criteria và arguments của quy tắc hiện tại.

Tài liệu chi tiết

build()

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

Cầu thủ trả bóng

DataValidation — bản trình bày của 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 — 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 hiển thị cảnh báo khi xác thực dữ liệu đầu vào không thành công hoặc false nếu từ chối hoàn toàn 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 dữ liệu; false nếu không

getCriteriaType()

Lấy loại tiêu chí của quy tắc như đã xác định trong enum DataValidationCriteria. Để tải đối số cho các 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 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 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(). Nếu bạn muốn sử 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

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 của chúng 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 bạn 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 bạn chưa đặt văn bản trợ giúp

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 phải là giá trị boolean; giá trị này là hiển thị dưới dạng một 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. Thời gian giá trị đầu vào khớp với giá trị được chỉ định mà ô được kết xuất dưới dạng hộp đánh dấu đã đánh dấu. Khi giá trị nhập bị trống, ô hiển thị dưới dạng hộp đánh dấu không được đá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);

Tham số

TênLoạiMô tả
checkedValueObjectGiá trị được gán cho một hộp đã chọn.

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ị được chỉ định. Thời gian giá trị nhập là checkedValue ô hiển thị dưới dạng một hộp đánh dấu đã đánh dấu. Khi giá trị nhập là uncheckedValue ô hiển thị dưới dạng hộp đánh dấu không được đá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);

Tham số

TênLoạiMô tả
checkedValueObjectGiá trị được gán cho một hộp đã chọn.
uncheckedValueObjectGiá trị được gán cho một hộp chưa đá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 để yêu cầu 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. Trường thời gian của Đối tượng Date bị bỏ qua; chỉ sử 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);

Tham số

TênLoạiMô tả
dateDateNgày gần đây 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

requireDateBefore(date)

Thiết lập quy tắc xác thực dữ liệu để yêu cầu có một ngày trước giá trị đã cho. Trường thời gian của Đối tượng Date bị bỏ qua; chỉ sử 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);

Tham số

TênLoạiMô tả
dateDateNgà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 hoặc giữa hai các ngày cụ thể. Các trường thời gian của đối tượng Date bị bỏ qua; chỉ ngày, tháng và năm đều được sử dụng. 

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

Tham số

TênLoạiMô tả
startDateNgày sớm nhất được chấp nhận.
endDateNgày gần nhất có thể chấp nhận.

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 giá trị đã cho. Trường thời gian của đối tượng Date bị bỏ qua; chỉ sử 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);

Tham số

TênLoạiMô tả
dateDateNgà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)

Thiết lập quy tắc xác thực dữ liệu để yêu cầu ngày không nằm trong khoảng và không nằm trong khoảng 2 ngày cụ thể. Các trường thời gian của đối tượng Date bị bỏ qua; chỉ trong 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.
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);

Tham số

TênLoạiMô tả
startDateNgày sớm nhất không được chấp nhận.
endDateNgày gần đây 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

requireDateOnOrAfter(date)

Thiết lập quy tắc xác thực dữ liệu để yêu cầu ngày vào hoặc sau giá trị đã cho. Trường thời gian của đối tượng Date bị bỏ qua; chỉ sử 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);

Tham số

TênLoạiMô tả
dateDateNgày sớm nhất được chấp nhận.

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 để quy tắc này yêu cầu ngày vào hoặc trước giá trị đã cho. Trường thời gian của đối tượng Date sẽ bị bỏ qua; chỉ sử 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);

Tham số

TênLoạiMô tả
dateDateNgày gần nhất có thể chấp nhận.

Cầu thủ trả bóng

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

requireFormulaSatisfied(formula)

Đặt quy tắc xác thực dữ liệ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);

Tham số

TênLoạiMô tả
formulaStringMột công thức tuỳ chỉnh được đá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, để 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 khoảng hoặc là một trong hai các số cụ thể. 

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

Tham số

TênLoạiMô tả
startNumberGiá trị thấp nhất chấp nhận được.
endNumberGiá trị cao nhất chấp nhận được.

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

Tham số

TênLoạiMô tả
numberNumberGiá 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)

Đặ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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Tham số

TênLoạiMô tả
numberNumberGiá 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)

Đặ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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Tham số

TênLoạiMô tả
numberNumberGiá trị thấp nhất chấp nhận được.

Cầu thủ trả bóng

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

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

Tham số

TênLoạiMô tả
numberNumberGiá 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)

Đặ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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Tham số

TênLoạiMô tả
numberNumberGiá trị cao nhất chấp nhận được.

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 khoảng nào là 2 số cụ thể. 

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

Tham số

TênLoạiMô tả
startNumberGiá trị thấp nhất không được chấp nhận.
endNumberGiá 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);

Tham số

TênLoạiMô tả
numberNumberGiá 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 phải 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);

Tham số

TênLoạiMô tả
textStringGiá trị mà dữ liệu đầu vào phải có.

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

Tham số

TênLoạiMô tả
textStringGiá 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, để 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 phải bằng 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);

Tham số

TênLoạiMô tả
textStringGiá 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 phải ở 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 phải có 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 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build();
cell.setDataValidation(rule);

Tham số

TênLoạiMô tả
valuesString[]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 phải bằng 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);

Tham số

TênLoạiMô tả
valuesString[]Một mảng các giá trị được chấp nhận.
showDropdownBooleantrue 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.

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 dữ liệu đầu vào phải bằng một giá trị trong dải ô đã 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);

Tham số

TênLoạiMô tả
rangeRangeDả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 một giá trị trong phạm vi đã 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);

Tham số

TênLoạiMô tả
rangeRangeDải ô chứa các giá trị được chấp nhận.
showDropdownBooleantrue 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.

Cầu thủ trả bóng

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

setAllowInvalid(allowInvalidData)

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

Tham số

TênLoạiMô tả
allowInvalidDataBooleantrue 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, để tạo chuỗi

setHelpText(helpText)

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

Tham số

TênLoạiMô tả
helpTextStringVăn bản trợ giúp cần đặt.

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 các tiêu chí do giá trị DataValidationCriteria xác định, thường được lấy từ criteria và arguments của quy tắc hiện tại. 

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

Tham số

TênLoạiMô tả
criteriaDataValidationCriteriaLoại tiêu chí xác thực dữ liệu.
argsObject[]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 chúng 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