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

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()`	`Data Validation`	یک قانون اعتبارسنجی داده را از تنظیمات اعمال شده برای سازنده می سازد.
`copy()`	`Data Validation Builder`	بر اساس تنظیمات این قانون یک سازنده برای یک قانون اعتبارسنجی داده ایجاد می کند.
`get Allow Invalid()`	`Boolean`	در صورتی که این قانون یک هشدار را در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه می‌کند، نشان می‌دهد، یا اگر ورودی را به طور کامل رد کند، `true` `false` .
`get Criteria Type()`	`Data Validation Criteria`	نوع معیار قانون را همانطور که در فهرست `Data Validation Criteria` تعریف شده است، دریافت می کند.
`get Criteria Values()`	`Object[]`	آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند.
`get Help Text()`	`String`	متن راهنمای قانون را دریافت می کند، یا اگر متن راهنما تنظیم نشده باشد، `null` .
`require Checkbox()`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی یک مقدار بولی باشد. این مقدار به عنوان یک چک باکس ارائه می شود.
`require Checkbox(checkedValue)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی مقدار مشخص شده یا خالی باشد.
`require Checkbox(checkedValue, uncheckedValue)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی یکی از مقادیر مشخص شده باشد.
`require Date()`	`Data Validation Builder`	قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که به تاریخ نیاز دارد.
`require Date After(date)`	`Data Validation Builder`	قانون اعتبارسنجی داده را طوری تنظیم می کند که تاریخ بعد از مقدار داده شده را بخواهد.
`require Date Before(date)`	`Data Validation Builder`	قانون اعتبارسنجی داده را طوری تنظیم می کند که تاریخ قبل از مقدار داده شده را بخواهد.
`require Date Between(start, end)`	`Data Validation Builder`	قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که تاریخی بین دو تاریخ مشخص شده یا یکی از آنها باشد.
`require Date Equal To(date)`	`Data Validation Builder`	قانون اعتبارسنجی داده ها را طوری تنظیم می کند که به تاریخی برابر با مقدار داده شده نیاز دارد.
`require Date Not Between(start, end)`	`Data Validation Builder`	قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که به تاریخی نیاز دارد که بین دو تاریخ مشخص قرار نگیرد و هیچ کدام از آنها نباشد.
`require Date On Or After(date)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که تاریخ روی یا بعد از مقدار داده شده را بخواهد.
`require Date On Or Before(date)`	`Data Validation Builder`	قانون اعتبارسنجی داده ها را طوری تنظیم می کند که تاریخ را روی مقدار داده شده یا قبل از آن نیاز دارد.
`require Formula Satisfied(formula)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که فرمول داده شده را به `true` ارزیابی کند.
`require Number Between(start, end)`	`Data Validation Builder`	قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که به عددی نیاز دارد که بین دو عدد مشخص قرار می گیرد یا یکی از آنها باشد.
`require Number Equal To(number)`	`Data Validation Builder`	قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی برابر با مقدار داده شده نیاز داشته باشد.
`require Number Greater Than(number)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که به عددی بیشتر از مقدار داده شده نیاز دارد.
`require Number Greater Than Or Equal To(number)`	`Data Validation Builder`	قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی بزرگتر یا مساوی با مقدار داده شده نیاز داشته باشد.
`require Number Less Than(number)`	`Data Validation Builder`	قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی کمتر از مقدار داده شده نیاز داشته باشد.
`require Number Less Than Or Equal To(number)`	`Data Validation Builder`	قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی کمتر یا مساوی با مقدار داده شده نیاز داشته باشد.
`require Number Not Between(start, end)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که به عددی نیاز داشته باشد که بین دو عدد مشخص قرار نگیرد و هیچ کدام از آن ها نباشد.
`require Number Not Equal To(number)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که به عددی نیاز داشته باشد که با مقدار داده شده برابر نباشد.
`require Text Contains(text)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی حاوی مقدار داده شده باشد.
`require Text Does Not Contain(text)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی حاوی مقدار داده شده نباشد.
`require Text Equal To(text)`	`Data Validation Builder`	قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که ورودی برابر با مقدار داده شده باشد.
`require Text Is Email()`	`Data Validation Builder`	قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که ورودی به شکل آدرس ایمیل باشد.
`require Text Is Url()`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی به شکل URL باشد.
`require Value In List(values)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی برابر با یکی از مقادیر داده شده باشد.
`require Value In List(values, showDropdown)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی برابر با یکی از مقادیر داده شده باشد، با گزینه ای برای پنهان کردن منوی کشویی.
`require Value In Range(range)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی برابر با مقداری در محدوده داده شده باشد.
`require Value In Range(range, showDropdown)`	`Data Validation Builder`	قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی با یک مقدار در محدوده داده شده برابر باشد، با گزینه ای برای پنهان کردن منوی کشویی.
`set Allow Invalid(allowInvalidData)`	`Data Validation Builder`	تنظیم می کند که آیا در صورت عدم موفقیت ورودی اعتبارسنجی داده ها، هشدار نشان داده شود یا اینکه ورودی به طور کامل رد شود.
`set Help Text(helpText)`	`Data Validation Builder`	متن راهنما را تنظیم می کند که وقتی کاربر روی سلولی که اعتبار داده روی آن تنظیم شده است نشان داده می شود.
`with Criteria(criteria, args)`	`Data Validation Builder`	قانون اعتبارسنجی داده ها را بر روی معیارهایی تنظیم می کند که توسط مقادیر `Data Validation Criteria` تعریف شده است، که معمولاً از `criteria` و `arguments` یک قانون موجود گرفته می شود.

مستندات دقیق

`build()`

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

بازگشت

Data Validation - نمایشی از قانون اعتبارسنجی داده ها

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

بازگشت

Data Validation Builder - سازنده ای بر اساس تنظیمات این قانون

`get Allow Invalid()`

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

بازگشت

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

`get Criteria Type()`

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

بازگشت

Data Validation Criteria - نوع معیارهای اعتبارسنجی داده ها

`get Criteria Values()`

آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. برای دریافت نوع معیار، get Criteria Type() استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، with Criteria(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[] - آرایه ای از آرگومان های متناسب با نوع معیار قاعده. تعداد آرگومان‌ها و نوع آن‌ها با متد require...() کلاس Data Validation Builder مطابقت دارد

`get Help Text()`

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

بازگشت

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

`require Checkbox()`

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

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Checkbox(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Checkbox(checkedValue, uncheckedValue)`

قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی یکی از مقادیر مشخص شده باشد. وقتی checked Value سلول به‌عنوان یک چک باکس علامت‌دار نمایش داده می‌شود. وقتی علامت ورودی unchecked Value سلول به عنوان یک چک باکس بدون علامت نمایش داده می شود.

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

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Date()`

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

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Date After(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Date Before(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Date Between(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Date Equal To(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Date Not Between(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Date On Or After(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Date On Or Before(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Formula Satisfied(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Number Between(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Number Equal To(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Number Greater Than(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Number Greater Than Or Equal To(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Number Less Than(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Number Less Than Or Equal To(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Number Not Between(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Number Not Equal To(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Text Contains(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Text Does Not Contain(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Text Equal To(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Text Is Email()`

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

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Text Is Url()`

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

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Value In List(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Value In List(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Value In Range(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`require Value In Range(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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`set Allow Invalid(allowInvalidData)`

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

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`set Help Text(helpText)`

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

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن

`with Criteria(criteria, args)`

قانون اعتبارسنجی داده ها را بر روی معیارهایی تنظیم می کند که توسط مقادیر Data Validation Criteria تعریف شده است، که معمولاً از 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);

پارامترها

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

بازگشت

Data Validation Builder - این سازنده، برای زنجیره زدن