Class NamedRange

NamedRange

E-tablolarda adlandırılmış aralıklar oluşturma, bunlara erişme ve bunları değiştirme Adlandırılmış aralıklar, ilişkili dize takma adları olan aralıklardır. Bu aralıklar, Veriler > Adlandırılmış aralıklar... menüsündeki E-Tablolar kullanıcı arayüzü üzerinden görüntülenebilir ve düzenlenebilir.

Yöntemler

YöntemDönüş türüKısa açıklama
getName()StringBu adlandırılmış aralığın adını alır.
getRange()RangeBu adlandırılmış aralık tarafından referans verilen aralığı alır.
remove()voidBu adlandırılmış aralığı siler.
setName(name)NamedRangeAdlandırılmış aralığın adını ayarlar/günceller.
setRange(range)NamedRangeBu adlandırılmış aralık için aralığı ayarlar/günceller.

Ayrıntılı belgeler

getName()

Bu adlandırılmış aralığın adını alır.

Return

String: Bu adlandırılmış aralığın adı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange()

Bu adlandırılmış aralık tarafından referans verilen aralığı alır.

Return

Range: Bu adlandırılmış aralıkla ilişkili e-tablo aralığı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

Bu adlandırılmış aralığı siler. 

// The code below deletes all the named ranges in the spreadsheet.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setName(name)

Adlandırılmış aralığın adını ayarlar/günceller. 

// The code below updates the name for the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName('UpdatedNamedRange');
}

Parametreler

AdTürAçıklama
nameStringAdlandırılmış aralığın yeni adı.

Return

NamedRange: Adı görüşme tarafından ayarlanan aralık

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setRange(range)

Bu adlandırılmış aralık için aralığı ayarlar/günceller.

Parametreler

AdTürAçıklama
rangeRangeBu adlandırılmış aralıkla ilişkilendirilecek e-tablo aralığı.

Return

NamedRange: E-tablo aralığının ayarlandığı adlandırılmış aralık

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets