Class DataValidationBuilder

DataValidationBuilder

Veri doğrulama kuralları için oluşturucu.

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

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
build()	DataValidation	Oluşturucuya uygulanan ayarlardan bir veri doğrulama kuralı oluşturur.
copy()	DataValidationBuilder	Bu kuralın ayarlarına göre bir veri doğrulama kuralı için oluşturucu oluşturur.
getAllowInvalid()	Boolean	Kural, giriş verileri doğrulaması başarısız olduğunda uyarı gösteriyorsa true, girişi tamamen reddediyorsa false değerini döndürür.
getCriteriaType()	DataValidationCriteria	Kuralın ölçüt türünü, DataValidationCriteria enum'unda tanımlandığı şekilde alır.
getCriteriaValues()	Object[]	Kuralın ölçütleri için bir bağımsız değişken dizisi alır.
getHelpText()	String	Kuralın yardım metnini veya yardım metni ayarlanmamışsa null değerini alır.
requireCheckbox()	DataValidationBuilder	Veri doğrulama kuralını, girişin boole değeri olmasını gerektirecek şekilde ayarlar. Bu değer, onay kutusu olarak oluşturulur.
requireCheckbox(checkedValue)	DataValidationBuilder	Veri doğrulama kuralını, girişin belirtilen değer veya boş olmasını gerektirecek şekilde ayarlar.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	Veri doğrulama kuralını, girişin belirtilen değerlerden biri olmasını gerektirecek şekilde ayarlar.
requireDate()	DataValidationBuilder	Veri doğrulama kuralını tarih gerektirecek şekilde ayarlar.
requireDateAfter(date)	DataValidationBuilder	Veri doğrulama kuralını, belirtilen değerden sonraki bir tarihi zorunlu kılacak şekilde ayarlar.
requireDateBefore(date)	DataValidationBuilder	Veri doğrulama kuralını, belirtilen değerden önceki bir tarihi zorunlu kılacak şekilde ayarlar.
requireDateBetween(start, end)	DataValidationBuilder	Veri doğrulama kuralını, belirtilen iki tarih arasında veya bu tarihlerden biri olan bir tarih gerektirecek şekilde ayarlar.
requireDateEqualTo(date)	DataValidationBuilder	Veri doğrulama kuralını, verilen değere eşit bir tarih gerektirecek şekilde ayarlar.
requireDateNotBetween(start, end)	DataValidationBuilder	Veri doğrulama kuralını, belirtilen iki tarih arasında olmayan ve bu tarihlerden biri de olmayan bir tarih gerektirecek şekilde ayarlar.
requireDateOnOrAfter(date)	DataValidationBuilder	Veri doğrulama kuralını, belirli bir değerdeki veya sonraki tarihleri zorunlu kılacak şekilde ayarlar.
requireDateOnOrBefore(date)	DataValidationBuilder	Veri doğrulama kuralını, belirtilen değerdeki veya öncesindeki bir tarihi zorunlu kılacak şekilde ayarlar.
requireFormulaSatisfied(formula)	DataValidationBuilder	Veri doğrulama kuralını, verilen formülün true olarak değerlendirilmesini gerektirecek şekilde ayarlar.
requireNumberBetween(start, end)	DataValidationBuilder	Veri doğrulama kuralını, belirtilen iki sayı arasında olan veya bu sayılardan biri olan bir sayı gerektirecek şekilde ayarlar.
requireNumberEqualTo(number)	DataValidationBuilder	Veri doğrulama kuralını, verilen değere eşit bir sayı gerektirecek şekilde ayarlar.
requireNumberGreaterThan(number)	DataValidationBuilder	Veri doğrulama kuralını, belirtilen değerden büyük bir sayı gerektirecek şekilde ayarlar.
requireNumberGreaterThanOrEqualTo(number)	DataValidationBuilder	Veri doğrulama kuralını, verilen değerden büyük veya bu değere eşit bir sayı gerektirecek şekilde ayarlar.
requireNumberLessThan(number)	DataValidationBuilder	Veri doğrulama kuralını, verilen değerden küçük bir sayı gerektirecek şekilde ayarlar.
requireNumberLessThanOrEqualTo(number)	DataValidationBuilder	Veri doğrulama kuralını, verilen değerden küçük veya bu değere eşit bir sayı gerektirecek şekilde ayarlar.
requireNumberNotBetween(start, end)	DataValidationBuilder	Veri doğrulama kuralını, belirtilen iki sayı arasında olmayan ve bu sayılardan biri de olmayan bir sayı gerektirecek şekilde ayarlar.
requireNumberNotEqualTo(number)	DataValidationBuilder	Veri doğrulama kuralını, verilen değere eşit olmayan bir sayı gerektirecek şekilde ayarlar.
requireTextContains(text)	DataValidationBuilder	Veri doğrulama kuralını, girişin belirtilen değeri içerecek şekilde ayarlar.
requireTextDoesNotContain(text)	DataValidationBuilder	Veri doğrulama kuralını, girişin belirtilen değeri içermemesi gerektiği şekilde ayarlar.
requireTextEqualTo(text)	DataValidationBuilder	Veri doğrulama kuralını, girişin verilen değere eşit olmasını gerektirecek şekilde ayarlar.
requireTextIsEmail()	DataValidationBuilder	Veri doğrulama kuralını, girişin e-posta adresi biçiminde olmasını gerektirecek şekilde ayarlar.
requireTextIsUrl()	DataValidationBuilder	Veri doğrulama kuralını, girişin URL biçiminde olmasını gerektirecek şekilde ayarlar.
requireValueInList(values)	DataValidationBuilder	Veri doğrulama kuralını, girişin verilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar.
requireValueInList(values, showDropdown)	DataValidationBuilder	Veri doğrulama kuralını, girişin verilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar. Açılır menüyü gizleme seçeneği de vardır.
requireValueInRange(range)	DataValidationBuilder	Veri doğrulama kuralını, girişin belirli bir aralıktaki değere eşit olmasını gerektirecek şekilde ayarlar.
requireValueInRange(range, showDropdown)	DataValidationBuilder	Veri doğrulama kuralını, girişin belirli bir aralıktaki değere eşit olmasını gerektirecek şekilde ayarlar. Açılır menüyü gizleme seçeneği de vardır.
setAllowInvalid(allowInvalidData)	DataValidationBuilder	Giriş, veri doğrulama işleminde başarısız olduğunda uyarı gösterilip gösterilmeyeceğini veya girişin tamamen reddedilip edilmeyeceğini ayarlar.
setHelpText(helpText)	DataValidationBuilder	Kullanıcı, veri doğrulamanın ayarlandığı hücrenin üzerine geldiğinde görünen yardım metnini ayarlar.
withCriteria(criteria, args)	DataValidationBuilder	Veri doğrulama kuralını, DataValidationCriteria değerleriyle tanımlanan ölçütlere ayarlar. Bu değerler genellikle mevcut bir kuralın criteria ve arguments değerlerinden alınır.

Ayrıntılı belgeler

build()

Oluşturucuya uygulanan ayarlardan bir veri doğrulama kuralı oluşturur.

Return

DataValidation: Veri doğrulama kuralının gösterimi

---

copy()

Bu kuralın ayarlarına göre bir veri doğrulama kuralı için oluşturucu oluşturur.

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

Return

DataValidationBuilder: Bu kuralın ayarlarına dayalı bir oluşturucu

---

getAllowInvalid()

Kural, giriş verileri doğrulaması başarısız olduğunda uyarı gösteriyorsa true, girişi tamamen reddediyorsa false değerini döndürür. Yeni veri doğrulama kurallarının varsayılan değeri true'dır.

Return

Kural, veri doğrulama hatası veren girişlere izin veriyorsa Boolean, aksi takdirde truefalse

---

getCriteriaType()

Kuralın ölçüt türünü, DataValidationCriteria enum'unda tanımlandığı şekilde alır. Ölçütlerin bağımsız değişkenlerini almak için getCriteriaValues() kullanın. Veri doğrulama kuralı oluşturmak veya değiştirmek için bu değerleri kullanmak istiyorsanız withCriteria(criteria, args) bölümüne bakın.

// 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.');
}

Return

DataValidationCriteria: Veri doğrulama ölçütlerinin türü

---

getCriteriaValues()

Kuralın ölçütleri için bir bağımsız değişken dizisi alır. Ölçüt türünü almak için getCriteriaType() kullanın. Veri doğrulama kuralı oluşturmak veya değiştirmek için bu değerleri kullanmak istiyorsanız withCriteria(criteria, args) başlıklı makaleyi inceleyin.

// 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.');
}

Return

Object[]: Kuralın ölçüt türüne uygun bir bağımsız değişken dizisi. Bağımsız değişkenlerin sayısı ve türü, DataValidationBuilder sınıfının ilgili require...() yöntemiyle eşleşir.

---

getHelpText()

Kuralın yardım metnini veya yardım metni ayarlanmamışsa null değerini alır.

Return

String: Kuralın yardım metni veya yardım metni ayarlanmamışsa null

---

requireCheckbox()

Veri doğrulama kuralını, girişin bir boole değeri olmasını gerektirecek şekilde ayarlar. Bu değer, onay kutusu olarak oluşturulur.

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

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireCheckbox(checkedValue)

Veri doğrulama kuralını, girişin belirtilen değer veya boş olmasını gerektirecek şekilde ayarlar. Giriş, belirtilen değerle eşleştiğinde hücre, işaretli bir onay kutusu olarak oluşturulur. Giriş boş olduğunda hücre, işaretsiz bir onay kutusu olarak oluşturulur.

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

Parametreler

Ad	Tür	Açıklama
checkedValue	Object	İşaretli bir kutuya atanan değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireCheckbox(checkedValue, uncheckedValue)

Veri doğrulama kuralını, girişin belirtilen değerlerden biri olmasını gerektirecek şekilde ayarlar. Giriş checkedValue olduğunda hücre, işaretli bir onay kutusu olarak oluşturulur. Giriş uncheckedValue olduğunda hücre, işaretsiz bir onay kutusu olarak oluşturulur.

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

Parametreler

Ad	Tür	Açıklama
checkedValue	Object	İşaretli bir kutuya atanan değer.
uncheckedValue	Object	İşaretlenmemiş bir kutuya atanan değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireDate()

Veri doğrulama kuralını tarih gerektirecek şekilde ayarlar.

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

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireDateAfter(date)

Veri doğrulama kuralını, belirtilen değerden sonraki bir tarihi zorunlu kılacak şekilde ayarlar. Date nesnesinin zaman alanları yoksayılır; yalnızca gün, ay ve yıl alanları kullanılır.

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

Parametreler

Ad	Tür	Açıklama
date	Date	Kabul edilemeyecek en son tarih.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireDateBefore(date)

Veri doğrulama kuralını, belirtilen değerden önceki bir tarihi zorunlu kılacak şekilde ayarlar. Date nesnesinin zaman alanları yoksayılır; yalnızca gün, ay ve yıl alanları kullanılır.

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

Parametreler

Ad	Tür	Açıklama
date	Date	En erken kabul edilemez tarih.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireDateBetween(start, end)

Veri doğrulama kuralını, belirtilen iki tarih arasında veya bu tarihlerden biri olan bir tarih gerektirecek şekilde ayarlar. Date nesnelerinin zaman alanları yoksayılır; yalnızca gün, ay ve yıl alanları kullanılır.

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

Parametreler

Ad	Tür	Açıklama
start	Date	Kabul edilebilir en erken tarih.
end	Date	Kabul edilebilir en son tarih.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireDateEqualTo(date)

Veri doğrulama kuralını, verilen değere eşit bir tarih gerektirecek şekilde ayarlar. Date nesnesinin zaman alanları yoksayılır; yalnızca gün, ay ve yıl alanları kullanılır.

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

Parametreler

Ad	Tür	Açıklama
date	Date	Tek kabul edilebilir tarih.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireDateNotBetween(start, end)

Veri doğrulama kuralını, belirtilen iki tarih arasında olmayan ve bu tarihlerden biri de olmayan bir tarih gerektirecek şekilde ayarlar. Date nesnelerinin zaman alanları yoksayılır; yalnızca gün, ay ve yıl alanları kullanılır.

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

Parametreler

Ad	Tür	Açıklama
start	Date	En erken kabul edilemez tarih.
end	Date	Kabul edilemeyecek en son tarih.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireDateOnOrAfter(date)

Veri doğrulama kuralını, belirli bir değerdeki veya sonraki tarihleri zorunlu kılacak şekilde ayarlar. Date nesnesinin zaman alanları yoksayılır; yalnızca gün, ay ve yıl alanları kullanılır.

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

Parametreler

Ad	Tür	Açıklama
date	Date	Kabul edilebilir en erken tarih.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireDateOnOrBefore(date)

Veri doğrulama kuralını, belirtilen değerdeki veya öncesindeki bir tarihi zorunlu kılacak şekilde ayarlar. Date nesnesinin zaman alanları yoksayılır. Yalnızca gün, ay ve yıl alanları kullanılır.

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

Parametreler

Ad	Tür	Açıklama
date	Date	Kabul edilebilir en son tarih.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireFormulaSatisfied(formula)

Veri doğrulama kuralını, verilen formülün true olarak değerlendirilmesini gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
formula	String	Giriş geçerliyse true olarak değerlendirilen özel bir formül.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireNumberBetween(start, end)

Veri doğrulama kuralını, belirtilen iki sayı arasında olan veya bu sayılardan biri olan bir sayı gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
start	Number	Kabul edilebilir en düşük değer.
end	Number	Kabul edilebilir en yüksek değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireNumberEqualTo(number)

Veri doğrulama kuralını, verilen değere eşit bir sayı gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
number	Number	Kabul edilebilir tek değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireNumberGreaterThan(number)

Veri doğrulama kuralını, belirtilen değerden büyük bir sayı gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
number	Number	Kabul edilemeyen en yüksek değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireNumberGreaterThanOrEqualTo(number)

Veri doğrulama kuralını, verilen değerden büyük veya bu değere eşit bir sayı gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
number	Number	Kabul edilebilir en düşük değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireNumberLessThan(number)

Veri doğrulama kuralını, verilen değerden küçük bir sayı gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
number	Number	Kabul edilemeyen en düşük değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireNumberLessThanOrEqualTo(number)

Veri doğrulama kuralını, verilen değerden küçük veya bu değere eşit bir sayı gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
number	Number	Kabul edilebilir en yüksek değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireNumberNotBetween(start, end)

Veri doğrulama kuralını, belirtilen iki sayı arasında olmayan ve bu sayılardan biri de olmayan bir sayı gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
start	Number	Kabul edilemeyen en düşük değer.
end	Number	Kabul edilemeyen en yüksek değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireNumberNotEqualTo(number)

Veri doğrulama kuralını, verilen değere eşit olmayan bir sayı gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
number	Number	Kabul edilemeyen tek değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireTextContains(text)

Veri doğrulama kuralını, girişin belirtilen değeri içerecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
text	String	Girişin içermesi gereken değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireTextDoesNotContain(text)

Veri doğrulama kuralını, girişin belirtilen değeri içermemesi gerekecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
text	String	Girişin içermemesi gereken değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireTextEqualTo(text)

Veri doğrulama kuralını, girişin verilen değere eşit olmasını gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
text	String	Kabul edilebilir tek değer.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireTextIsEmail()

Veri doğrulama kuralını, girişin e-posta adresi biçiminde olmasını gerektirecek şekilde ayarlar.

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

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireTextIsUrl()

Veri doğrulama kuralını, girişin URL biçiminde olmasını gerektirecek şekilde ayarlar.

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

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireValueInList(values)

Veri doğrulama kuralını, girişin verilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
values	String[]	Kabul edilebilir değerler dizisi.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireValueInList(values, showDropdown)

Veri doğrulama kuralını, girişin verilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar. Açılır menüyü gizleme seçeneği de vardır.

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

Parametreler

Ad	Tür	Açıklama
values	String[]	Kabul edilebilir değerler dizisi.
showDropdown	Boolean	E-tabloda değerler için bir açılır menü gösterilecekse true, gösterilmeyecekse false.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireValueInRange(range)

Veri doğrulama kuralını, girişin belirli bir aralıktaki değere eşit olmasını gerektirecek şekilde ayarlar.

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

Parametreler

Ad	Tür	Açıklama
range	Range	Kabul edilebilir değerleri içeren bir aralık.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

requireValueInRange(range, showDropdown)

Veri doğrulama kuralını, girişin belirli bir aralıktaki değere eşit olmasını gerektirecek şekilde ayarlar. Açılır menüyü gizleme seçeneği de vardır.

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

Parametreler

Ad	Tür	Açıklama
range	Range	Kabul edilebilir değerleri içeren bir aralık.
showDropdown	Boolean	E-tabloda değerler için bir açılır menü gösterilecekse true, gösterilmeyecekse false.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

setAllowInvalid(allowInvalidData)

Giriş, veri doğrulama işleminde başarısız olduğunda uyarı gösterilip gösterilmeyeceğini veya girişin tamamen reddedilip edilmeyeceğini ayarlar. Yeni veri doğrulama kurallarının varsayılan değeri true'dır.

Parametreler

Ad	Tür	Açıklama
allowInvalidData	Boolean	Kuralın, veri doğrulama hatası veren girişlere izin vermesi gerekiyorsa true; Gerekmese false.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

setHelpText(helpText)

Kullanıcı, veri doğrulamanın ayarlandığı hücrenin üzerine geldiğinde görünen yardım metnini ayarlar.

Parametreler

Ad	Tür	Açıklama
helpText	String	Ayarlanacak yardım metni.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu

---

withCriteria(criteria, args)

Veri doğrulama kuralını, DataValidationCriteria değerleriyle tanımlanan ölçütlere ayarlar. Bu değerler genellikle mevcut bir kuralın criteria ve arguments değerlerinden alınır.

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

Parametreler

Ad	Tür	Açıklama
criteria	DataValidationCriteria	Veri doğrulama ölçütlerinin türü.
args	Object[]	Ölçüt türüne uygun bir bağımsız değişken dizisi; bağımsız değişkenlerin sayısı ve türü, yukarıdaki ilgili require...() yöntemiyle eşleşir.

Return

DataValidationBuilder: Zincirleme için bu oluşturucu