این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class DataValidationBuilder

سازنده قوانین اعتبارسنجی داده ها.

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

روش ها

روش	نوع برگشت	شرح مختصر
`build()`	`DataValidation`	یک قانون اعتبارسنجی داده را از تنظیمات اعمال شده برای سازنده می سازد.
`copy()`	`DataValidationBuilder`	بر اساس تنظیمات این قانون یک سازنده برای یک قانون اعتبارسنجی داده ایجاد می کند.
`getAllowInvalid()`	`Boolean`	در صورتی که این قانون یک هشدار را در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه می‌کند، نشان می‌دهد، یا اگر ورودی را به طور کامل رد کند، `true` `false` .
`getCriteriaType()`	`DataValidationCriteria`	نوع معیار قانون را همانطور که در فهرست `DataValidationCriteria` تعریف شده است دریافت می کند.
`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`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی به شکل URL باشد.
`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.
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);

بازگشت

DataValidationBuilder - سازنده بر اساس تنظیمات این قانون

`getAllowInvalid()`

در صورتی که این قانون یک هشدار را در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه می‌کند، نشان می‌دهد، یا اگر ورودی را به طور کامل رد کند، true false . پیش‌فرض قوانین اعتبارسنجی داده جدید true است.

بازگشت

Boolean - true اگر قانون اجازه ورودی‌هایی را بدهد که اعتبارسنجی داده‌ها ناموفق باشد. false اگر نه

`getCriteriaType()`

نوع معیار قانون را همانطور که در فهرست DataValidationCriteria تعریف شده است دریافت می کند. برای بدست آوردن آرگومان های معیارها، از getCriteriaValues() استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، به 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.')
}

بازگشت

DataValidationCriteria - نوع معیار اعتبار سنجی داده ها

`getCriteriaValues()`

آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. برای دریافت نوع معیار، از getCriteriaType() استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، به 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.')
}

بازگشت

Object[] - آرایه ای از آرگومان های متناسب با نوع معیار قاعده. تعداد آرگومان‌ها و نوع آن‌ها با متد require...() کلاس DataValidationBuilder مطابقت دارد

`getHelpText()`

متن راهنمای قانون را دریافت می‌کند، یا اگر متن راهنما تنظیم نشده باشد، null .

بازگشت

String - متن راهنمای قانون، یا اگر متن راهنما تنظیم نشده باشد، null

`requireCheckbox()`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی یک مقدار بولی باشد. این مقدار به عنوان یک چک باکس ارائه می شود.

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

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireCheckbox(checkedValue)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی مقدار مشخص شده یا خالی باشد. هنگامی که ورودی با مقدار مشخص شده مطابقت دارد، سلول به عنوان یک چک باکس بررسی شده ارائه می شود. هنگامی که ورودی خالی است، سلول به عنوان یک چک باکس بدون علامت نمایش داده می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`checkedValue`	`Object`	مقدار اختصاص داده شده به یک کادر علامت دار.

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireCheckbox(checkedValue, uncheckedValue)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی یکی از مقادیر مشخص شده باشد. وقتی مقدار ورودی checkedValue می شود، سلول به عنوان یک چک باکس علامت دار نمایش داده می شود. هنگامی که ورودی uncheckedValue باشد، سلول به عنوان یک چک باکس بدون علامت نمایش داده می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`checkedValue`	`Object`	مقدار اختصاص داده شده به یک کادر علامت دار.
`uncheckedValue`	`Object`	مقدار اختصاص داده شده به یک کادر بدون علامت.

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireDate()`

قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که به تاریخ نیاز دارد.

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

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireDateAfter(date)`

قانون اعتبارسنجی داده را طوری تنظیم می کند که تاریخ بعد از مقدار داده شده را بخواهد. فیلدهای زمان شیء Date نادیده گرفته می شوند. فقط از فیلدهای روز، ماه و سال استفاده می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`date`	`Date`	آخرین تاریخ غیر قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireDateBefore(date)`

قانون اعتبارسنجی داده را طوری تنظیم می کند که تاریخ قبل از مقدار داده شده را بخواهد. فیلدهای زمان شیء Date نادیده گرفته می شوند. فقط از فیلدهای روز، ماه و سال استفاده می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`date`	`Date`	اولین تاریخ غیر قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireDateBetween(start, end)`

قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که تاریخی بین دو تاریخ مشخص شده یا یکی از آنها باشد. فیلدهای زمان اشیاء Date نادیده گرفته می شوند. فقط از فیلدهای روز، ماه و سال استفاده می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`start`	`Date`	اولین تاریخ قابل قبول
`end`	`Date`	آخرین تاریخ قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireDateEqualTo(date)`

قانون اعتبارسنجی داده ها را طوری تنظیم می کند که به تاریخی برابر با مقدار داده شده نیاز دارد. فیلدهای زمان شیء Date نادیده گرفته می شوند. فقط از فیلدهای روز، ماه و سال استفاده می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`date`	`Date`	تنها تاریخ قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireDateNotBetween(start, end)`

قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که به تاریخی نیاز دارد که بین دو تاریخ مشخص قرار نگیرد و هیچ کدام از آنها نباشد. فیلدهای زمان اشیاء Date نادیده گرفته می شوند. فقط از فیلدهای روز، ماه و سال استفاده می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`start`	`Date`	اولین تاریخ غیر قابل قبول
`end`	`Date`	آخرین تاریخ غیر قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireDateOnOrAfter(date)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که تاریخ روی یا بعد از مقدار داده شده را بخواهد. فیلدهای زمان شیء Date نادیده گرفته می شوند. فقط از فیلدهای روز، ماه و سال استفاده می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`date`	`Date`	اولین تاریخ قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireDateOnOrBefore(date)`

قانون اعتبارسنجی داده ها را طوری تنظیم می کند که تاریخ را روی مقدار داده شده یا قبل از آن نیاز دارد. فیلدهای زمان شیء Date نادیده گرفته می شوند. فقط از فیلدهای روز، ماه و سال استفاده می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`date`	`Date`	آخرین تاریخ قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireFormulaSatisfied(formula)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که فرمول داده شده را به 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);

پارامترها

نام	تایپ کنید	توضیحات
`formula`	`String`	یک فرمول سفارشی که در صورت معتبر بودن ورودی به `true` ارزیابی می شود.

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireNumberBetween(start, end)`

قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که به عددی نیاز دارد که بین دو عدد مشخص شده قرار می گیرد یا یکی از آنها باشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`start`	`Number`	کمترین مقدار قابل قبول
`end`	`Number`	بالاترین مقدار قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireNumberEqualTo(number)`

قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی برابر با مقدار داده شده نیاز داشته باشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	تنها ارزش قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireNumberGreaterThan(number)`

قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی بیشتر از مقدار داده شده نیاز داشته باشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	بالاترین ارزش غیر قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireNumberGreaterThanOrEqualTo(number)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که به عددی بزرگتر یا مساوی با مقدار داده شده نیاز دارد.

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

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	کمترین مقدار قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireNumberLessThan(number)`

قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی کمتر از مقدار داده شده نیاز داشته باشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	کمترین مقدار غیر قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireNumberLessThanOrEqualTo(number)`

قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی کمتر یا مساوی با مقدار داده شده نیاز داشته باشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	بالاترین مقدار قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireNumberNotBetween(start, end)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که به عددی نیاز داشته باشد که بین دو عدد مشخص قرار نگیرد و هیچ کدام از آن ها نباشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`start`	`Number`	کمترین مقدار غیر قابل قبول
`end`	`Number`	بالاترین ارزش غیر قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireNumberNotEqualTo(number)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که به عددی نیاز داشته باشد که با مقدار داده شده برابر نباشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	تنها ارزش غیر قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireTextContains(text)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی حاوی مقدار داده شده باشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`text`	`String`	مقداری که ورودی باید حاوی آن باشد.

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireTextDoesNotContain(text)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی حاوی مقدار داده شده نباشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`text`	`String`	مقداری که ورودی نباید حاوی آن باشد.

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireTextEqualTo(text)`

قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که ورودی برابر با مقدار داده شده باشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`text`	`String`	تنها ارزش قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireTextIsEmail()`

قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که ورودی به شکل آدرس ایمیل باشد.

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

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireTextIsUrl()`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی به شکل 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);

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireValueInList(values)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی برابر با یکی از مقادیر داده شده باشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`values`	`String[]`	مجموعه ای از مقادیر قابل قبول

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireValueInList(values, showDropdown)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی برابر با یکی از مقادیر داده شده باشد، با گزینه ای برای پنهان کردن منوی کشویی.

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

پارامترها

نام	تایپ کنید	توضیحات
`values`	`String[]`	مجموعه ای از مقادیر قابل قبول
`showDropdown`	`Boolean`	`true` اگر صفحه گسترده باید یک منوی کشویی برای مقادیر نشان دهد. `false` اگر نه

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireValueInRange(range)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی برابر با مقداری در محدوده داده شده باشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`range`	`Range`	محدوده ای که حاوی مقادیر قابل قبول است.

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`requireValueInRange(range, showDropdown)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی با یک مقدار در محدوده داده شده برابر باشد، با گزینه ای برای پنهان کردن منوی کشویی.

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

پارامترها

نام	تایپ کنید	توضیحات
`range`	`Range`	محدوده ای که حاوی مقادیر قابل قبول است.
`showDropdown`	`Boolean`	`true` اگر صفحه گسترده باید یک منوی کشویی برای مقادیر نشان دهد. `false` اگر نه

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`setAllowInvalid(allowInvalidData)`

تنظیم می‌کند که در صورت عدم موفقیت ورودی اعتبارسنجی داده، هشداری نشان داده شود یا ورودی را به طور کامل رد کند. پیش‌فرض قوانین اعتبارسنجی داده جدید true است.

پارامترها

نام	تایپ کنید	توضیحات
`allowInvalidData`	`Boolean`	`true` اگر قانون باید ورودی هایی را مجاز کند که اعتبار سنجی داده ها را با شکست مواجه می کند. `false` اگر نه

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`setHelpText(helpText)`

متن راهنما را تنظیم می کند که وقتی کاربر روی سلولی که اعتبار داده روی آن تنظیم شده است نشان داده می شود.

پارامترها

نام	تایپ کنید	توضیحات
`helpText`	`String`	متن راهنما برای تنظیم.

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن

`withCriteria(criteria, args)`

قانون اعتبارسنجی داده ها را بر روی معیارهای تعریف شده توسط مقادیر DataValidationCriteria تنظیم می کند که معمولاً از criteria و arguments یک قانون موجود گرفته می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`criteria`	`DataValidationCriteria`	نوع معیار اعتبار سنجی داده ها.
`args`	`Object[]`	آرایه ای از آرگومان های متناسب با نوع معیار؛ تعداد آرگومان‌ها و نوع آن‌ها با متد `require...()` بالا مطابقت دارد.

بازگشت

DataValidationBuilder - این سازنده، برای زنجیره زدن