Class DataValidationBuilder

DataValidationBuilder

डेटा की पुष्टि करने के नियमों को बनाने वाला टूल. 

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

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
build()DataValidationयह फ़ंक्शन, बिल्डर पर लागू की गई सेटिंग से डेटा की पुष्टि करने का नियम बनाता है.
copy()DataValidationBuilderयह नियम की सेटिंग के आधार पर, डेटा की पुष्टि करने के नियम के लिए बिल्डर बनाता है.
getAllowInvalid()Booleanअगर डेटा की पुष्टि न होने पर नियम के तहत चेतावनी दिखती है, तो यह फ़ंक्शन true दिखाता है. अगर इनपुट को पूरी तरह से अस्वीकार कर दिया जाता है, तो यह फ़ंक्शन false दिखाता है.
getCriteriaType()DataValidationCriteriaयह फ़ंक्शन, नियम के मानदंड का टाइप दिखाता है. यह टाइप, DataValidationCriteria enum में तय किया गया है.
getCriteriaValues()Object[]नियम के मानदंड के लिए, आर्ग्युमेंट की एक कैटगरी मिलती है.
getHelpText()Stringनियम के लिए सहायता टेक्स्ट मिलता है. अगर कोई सहायता टेक्स्ट सेट नहीं किया गया है, तो null मिलता है.
requireCheckbox()DataValidationBuilderडेटा की पुष्टि करने का नियम सेट करता है, ताकि इनपुट के तौर पर बूलियन वैल्यू डालना ज़रूरी हो; इस वैल्यू को चेकबॉक्स के तौर पर रेंडर किया जाता है.
requireCheckbox(checkedValue)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, तय की गई वैल्यू हो या खाली हो.
requireCheckbox(checkedValue, uncheckedValue)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, तय की गई वैल्यू में से कोई एक हो.
requireDate()DataValidationBuilderयह नीति, डेटा की पुष्टि करने वाले नियम को सेट करती है, ताकि तारीख डालना ज़रूरी हो.
requireDateAfter(date)DataValidationBuilderइस फ़ंक्शन की मदद से, डेटा की पुष्टि करने का ऐसा नियम सेट किया जाता है जिसमें दी गई वैल्यू के बाद की तारीख डालना ज़रूरी होता है.
requireDateBefore(date)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने वाले नियम को सेट करता है. इस नियम के तहत, दी गई वैल्यू से पहले की तारीख डालना ज़रूरी होता है.
requireDateBetween(start, end)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसके तहत, किसी सेल में ऐसी तारीख डालनी होती है जो दो तय की गई तारीखों के बीच की हो या उनमें से कोई एक हो.
requireDateEqualTo(date)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इस नियम के तहत, दी गई वैल्यू के बराबर तारीख डालना ज़रूरी होता है.
requireDateNotBetween(start, end)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसमें दो तारीखों के बीच की कोई तारीख शामिल नहीं होती है. साथ ही, यह भी ज़रूरी है कि वह तारीख, उन दो तारीखों में से कोई भी न हो.
requireDateOnOrAfter(date)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने के नियम को सेट करता है. इससे यह ज़रूरी हो जाता है कि दी गई वैल्यू के बराबर या उसके बाद की तारीख डाली जाए.
requireDateOnOrBefore(date)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि दी गई वैल्यू के बराबर या उससे पहले की तारीख डाली जाए.
requireFormulaSatisfied(formula)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि दिया गया फ़ॉर्मूला, true के तौर पर काम करे.
requireNumberBetween(start, end)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसके तहत, दो तय किए गए नंबरों के बीच का कोई नंबर या उनमें से कोई एक नंबर डालना ज़रूरी होता है.
requireNumberEqualTo(number)DataValidationBuilderडेटा की पुष्टि करने का नियम सेट करता है, ताकि दी गई वैल्यू के बराबर संख्या की ज़रूरत हो.
requireNumberGreaterThan(number)DataValidationBuilderइस विकल्प का इस्तेमाल करके, डेटा की पुष्टि करने का ऐसा नियम सेट किया जाता है जिसमें दी गई वैल्यू से ज़्यादा संख्या डालना ज़रूरी होता है.
requireNumberGreaterThanOrEqualTo(number)DataValidationBuilderडेटा की पुष्टि करने के नियम को सेट करता है, ताकि दी गई वैल्यू से ज़्यादा या उसके बराबर संख्या की ज़रूरत हो.
requireNumberLessThan(number)DataValidationBuilderडेटा की पुष्टि करने के लिए, यह नियम सेट करता है कि दी गई वैल्यू से कम संख्या डालनी होगी.
requireNumberLessThanOrEqualTo(number)DataValidationBuilderडेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि डाली गई वैल्यू, दी गई वैल्यू से कम या उसके बराबर हो.
requireNumberNotBetween(start, end)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने के नियम को सेट करता है. इससे यह ज़रूरी हो जाता है कि कोई संख्या, दो तय की गई संख्याओं के बीच में न हो और न ही उनके बराबर हो.
requireNumberNotEqualTo(number)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि दी गई वैल्यू के बराबर कोई संख्या न हो.
requireTextContains(text)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसके तहत, इनपुट में दी गई वैल्यू शामिल करना ज़रूरी होता है.
requireTextDoesNotContain(text)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसके तहत, इनपुट में दी गई वैल्यू शामिल नहीं होनी चाहिए.
requireTextEqualTo(text)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट की गई वैल्यू, दी गई वैल्यू के बराबर हो.
requireTextIsEmail()DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, ईमेल पते के फ़ॉर्मैट में हो.
requireTextIsUrl()DataValidationBuilderडेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, यूआरएल के फ़ॉर्म में हो.
requireValueInList(values)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट की वैल्यू, दी गई वैल्यू में से किसी एक के बराबर हो.
requireValueInList(values, showDropdown)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट की वैल्यू, दी गई वैल्यू में से किसी एक के बराबर हो. साथ ही, इसमें ड्रॉपडाउन मेन्यू को छिपाने का विकल्प भी होता है.
requireValueInRange(range)DataValidationBuilderडेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, दी गई रेंज में मौजूद किसी वैल्यू के बराबर हो.
requireValueInRange(range, showDropdown)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, दी गई रेंज में मौजूद किसी वैल्यू के बराबर हो. साथ ही, इसमें ड्रॉपडाउन मेन्यू को छिपाने का विकल्प भी होता है.
setAllowInvalid(allowInvalidData)DataValidationBuilderयह तय करता है कि डेटा की पुष्टि न होने पर, इनपुट के लिए चेतावनी दिखानी है या इनपुट को पूरी तरह से अस्वीकार करना है.
setHelpText(helpText)DataValidationBuilderयह विकल्प, उस सेल पर कर्सर घुमाने पर दिखने वाला सहायता टेक्स्ट सेट करता है जिस पर डेटा की पुष्टि करने की सुविधा सेट की गई है.
withCriteria(criteria, args)DataValidationBuilderयह फ़ंक्शन, डेटा की पुष्टि करने के नियम को DataValidationCriteria वैल्यू के हिसाब से तय की गई शर्तों पर सेट करता है. आम तौर पर, ये वैल्यू किसी मौजूदा नियम के criteria और arguments से ली जाती हैं.

ज़्यादा जानकारी वाला दस्तावेज़

build()

यह फ़ंक्शन, बिल्डर पर लागू की गई सेटिंग से डेटा की पुष्टि करने का नियम बनाता है.

वापसी का टिकट

DataValidation — डेटा की पुष्टि करने के नियम को दिखाने वाला आइकॉन

copy()

यह नियम की सेटिंग के आधार पर, डेटा की पुष्टि करने के नियम के लिए बिल्डर बनाता है. 

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
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);

वापसी का टिकट

DataValidationBuilder — इस नियम की सेटिंग के आधार पर बिल्डर

getAllowInvalid()

अगर डेटा की पुष्टि न होने पर नियम के तहत चेतावनी दिखती है, तो यह फ़ंक्शन true दिखाता है. अगर इनपुट को पूरी तरह से अस्वीकार कर दिया जाता है, तो यह फ़ंक्शन false दिखाता है. डेटा की पुष्टि करने के नए नियमों के लिए, डिफ़ॉल्ट सेटिंग true होती है.

वापसी का टिकट

Boolean — true अगर नियम में ऐसे इनपुट की अनुमति है जिनकी डेटा की पुष्टि नहीं हो पाती; false अगर ऐसा नहीं है

getCriteriaType()

यह फ़ंक्शन, नियम के मानदंड का टाइप दिखाता है. यह टाइप, DataValidationCriteria enum में तय किया गया है. शर्तों के लिए आर्ग्युमेंट पाने के लिए, getCriteriaValues() का इस्तेमाल करें. डेटा की पुष्टि करने वाले नियम को बनाने या उसमें बदलाव करने के लिए, इन वैल्यू का इस्तेमाल करने के बारे में जानने के लिए, 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.');
}

वापसी का टिकट

DataValidationCriteria — डेटा की पुष्टि करने की शर्तों का टाइप

getCriteriaValues()

नियम के मानदंड के लिए, आर्ग्युमेंट की एक कैटगरी मिलती है. मानदंड का टाइप पाने के लिए, getCriteriaType() का इस्तेमाल करें. डेटा की पुष्टि करने का नियम बनाने या उसमें बदलाव करने के लिए, इन वैल्यू का इस्तेमाल करने के बारे में जानने के लिए, 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.');
}

वापसी का टिकट

Object[] — यह नियम की शर्त के टाइप के हिसाब से, ऑर्ग्युमेंट का एक कलेक्शन होता है. ऑर्ग्युमेंट की संख्या और उनका टाइप, DataValidationBuilder क्लास के require...() तरीके से मेल खाता है

getHelpText()

नियम के लिए सहायता टेक्स्ट मिलता है. अगर कोई सहायता टेक्स्ट सेट नहीं किया गया है, तो null मिलता है.

वापसी का टिकट

String — नियम के बारे में जानकारी देने वाला टेक्स्ट या null, अगर कोई जानकारी देने वाला टेक्स्ट सेट नहीं किया गया है

requireCheckbox()

डेटा की पुष्टि करने का नियम सेट करता है, ताकि इनपुट के तौर पर बूलियन वैल्यू डालना ज़रूरी हो; इस वैल्यू को चेकबॉक्स के तौर पर रेंडर किया जाता है. 

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

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireCheckbox(checkedValue)

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, तय की गई वैल्यू हो या खाली हो. जब इनपुट, तय की गई वैल्यू से मैच करता है, तब सेल को चुने गए चेकबॉक्स के तौर पर रेंडर किया जाता है. जब इनपुट खाली होता है, तो सेल को बिना चुने गए चेकबॉक्स के तौर पर रेंडर किया जाता है. 

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

पैरामीटर

नामटाइपब्यौरा
checkedValueObjectचेक किए गए बॉक्स को असाइन की गई वैल्यू.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireCheckbox(checkedValue, uncheckedValue)

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, तय की गई वैल्यू में से कोई एक हो. जब इनपुट checkedValue होता है, तब सेल को चुने गए चेकबॉक्स के तौर पर रेंडर किया जाता है. जब इनपुट uncheckedValue होता है, तब सेल को ऐसे चेकबॉक्स के तौर पर रेंडर किया जाता है जिस पर सही का निशान नहीं लगा होता. 

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

पैरामीटर

नामटाइपब्यौरा
checkedValueObjectचेक किए गए बॉक्स को असाइन की गई वैल्यू.
uncheckedValueObjectयह उस बॉक्स को असाइन की गई वैल्यू है जिस पर सही का निशान नहीं लगा है.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireDate()

यह नीति, डेटा की पुष्टि करने वाले नियम को सेट करती है, ताकि तारीख डालना ज़रूरी हो. 

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

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireDateAfter(date)

इस फ़ंक्शन की मदद से, डेटा की पुष्टि करने का ऐसा नियम सेट किया जाता है जिसमें दी गई वैल्यू के बाद की तारीख डालना ज़रूरी होता है. Date ऑब्जेक्ट के समय वाले फ़ील्ड को अनदेखा किया जाता है. सिर्फ़ दिन, महीने, और साल वाले फ़ील्ड का इस्तेमाल किया जाता है. 

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

पैरामीटर

नामटाइपब्यौरा
dateDateयह वह तारीख है जिसके बाद, इस समस्या को ठीक नहीं किया जा सकता.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireDateBefore(date)

यह फ़ंक्शन, डेटा की पुष्टि करने वाले नियम को सेट करता है. इस नियम के तहत, दी गई वैल्यू से पहले की तारीख डालना ज़रूरी होता है. Date ऑब्जेक्ट के समय वाले फ़ील्ड को अनदेखा किया जाता है. सिर्फ़ दिन, महीने, और साल वाले फ़ील्ड का इस्तेमाल किया जाता है. 

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

पैरामीटर

नामटाइपब्यौरा
dateDateवह तारीख जिसके बाद से, इस तरह के बदलाव नहीं किए जा सकते.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireDateBetween(start, end)

यह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसके तहत, किसी सेल में ऐसी तारीख डालनी होती है जो दो तय की गई तारीखों के बीच की हो या उनमें से कोई एक हो. Date ऑब्जेक्ट के समय वाले फ़ील्ड को अनदेखा किया जाता है. सिर्फ़ दिन, महीने, और साल वाले फ़ील्ड का इस्तेमाल किया जाता है. 

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

पैरामीटर

नामटाइपब्यौरा
startDateसबसे पहले स्वीकार की जाने वाली तारीख.
endDateस्वीकार की जा सकने वाली आखिरी तारीख.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेनिंग के लिए है

requireDateEqualTo(date)

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इस नियम के तहत, दी गई वैल्यू के बराबर तारीख डालना ज़रूरी होता है. Date ऑब्जेक्ट के समय वाले फ़ील्ड को अनदेखा किया जाता है. सिर्फ़ दिन, महीने, और साल वाले फ़ील्ड का इस्तेमाल किया जाता है. 

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

पैरामीटर

नामटाइपब्यौरा
dateDateसिर्फ़ इस तारीख को स्वीकार किया जाएगा.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireDateNotBetween(start, end)

यह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसमें दो तारीखों के बीच की कोई तारीख शामिल नहीं होती है. साथ ही, यह भी ज़रूरी है कि वह तारीख, उन दो तारीखों में से कोई भी न हो. Date ऑब्जेक्ट के समय वाले फ़ील्ड को अनदेखा किया जाता है. सिर्फ़ दिन, महीने, और साल वाले फ़ील्ड का इस्तेमाल किया जाता है. 

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

पैरामीटर

नामटाइपब्यौरा
startDateवह तारीख जिसके बाद से, इस तरह के बदलाव नहीं किए जा सकते.
endDateयह वह तारीख है जिसके बाद, इस समस्या को ठीक नहीं किया जा सकता.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेनिंग के लिए है

requireDateOnOrAfter(date)

यह फ़ंक्शन, डेटा की पुष्टि करने के नियम को सेट करता है. इससे यह ज़रूरी हो जाता है कि दी गई वैल्यू के बराबर या उसके बाद की तारीख डाली जाए. Date ऑब्जेक्ट के समय वाले फ़ील्ड को अनदेखा किया जाता है. सिर्फ़ दिन, महीने, और साल वाले फ़ील्ड का इस्तेमाल किया जाता है. 

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

पैरामीटर

नामटाइपब्यौरा
dateDateसबसे पहले स्वीकार की जाने वाली तारीख.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेनिंग के लिए है

requireDateOnOrBefore(date)

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि दी गई वैल्यू के बराबर या उससे पहले की तारीख डाली जाए. Date ऑब्जेक्ट के समय वाले फ़ील्ड को अनदेखा कर दिया जाता है. सिर्फ़ दिन, महीने, और साल वाले फ़ील्ड का इस्तेमाल किया जाता है. 

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

पैरामीटर

नामटाइपब्यौरा
dateDateस्वीकार की जा सकने वाली आखिरी तारीख.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेनिंग के लिए है

requireFormulaSatisfied(formula)

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि दिया गया फ़ॉर्मूला, 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);

पैरामीटर

नामटाइपब्यौरा
formulaStringयह एक कस्टम फ़ॉर्मूला है. अगर इनपुट मान्य है, तो यह true के तौर पर नतीजे दिखाता है.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेनिंग के लिए है

requireNumberBetween(start, end)

यह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसके तहत, दो तय किए गए नंबरों के बीच का कोई नंबर या उनमें से कोई एक नंबर डालना ज़रूरी होता है. 

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

पैरामीटर

नामटाइपब्यौरा
startNumberस्वीकार की जा सकने वाली सबसे कम वैल्यू.
endNumberसबसे ज़्यादा स्वीकार की जा सकने वाली वैल्यू.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireNumberEqualTo(number)

डेटा की पुष्टि करने का नियम सेट करता है, ताकि दी गई वैल्यू के बराबर संख्या की ज़रूरत हो. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberसिर्फ़ इस वैल्यू का इस्तेमाल किया जा सकता है.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireNumberGreaterThan(number)

इस विकल्प का इस्तेमाल करके, डेटा की पुष्टि करने का ऐसा नियम सेट किया जाता है जिसमें दी गई वैल्यू से ज़्यादा संख्या डालना ज़रूरी होता है. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberसबसे ज़्यादा अस्वीकार की गई वैल्यू.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireNumberGreaterThanOrEqualTo(number)

डेटा की पुष्टि करने के नियम को सेट करता है, ताकि दी गई वैल्यू से ज़्यादा या उसके बराबर संख्या की ज़रूरत हो. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberस्वीकार की जा सकने वाली सबसे कम वैल्यू.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेनिंग के लिए है

requireNumberLessThan(number)

डेटा की पुष्टि करने के लिए, यह नियम सेट करता है कि दी गई वैल्यू से कम संख्या डालनी होगी. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberस्वीकार न की जाने वाली सबसे छोटी वैल्यू.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireNumberLessThanOrEqualTo(number)

डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि डाली गई वैल्यू, दी गई वैल्यू से कम या उसके बराबर हो. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberसबसे ज़्यादा स्वीकार की जा सकने वाली वैल्यू.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireNumberNotBetween(start, end)

यह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसके तहत, किसी ऐसे नंबर की ज़रूरत होती है जो दो तय किए गए नंबरों के बीच में न हो और न ही उनके बराबर हो. 

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

पैरामीटर

नामटाइपब्यौरा
startNumberस्वीकार न की जाने वाली सबसे छोटी वैल्यू.
endNumberसबसे ज़्यादा अस्वीकार की गई वैल्यू.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेनिंग के लिए है

requireNumberNotEqualTo(number)

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि दी गई वैल्यू के बराबर कोई संख्या न हो. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberसिर्फ़ एक वैल्यू स्वीकार नहीं की जा सकती.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेनिंग के लिए है

requireTextContains(text)

यह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसके तहत, इनपुट में दी गई वैल्यू शामिल करना ज़रूरी होता है. 

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

पैरामीटर

नामटाइपब्यौरा
textStringवह वैल्यू जो इनपुट में मौजूद होनी चाहिए.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireTextDoesNotContain(text)

यह फ़ंक्शन, डेटा की पुष्टि करने का ऐसा नियम सेट करता है जिसके तहत, इनपुट में दी गई वैल्यू शामिल नहीं होनी चाहिए. 

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

पैरामीटर

नामटाइपब्यौरा
textStringवह वैल्यू जो इनपुट में शामिल नहीं होनी चाहिए.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireTextEqualTo(text)

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट की गई वैल्यू, दी गई वैल्यू के बराबर हो. 

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

पैरामीटर

नामटाइपब्यौरा
textStringसिर्फ़ इस वैल्यू का इस्तेमाल किया जा सकता है.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेनिंग के लिए है

requireTextIsEmail()

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, ईमेल पते के फ़ॉर्मैट में हो. 

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

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireTextIsUrl()

डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, यूआरएल के फ़ॉर्म में हो. 

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

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireValueInList(values)

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट की वैल्यू, दी गई वैल्यू में से किसी एक के बराबर हो. 

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

पैरामीटर

नामटाइपब्यौरा
valuesString[]स्वीकार की जा सकने वाली वैल्यू की ऐरे.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireValueInList(values, showDropdown)

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट की वैल्यू, दी गई वैल्यू में से किसी एक के बराबर हो. साथ ही, इसमें ड्रॉपडाउन मेन्यू को छिपाने का विकल्प भी होता है. 

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

पैरामीटर

नामटाइपब्यौरा
valuesString[]स्वीकार की जा सकने वाली वैल्यू की ऐरे.
showDropdownBooleantrue अगर स्प्रेडशीट में वैल्यू के लिए ड्रॉपडाउन मेन्यू दिखाना है; false अगर नहीं दिखाना है.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireValueInRange(range)

डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, दी गई रेंज में मौजूद किसी वैल्यू के बराबर हो. 

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

पैरामीटर

नामटाइपब्यौरा
rangeRangeयह एक ऐसी रेंज होती है जिसमें स्वीकार की जा सकने वाली वैल्यू मौजूद होती हैं.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

requireValueInRange(range, showDropdown)

यह फ़ंक्शन, डेटा की पुष्टि करने का नियम सेट करता है. इससे यह ज़रूरी हो जाता है कि इनपुट, दी गई रेंज में मौजूद किसी वैल्यू के बराबर हो. साथ ही, इसमें ड्रॉपडाउन मेन्यू को छिपाने का विकल्प भी होता है. 

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

पैरामीटर

नामटाइपब्यौरा
rangeRangeयह एक ऐसी रेंज होती है जिसमें स्वीकार की जा सकने वाली वैल्यू मौजूद होती हैं.
showDropdownBooleantrue अगर स्प्रेडशीट में वैल्यू के लिए ड्रॉपडाउन मेन्यू दिखाना है; false अगर नहीं दिखाना है.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

setAllowInvalid(allowInvalidData)

यह तय करता है कि डेटा की पुष्टि न होने पर, इनपुट के लिए चेतावनी दिखानी है या इनपुट को पूरी तरह से अस्वीकार करना है. डेटा की पुष्टि करने के नए नियमों के लिए, डिफ़ॉल्ट सेटिंग true होती है.

पैरामीटर

नामटाइपब्यौरा
allowInvalidDataBooleantrue अगर नियम के तहत, डेटा की पुष्टि न होने पर भी इनपुट की अनुमति देनी है; false अगर ऐसा नहीं करना है.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

setHelpText(helpText)

यह विकल्प, उस सेल पर कर्सर घुमाने पर दिखने वाला सहायता टेक्स्ट सेट करता है जिस पर डेटा की पुष्टि करने की सुविधा सेट की गई है.

पैरामीटर

नामटाइपब्यौरा
helpTextStringसेट करने के लिए सहायता टेक्स्ट.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है

withCriteria(criteria, args)

यह फ़ंक्शन, डेटा की पुष्टि करने के नियम को DataValidationCriteria वैल्यू के हिसाब से तय की गई शर्तों पर सेट करता है. आम तौर पर, ये वैल्यू किसी मौजूदा नियम के criteria और arguments से ली जाती हैं. 

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
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);

पैरामीटर

नामटाइपब्यौरा
criteriaDataValidationCriteriaडेटा की पुष्टि करने की शर्त का टाइप.
argsObject[]यह मानदंड के टाइप के हिसाब से, ऑर्ग्युमेंट का ऐरे होता है. इसमें ऑर्ग्युमेंट की संख्या और उनका टाइप, ऊपर दिए गए require...() तरीके से मेल खाता है.

वापसी का टिकट

DataValidationBuilder — यह बिल्डर, चेन बनाने के लिए है