Class DataValidationBuilder

DataValidationBuilder

Compilador para reglas de validación de datos.

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

Métodos

Método	Tipo de datos que se muestra	Descripción breve
build()	DataValidation	Construye una regla de validación de datos a partir de la configuración aplicada al compilador.
copy()	DataValidationBuilder	Crea un compilador para una regla de validación de datos según la configuración de esta regla.
getAllowInvalid()	Boolean	Muestra true si la regla muestra una advertencia cuando la entrada falla en la validación de datos, o false si la rechaza por completo.
getCriteriaType()	DataValidationCriteria	Obtiene el tipo de criterio de la regla como se define en la enumeración DataValidationCriteria.
getCriteriaValues()	Object[]	Obtiene un array de argumentos para los criterios de la regla.
getHelpText()	String	Obtiene el texto de ayuda de la regla o null si no se configuró ningún texto de ayuda.
requireCheckbox()	DataValidationBuilder	Configura la regla de validación de datos para que requiera que la entrada sea un valor booleano; este valor se renderiza como una casilla de verificación.
requireCheckbox(checkedValue)	DataValidationBuilder	Configura la regla de validación de datos para que se requiera que la entrada sea el valor especificado o que esté en blanco.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	Configura la regla de validación de datos para exigir que la entrada sea uno de los valores especificados.
requireDate()	DataValidationBuilder	Configura la regla de validación de datos para que requiera una fecha.
requireDateAfter(date)	DataValidationBuilder	Configura la regla de validación de datos para que requiera una fecha posterior al valor determinado.
requireDateBefore(date)	DataValidationBuilder	Configura la regla de validación de datos para que requiera una fecha anterior al valor determinado.
requireDateBetween(start, end)	DataValidationBuilder	Configura la regla de validación de datos para que requiera una fecha que se encuentre entre dos fechas especificadas o sea una de dos.
requireDateEqualTo(date)	DataValidationBuilder	Configura la regla de validación de datos para que requiera una fecha igual al valor determinado.
requireDateNotBetween(start, end)	DataValidationBuilder	Configura la regla de validación de datos para que requiera una fecha que no esté entre dos fechas especificadas ni que no sea ninguna de ellas.
requireDateOnOrAfter(date)	DataValidationBuilder	Configura la regla de validación de datos para que requiera una fecha que coincida con el valor determinado o posterior.
requireDateOnOrBefore(date)	DataValidationBuilder	Configura la regla de validación de datos para que requiera una fecha igual o anterior al valor determinado.
requireFormulaSatisfied(formula)	DataValidationBuilder	Configura la regla de validación de datos para que la fórmula dada se evalúe como true.
requireNumberBetween(start, end)	DataValidationBuilder	Configura la regla de validación de datos para que requiera un número que se encuentre entre dos números especificados o sea uno de ellos.
requireNumberEqualTo(number)	DataValidationBuilder	Configura la regla de validación de datos para que requiera un número igual al valor determinado.
requireNumberGreaterThan(number)	DataValidationBuilder	Configura la regla de validación de datos para que requiera un número mayor que el valor determinado.
requireNumberGreaterThanOrEqualTo(number)	DataValidationBuilder	Configura la regla de validación de datos para que requiera un número mayor o igual que el valor determinado.
requireNumberLessThan(number)	DataValidationBuilder	Configura la regla de validación de datos para que requiera un número menor que el valor determinado.
requireNumberLessThanOrEqualTo(number)	DataValidationBuilder	Configura la regla de validación de datos para que requiera un número menor o igual que el valor determinado.
requireNumberNotBetween(start, end)	DataValidationBuilder	Configura la regla de validación de datos para que requiera un número que no se encuentre entre dos números especificados ni que sea ninguno de ellos.
requireNumberNotEqualTo(number)	DataValidationBuilder	Configura la regla de validación de datos para que requiera un número que no sea igual al valor determinado.
requireTextContains(text)	DataValidationBuilder	Configura la regla de validación de datos para que exija que la entrada contenga el valor determinado.
requireTextDoesNotContain(text)	DataValidationBuilder	Configura la regla de validación de datos para que exija que la entrada no contenga el valor determinado.
requireTextEqualTo(text)	DataValidationBuilder	Configura la regla de validación de datos para exigir que la entrada sea igual al valor determinado.
requireTextIsEmail()	DataValidationBuilder	Configura la regla de validación de datos para que exija que la entrada tenga el formato de una dirección de correo electrónico.
requireTextIsUrl()	DataValidationBuilder	Configura la regla de validación de datos para que requiera que la entrada tenga el formato de una URL.
requireValueInList(values)	DataValidationBuilder	Configura la regla de validación de datos para exigir que la entrada sea igual a uno de los valores dados.
requireValueInList(values, showDropdown)	DataValidationBuilder	Configura la regla de validación de datos para exigir que la entrada sea igual a uno de los valores dados, con una opción para ocultar el menú desplegable.
requireValueInRange(range)	DataValidationBuilder	Configura la regla de validación de datos para que exija que la entrada sea igual a un valor en el rango dado.
requireValueInRange(range, showDropdown)	DataValidationBuilder	Configura la regla de validación de datos para que exija que la entrada sea igual a un valor en el rango dado, con la opción de ocultar el menú desplegable.
setAllowInvalid(allowInvalidData)	DataValidationBuilder	Establece si se muestra una advertencia cuando la entrada falla en la validación de datos o si se rechaza por completo.
setHelpText(helpText)	DataValidationBuilder	Establece el texto de ayuda que aparece cuando el usuario se desplaza sobre la celda en la que se configuró la validación de datos.
withCriteria(criteria, args)	DataValidationBuilder	Configura la regla de validación de datos en los criterios definidos por los valores de DataValidationCriteria, que por lo general se toman de criteria y arguments de una regla existente.

Documentación detallada

build()

Construye una regla de validación de datos a partir de la configuración aplicada al compilador.

Devolvedor

DataValidation: Es una representación de la regla de validación de datos.

---

copy()

Crea un compilador para una regla de validación de datos según la configuración de esta regla.

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

Devolvedor

DataValidationBuilder: Es un compilador basado en la configuración de esta regla.

---

getAllowInvalid()

Muestra true si la regla muestra una advertencia cuando la entrada falla en la validación de datos, o false si la rechaza por completo. El valor predeterminado para las reglas de validación de datos nuevas es true.

Devolvedor

Boolean: true si la regla permite entradas que no pasan la validación de datos; false si no es así.

---

getCriteriaType()

Obtiene el tipo de criterio de la regla como se define en la enumeración DataValidationCriteria. Para obtener los argumentos de los criterios, usa getCriteriaValues(). Si quieres usar estos valores para crear o modificar una regla de validación de datos, consulta 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.')
}

Devolvedor

DataValidationCriteria: Es el tipo de criterios de validación de datos.

---

getCriteriaValues()

Obtiene un array de argumentos para los criterios de la regla. Para obtener el tipo de criterio, usa getCriteriaType(). Si quieres usar estos valores para crear o modificar una regla de validación de datos, consulta 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.')
}

Devolvedor

Object[]: Es un array de argumentos apropiado para el tipo de criterio de la regla; la cantidad de argumentos y su tipo coinciden con el método require...() correspondiente de la clase DataValidationBuilder.

---

getHelpText()

Obtiene el texto de ayuda de la regla o null si no se configuró ningún texto de ayuda.

Devolvedor

String: Es el texto de ayuda de la regla, o bien null si no se configuró un texto de ayuda.

---

requireCheckbox()

Configura la regla de validación de datos para que requiera que la entrada sea un valor booleano; este valor se renderiza como una casilla de verificación.

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

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireCheckbox(checkedValue)

Configura la regla de validación de datos para que se requiera que la entrada sea el valor especificado o que esté en blanco. Cuando la entrada coincide con el valor especificado, la celda se renderiza como una casilla de verificación marcada. Cuando la entrada está en blanco, la celda se renderiza como una casilla de verificación sin marcar.

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

Parámetros

Nombre	Tipo	Descripción
checkedValue	Object	Es el valor asignado a una casilla de verificación.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireCheckbox(checkedValue, uncheckedValue)

Configura la regla de validación de datos para exigir que la entrada sea uno de los valores especificados. Cuando la entrada es checkedValue, la celda se renderiza como una casilla de verificación marcada. Cuando la entrada es uncheckedValue, la celda se renderiza como una casilla de verificación sin marcar.

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

Parámetros

Nombre	Tipo	Descripción
checkedValue	Object	Es el valor asignado a una casilla de verificación.
uncheckedValue	Object	El valor asignado a una casilla desmarcada.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireDate()

Configura la regla de validación de datos para que requiera una fecha.

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

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireDateAfter(date)

Configura la regla de validación de datos para que requiera una fecha posterior al valor determinado. Se ignoran los campos temporales del objeto Date. Solo se usan los campos de día, mes y año.

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

Parámetros

Nombre	Tipo	Descripción
date	Date	La fecha inaceptable más reciente.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireDateBefore(date)

Configura la regla de validación de datos para que requiera una fecha anterior al valor determinado. Se ignoran los campos temporales del objeto Date. Solo se usan los campos de día, mes y año.

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

Parámetros

Nombre	Tipo	Descripción
date	Date	La fecha más temprana inaceptable.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireDateBetween(start, end)

Configura la regla de validación de datos para que requiera una fecha que se encuentre entre dos fechas especificadas o sea una de dos. Se ignoran los campos temporales de los objetos Date. Solo se usan los campos de día, mes y año.

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

Parámetros

Nombre	Tipo	Descripción
start	Date	La fecha más temprana aceptable.
end	Date	La última fecha aceptable.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireDateEqualTo(date)

Configura la regla de validación de datos para que requiera una fecha igual al valor determinado. Se ignoran los campos temporales del objeto Date. Solo se usan los campos de día, mes y año.

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

Parámetros

Nombre	Tipo	Descripción
date	Date	La única fecha aceptable.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireDateNotBetween(start, end)

Configura la regla de validación de datos para que requiera una fecha que no esté entre dos fechas especificadas ni que no sea ninguna de ellas. Se ignoran los campos temporales de los objetos Date. Solo se usan los campos de día, mes y año.

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

Parámetros

Nombre	Tipo	Descripción
start	Date	La fecha más temprana inaceptable.
end	Date	La fecha inaceptable más reciente.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireDateOnOrAfter(date)

Configura la regla de validación de datos para que requiera una fecha que coincida con el valor determinado o posterior. Se ignoran los campos temporales del objeto Date. Solo se usan los campos de día, mes y año.

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

Parámetros

Nombre	Tipo	Descripción
date	Date	La fecha más temprana aceptable.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireDateOnOrBefore(date)

Configura la regla de validación de datos para que requiera una fecha igual o anterior al valor determinado. Se ignoran los campos temporales del objeto Date. Solo se usan los campos de día, mes y año.

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

Parámetros

Nombre	Tipo	Descripción
date	Date	La última fecha aceptable.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireFormulaSatisfied(formula)

Configura la regla de validación de datos para que la fórmula dada se evalúe como 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);

Parámetros

Nombre	Tipo	Descripción
formula	String	Una fórmula personalizada que se evalúa como true si la entrada es válida.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireNumberBetween(start, end)

Configura la regla de validación de datos para que requiera un número que se encuentre entre dos números especificados o sea uno de ellos.

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

Parámetros

Nombre	Tipo	Descripción
start	Number	El valor aceptable más bajo.
end	Number	Es el valor aceptable más alto.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireNumberEqualTo(number)

Configura la regla de validación de datos para que requiera un número igual al valor determinado.

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

Parámetros

Nombre	Tipo	Descripción
number	Number	Es el único valor aceptable.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireNumberGreaterThan(number)

Configura la regla de validación de datos para que requiera un número mayor que el valor determinado.

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

Parámetros

Nombre	Tipo	Descripción
number	Number	Es el valor inaceptable más alto.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireNumberGreaterThanOrEqualTo(number)

Configura la regla de validación de datos para que requiera un número mayor o igual que el valor determinado.

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

Parámetros

Nombre	Tipo	Descripción
number	Number	El valor aceptable más bajo.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireNumberLessThan(number)

Configura la regla de validación de datos para que requiera un número menor que el valor determinado.

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

Parámetros

Nombre	Tipo	Descripción
number	Number	El valor inaceptable más bajo.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireNumberLessThanOrEqualTo(number)

Configura la regla de validación de datos para que requiera un número menor o igual que el valor determinado.

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

Parámetros

Nombre	Tipo	Descripción
number	Number	Es el valor aceptable más alto.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireNumberNotBetween(start, end)

Configura la regla de validación de datos para que requiera un número que no se encuentre entre dos números especificados ni que sea ninguno de ellos.

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

Parámetros

Nombre	Tipo	Descripción
start	Number	El valor inaceptable más bajo.
end	Number	Es el valor inaceptable más alto.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireNumberNotEqualTo(number)

Configura la regla de validación de datos para que requiera un número que no sea igual al valor determinado.

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

Parámetros

Nombre	Tipo	Descripción
number	Number	El único valor inaceptable.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireTextContains(text)

Configura la regla de validación de datos para que exija que la entrada contenga el valor determinado.

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

Parámetros

Nombre	Tipo	Descripción
text	String	Valor que debe contener la entrada.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireTextDoesNotContain(text)

Configura la regla de validación de datos para que exija que la entrada no contenga el valor determinado.

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

Parámetros

Nombre	Tipo	Descripción
text	String	Valor que no debe contener la entrada.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireTextEqualTo(text)

Configura la regla de validación de datos para exigir que la entrada sea igual al valor determinado.

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

Parámetros

Nombre	Tipo	Descripción
text	String	Es el único valor aceptable.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireTextIsEmail()

Configura la regla de validación de datos para que exija que la entrada tenga el formato de una dirección de correo electrónico.

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

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireTextIsUrl()

Configura la regla de validación de datos para que requiera que la entrada tenga el formato de una 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);

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireValueInList(values)

Configura la regla de validación de datos para exigir que la entrada sea igual a uno de los valores dados.

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

Parámetros

Nombre	Tipo	Descripción
values	String[]	Matriz de valores aceptables

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireValueInList(values, showDropdown)

Configura la regla de validación de datos para exigir que la entrada sea igual a uno de los valores dados, con una opción para ocultar el menú desplegable.

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

Parámetros

Nombre	Tipo	Descripción
values	String[]	Matriz de valores aceptables
showDropdown	Boolean	true si la hoja de cálculo debe mostrar un menú desplegable para los valores; false si no lo hace.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireValueInRange(range)

Configura la regla de validación de datos para que exija que la entrada sea igual a un valor en el rango dado.

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

Parámetros

Nombre	Tipo	Descripción
range	Range	Es un rango que contiene los valores aceptables.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

requireValueInRange(range, showDropdown)

Configura la regla de validación de datos para que exija que la entrada sea igual a un valor en el rango dado, con la opción de ocultar el menú desplegable.

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

Parámetros

Nombre	Tipo	Descripción
range	Range	Es un rango que contiene los valores aceptables.
showDropdown	Boolean	true si la hoja de cálculo debe mostrar un menú desplegable para los valores; false si no lo hace.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

setAllowInvalid(allowInvalidData)

Establece si se muestra una advertencia cuando la entrada falla en la validación de datos o si se rechaza por completo. El valor predeterminado para las reglas de validación de datos nuevas es true.

Parámetros

Nombre	Tipo	Descripción
allowInvalidData	Boolean	true si la regla debe permitir entradas que fallen en la validación de datos; false si no lo hace.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

setHelpText(helpText)

Establece el texto de ayuda que aparece cuando el usuario se desplaza sobre la celda en la que se configuró la validación de datos.

Parámetros

Nombre	Tipo	Descripción
helpText	String	El texto de ayuda que se establecerá.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.

---

withCriteria(criteria, args)

Configura la regla de validación de datos en los criterios definidos por los valores de DataValidationCriteria, que por lo general se toman de criteria y arguments de una regla existente.

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

Parámetros

Nombre	Tipo	Descripción
criteria	DataValidationCriteria	Es el tipo de criterios de validación de datos.
args	Object[]	Un array de argumentos apropiado para el tipo de criterio; la cantidad de argumentos y su tipo coinciden con el método require...() correspondiente anterior.

Devolvedor

DataValidationBuilder: Este compilador se usa para encadenar.