Class 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()DataValidationCriteriaDataValidationCriteria एनम में बताए गए नियम के हिसाब से, शर्तों का टाइप पाता है.
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 एनम में बताए गए नियम के हिसाब से, शर्तों का टाइप पाता है. शर्तों के लिए आर्ग्युमेंट पाने के लिए, 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 — चेन बनाने के लिए यह बिल्डर