Class Range

Aralık

E-tablo aralıklarını erişip değiştirme. Aralık, bir sayfadaki tek bir hücre veya bir sayfadaki bitişik hücreler grubu olabilir.

Yöntemler

YöntemDönüş türüKısa açıklama
activate()RangeBelirtilen aralığı active range olarak, aralığın sol üst hücresini ise current cell olarak ayarlar.
activateAsCurrentCell()RangeBelirtilen hücreyi current cell olarak ayarlar.
addDeveloperMetadata(key)RangeBelirtilen anahtarla geliştirici meta verilerini aralığa ekler.
addDeveloperMetadata(key, visibility)RangeBelirtilen anahtar ve görünürlükle geliştirici meta verilerini aralığa ekler.
addDeveloperMetadata(key, value)RangeBelirtilen anahtar ve değere sahip geliştirici meta verilerini aralığa ekler.
addDeveloperMetadata(key, value, visibility)RangeBelirtilen anahtar, değer ve görünürlükle geliştirici meta verilerini alana ekler.
applyColumnBanding()BandingAralıka varsayılan bir sütun bantları teması uygular.
applyColumnBanding(bandingTheme)BandingBelirtilen bir sütun bantlama temasını aralığa uygular.
applyColumnBanding(bandingTheme, showHeader, showFooter)BandingBelirtilen sütun bantlama temasını, belirtilen başlık ve altbilgi ayarlarıyla aralığa uygular.
applyRowBanding()BandingAralıka varsayılan bir satır gruplandırma teması uygular.
applyRowBanding(bandingTheme)BandingBelirtilen satır gruplandırma temasını aralığa uygular.
applyRowBanding(bandingTheme, showHeader, showFooter)BandingBelirtilen başlık ve altbilgi ayarlarıyla birlikte, belirtilen bir satır bantlama temasını aralığa uygular.
autoFill(destination, series)voiddestinationRange değerini, bu aralıktaki verilere göre verilerle doldurur.
autoFillToNeighbor(series)voidKomşu hücrelere göre yeni veri ile doldurulacak bir aralık hesaplar ve bu aralığı, bu aralıkta bulunan verilere göre otomatik olarak yeni değerlerle doldurur.
breakApart()RangeAralıktaki çok sütunlu hücreleri tekrar tek hücrelere ayırın.
canEdit()BooleanKullanıcının, aralıktaki her hücreyi düzenleme izni olup olmadığını belirler.
check()RangeAralıktaki onay kutularının durumunu "işaretli" olarak değiştirir.
clear()Rangeİçerik ve biçim aralığını temizler.
clear(options)RangeBelirtilen ileri seviye seçeneklerle belirtildiği şekilde içerik aralığını, biçimi, veri doğrulama kurallarını ve/veya yorumları temizler.
clearContent()RangeBiçimlendirmeyi bozmadan aralığın içeriğini temizler.
clearDataValidations()RangeAralıktaki veri doğrulama kurallarını temizler.
clearFormat()RangeBu aralıktaki biçimlendirmeyi temizler.
clearNote()RangeBelirli bir hücre veya hücrelerdeki notu temizler.
collapseGroups()RangeTamamen aralık içinde bulunan tüm grupları daraltır.
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)voidAralığın biçimlendirmesini belirtilen konuma kopyalar.
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)voidAralığın biçimlendirmesini belirtilen konuma kopyalar.
copyTo(destination)voidBir hücre aralığından başka bir hücre aralığına veri kopyalar.
copyTo(destination, copyPasteType, transposed)voidBir hücre aralığından başka bir hücre aralığına veri kopyalar.
copyTo(destination, options)voidBir hücre aralığından başka bir hücre aralığına veri kopyalar.
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)voidAralıktaki içeriği belirtilen konuma kopyalayın.
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)voidAralıktaki içeriği belirtilen konuma kopyalayın.
createDataSourcePivotTable(dataSource)DataSourcePivotTableVeri kaynağından, bu aralıktaki ilk hücreye sabitlenmiş boş bir veri kaynağı pivot tablosu oluşturur.
createDataSourceTable(dataSource)DataSourceTableVeri kaynağından, bu aralıktaki ilk hücreye sabitlenmiş boş bir veri kaynağı tablosu oluşturur.
createDeveloperMetadataFinder()DeveloperMetadataFinderBu aralık kapsamındaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinderApi döndürür.
createFilter()FilterBir filtre oluşturur ve bu filtreyi sayfadaki belirtilen alana uygular.
createPivotTable(sourceData)PivotTableBu aralıktaki ilk hücreye sabitlenmiş, belirtilen sourceData alanından boş bir pivot tablo oluşturur.
createTextFinder(findText)TextFinderAralık için bu aralıktaki metinleri bulup değiştirebilen bir metin bulucu oluşturur.
deleteCells(shiftDimension)voidBu hücre aralığını siler.
expandGroups()RangeAralığı veya kontrol düğmesi bu aralıkla kesişen daraltılmış grupları genişletir.
getA1Notation()StringA1 gösterimindeki aralığın dize açıklamasını döndürür.
getBackground()StringAralıktaki sol üst hücrenin arka plan rengini döndürür (örneğin, '#ffffff').
getBackgroundObject()ColorAralığın sol üst hücresinin arka plan rengini döndürür.
getBackgroundObjects()Color[][]Aralıktaki hücrelerin arka plan renklerini döndürür.
getBackgrounds()String[][]Aralıktaki hücrelerin arka plan renklerini döndürür (örneğin, '#ffffff').
getBandings()Banding[]Bu aralıktaki hücrelere uygulanan tüm bantları döndürür.
getCell(row, column)RangeBir aralıktaki belirli bir hücreyi döndürür.
getColumn()IntegerBu aralığın başlangıç sütun konumunu döndürür.
getDataRegion()Rangeİçinde veri bulunan tüm bitişik hücreleri kapsayacak şekilde dört ana Direction yönünde genişletilmiş aralığın bir kopyasını döndürür.
getDataRegion(dimension)RangeBelirtilen boyut Dimension.ROWS ise Direction.UP ve Direction.DOWN, boyut Dimension.COLUMNS ise Direction.NEXT ve Direction.PREVIOUS olarak genişletilmiş aralığın bir kopyasını döndürür.
getDataSourceFormula()DataSourceFormulaAralıktaki ilk hücre için DataSourceFormula değerini veya hücre bir veri kaynağı formülü içermiyorsa null değerini döndürür.
getDataSourceFormulas()DataSourceFormula[]Aralıktaki hücrelerin DataSourceFormula değerini döndürür.
getDataSourcePivotTables()DataSourcePivotTable[]Aralıkla kesişen tüm veri kaynağı pivot tablolarını alır.
getDataSourceTables()DataSourceTable[]Aralıkla kesişen tüm veri kaynağı tablolarını alır.
getDataSourceUrl()StringBu aralıktaki verilerin URL'sini döndürür. Bu URL, grafik ve sorgu oluşturmak için kullanılabilir.
getDataTable()DataTableBu nesnenin içindeki verileri DataTable olarak döndürme.
getDataTable(firstRowIsHeader)DataTableBu aralıktaki verileri DataTable olarak döndürür.
getDataValidation()DataValidationAralığın sol üst hücresindeki veri doğrulama kuralını döndürür.
getDataValidations()DataValidation[][]Aralıktaki tüm hücreler için veri doğrulama kurallarını döndürür.
getDeveloperMetadata()DeveloperMetadata[]Bu aralıkla ilişkili geliştirici meta verilerini alır.
getDisplayValue()StringAralığın sol üst hücresindeki görüntülenen değeri döndürür.
getDisplayValues()String[][]Bu aralık için dikdörtgen değer ızgarasına döndürür.
getFilter()FilterBu aralığın ait olduğu sayfadaki filtreyi veya sayfada filtre yoksa null değerini döndürür.
getFontColorObject()ColorAralığın sol üst köşesindeki hücrenin yazı tipi rengini döndürür.
getFontColorObjects()Color[][]Aralıktaki hücrelerin yazı tipi renklerini döndürür.
getFontFamilies()String[][]Aralıktaki hücrelerin yazı tipi ailelerini döndürür.
getFontFamily()StringAralığın sol üst köşesindeki hücrenin yazı tipi ailesini döndürür.
getFontLine()StringAralığın sol üst köşesindeki hücrenin çizgi stilini ('underline', 'line-through' veya 'none') alır.
getFontLines()String[][]Aralıktaki hücrelerin çizgi stilini ('underline', 'line-through' veya 'none') alır.
getFontSize()IntegerAralığın sol üst köşesindeki hücrenin yazı tipi boyutunu punto cinsinden döndürür.
getFontSizes()Integer[][]Aralıktaki hücrelerin yazı tipi boyutlarını döndürür.
getFontStyle()StringAralığın sol üst köşesindeki hücrenin yazı tipi stilini ('italic' veya 'normal') döndürür.
getFontStyles()String[][]Aralıktaki hücrelerin yazı tipi stillerini döndürür.
getFontWeight()StringAralığın sol üst köşesindeki hücrenin yazı tipi kalınlığını (normal/kalın) döndürür.
getFontWeights()String[][]Aralıktaki hücrelerin yazı tipi ağırlıklarını döndürür.
getFormula()StringAralıktaki sol üst hücrenin formülünü (A1 gösterimi) veya hücre boşsa ya da formül içermiyorsa boş bir dize döndürür.
getFormulaR1C1()StringBelirli bir hücrenin formülünü (R1C1 gösterimi) veya formül yoksa null değerini döndürür.
getFormulas()String[][]Aralıktaki hücrelerin formüllerini (A1 gösterimi) döndürür.
getFormulasR1C1()String[][]Aralıktaki hücrelerin formüllerini (R1C1 gösterimi) döndürür.
getGridId()IntegerAralıktaki üst sayfanın ızgara kimliğini döndürür.
getHeight()IntegerAralığın yüksekliğini döndürür.
getHorizontalAlignment()StringAralığın sol üst köşesindeki hücrenin metninin yatay hizalamasını (sol/orta/sağ) döndürür.
getHorizontalAlignments()String[][]Aralıktaki hücrelerin yatay hizalamalarını döndürür.
getLastColumn()IntegerSon sütun konumunu döndürür.
getLastRow()IntegerSon satır konumunu döndürür.
getMergedRanges()Range[]Tamamen geçerli aralık içinde olan veya geçerli aralıktaki en az bir hücreyi içeren birleştirilmiş hücreleri temsil eden bir Range nesne dizisi döndürür.
getNextDataCell(direction)RangeAralığın ilk sütun ve satırındaki hücreden başlayarak, belirli bir yönde sonraki hücreyi döndürür. Bu hücre, içinde veri bulunan bitişik bir hücre aralığının kenarı veya elektronik tablonun o yönde kenarındaki hücredir.
getNote()StringBelirtilen aralıkla ilişkili notu döndürür.
getNotes()String[][]Aralıktaki hücrelerle ilişkili notları döndürür.
getNumColumns()IntegerBu aralıktaki sütun sayısını döndürür.
getNumRows()IntegerBu aralıktaki satır sayısını döndürür.
getNumberFormat()StringBelirtilen aralığın sol üst hücresinin sayı veya tarih biçimini alın.
getNumberFormats()String[][]Aralıktaki hücrelerin sayı veya tarih biçimlerini döndürür.
getRichTextValue()RichTextValueAralığın sol üst hücresinin zengin metin değerini veya hücre değeri metin değilse null değerini döndürür.
getRichTextValues()RichTextValue[][]Aralıktaki hücrelerin zengin metin değerlerini döndürür.
getRow()IntegerBu aralığın satır konumunu döndürür.
getRowIndex()IntegerBu aralığın satır konumunu döndürür.
getSheet()SheetBu aralığın ait olduğu sayfayı döndürür.
getTextDirection()TextDirectionAralıktaki sol üst hücrenin metin yönünü döndürür.
getTextDirections()TextDirection[][]Aralıktaki hücreler için metin yönergelerini döndürür.
getTextRotation()TextRotationAralıktaki sol üst hücrenin metin döndürme ayarlarını döndürür.
getTextRotations()TextRotation[][]Aralıktaki hücrelerin metin döndürme ayarlarını döndürür.
getTextStyle()TextStyleAralıktaki sol üst hücrenin metin stilini döndürür.
getTextStyles()TextStyle[][]Aralıktaki hücrelerin metin stillerini döndürür.
getValue()ObjectAralıktaki sol üst hücrenin değerini döndürür.
getValues()Object[][]Bu aralık için dikdörtgen değer ızgarasına döndürür.
getVerticalAlignment()StringAralıktaki sol üst köşedeki hücrenin dikey hizalamasını (üst/orta/alt) döndürür.
getVerticalAlignments()String[][]Aralıktaki hücrelerin dikey hizalamalarını döndürür.
getWidth()IntegerAralığın sütunlardaki genişliğini döndürür.
getWrap()BooleanHücredeki metnin sarmalanıp sarmalanmadığını döndürür.
getWrapStrategies()WrapStrategy[][]Aralıktaki hücreler için metin kaydırma stratejilerini döndürür.
getWrapStrategy()WrapStrategyAralıktaki sol üst hücrenin metin kaydırma stratejisini döndürür.
getWraps()Boolean[][]Hücrelerdeki metnin sarmalanıp sarmalanmadığını döndürür.
insertCells(shiftDimension)RangeBu alana boş hücreler ekler.
insertCheckboxes()Rangeİşaretli için true ve işaretsiz için false ile yapılandırılmış onay kutularını aralıktaki her hücreye ekler.
insertCheckboxes(checkedValue)Rangeİşaretli için özel bir değerle ve işaretli olmayan için boş dizeyle yapılandırılmış onay kutularını aralıktaki her hücreye ekler.
insertCheckboxes(checkedValue, uncheckedValue)RangeAralıktaki her hücreye, işaretli ve işaretli olmayan durumlar için özel değerlerle yapılandırılmış onay kutuları ekler.
isBlank()BooleanAralık tamamen boşsa true döndürülür.
isChecked()BooleanAralıktaki tüm hücrelerin onay kutusu durumunun "işaretli" olup olmadığını döndürür.
isEndColumnBounded()BooleanAralığın sonunun belirli bir sütuna bağlı olup olmadığını belirler.
isEndRowBounded()BooleanAralığın sonunun belirli bir satıra bağlı olup olmadığını belirler.
isPartOfMerge()BooleanGeçerli aralıktaki hücreler birleştirilmiş hücrelerle örtüşüyorsa true değerini döndürür.
isStartColumnBounded()BooleanAralığın başlangıcının belirli bir sütuna bağlı olup olmadığını belirler.
isStartRowBounded()BooleanAralığın başlangıcının belirli bir satıra bağlı olup olmadığını belirler.
merge()RangeAralıktaki hücreleri tek bir blok halinde birleştirir.
mergeAcross()RangeAralığın sütunlarındaki hücreleri birleştirin.
mergeVertically()RangeAralıktaki hücreleri birleştirir.
moveTo(target)voidBu aralığı (hem biçimi hem de değerleri) kesip hedef alana yapıştırın.
offset(rowOffset, columnOffset)RangeBu aralıktan belirli sayıda satır ve sütun (negatif olabilir) uzaklıkta olan yeni bir aralık döndürür.
offset(rowOffset, columnOffset, numRows)RangeGeçerli aralığa göre yeni bir aralık döndürür. Bu aralığın sol üst noktası, geçerli aralıktan belirli satır ve sütunlar kadar uzaktadır ve hücrelerdeki yükseklik de belirlidir.
offset(rowOffset, columnOffset, numRows, numColumns)RangeGeçerli aralığa göre yeni bir aralık döndürür. Bu aralığın sol üst noktası, geçerli aralığından belirli satır ve sütunlar kadar uzaktadır ve hücrelerde belirli bir yükseklik ve genişliğe sahiptir.
protect()Protectionİzin sahibi kullanıcılar dışındaki kullanıcıların düzenlemesini engelleyebilecek bir nesne oluşturur.
randomize()RangeBelirtilen aralıktaki satırların sırasını rastgele hale getirir.
removeCheckboxes()RangeAralıktaki tüm onay kutularını kaldırır.
removeDuplicates()RangeBu aralıktaki, önceki bir satırdaki değerlerin yinelemesi olan değerleri içeren satırları kaldırır.
removeDuplicates(columnsToCompare)RangeBelirtilen sütunlarda önceki bir satırdaki değerlerin yinelemesini içeren, bu aralıktaki satırları kaldırır.
setBackground(color)RangeCSS notasyonunda ('#ffffff' veya 'white' gibi) aralıktaki tüm hücrelerin arka plan rengini ayarlar.
setBackgroundObject(color)RangeAralıktaki tüm hücrelerin arka plan rengini ayarlar.
setBackgroundObjects(color)RangeDikdörtgen bir arka plan rengi ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setBackgroundRGB(red, green, blue)RangeRGB değerlerini (0 ile 255 dahili tam sayılar) kullanarak arka planı belirtilen renge ayarlar.
setBackgrounds(color)RangeDikdörtgen bir arka plan rengi ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setBorder(top, left, bottom, right, vertical, horizontal)RangeKenarlık özelliğini ayarlar.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeKenarlık özelliğini renk ve/veya stil ile ayarlar.
setDataValidation(rule)RangeAralıktaki tüm hücreler için bir veri doğrulama kuralı belirler.
setDataValidations(rules)RangeAralıktaki tüm hücreler için veri doğrulama kurallarını ayarlar.
setFontColor(color)RangeYazı tipi rengini CSS notasyonunda ('#ffffff' veya 'white' gibi) ayarlar.
setFontColorObject(color)RangeBelirtilen aralığın yazı tipi rengini ayarlar.
setFontColorObjects(colors)RangeYazı tipi renklerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFontColors(colors)RangeYazı tipi renklerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFontFamilies(fontFamilies)RangeYazı tipi ailelerinden dikdörtgen bir ızgara oluşturur (bu aralığın boyutlarıyla eşleşmelidir).
setFontFamily(fontFamily)Range"Arial" veya "Helvetica" gibi yazı tipi ailesini ayarlar.
setFontLine(fontLine)RangeBelirtilen aralığın yazı tipi çizgi stilini ('underline', 'line-through' veya 'none') belirler.
setFontLines(fontLines)RangeDikdörtgen bir çizgi stili ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFontSize(size)RangeYazı tipi boyutunu belirler. Boyut, kullanılacak punto boyutudur.
setFontSizes(sizes)RangeYazı tipi boyutlarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFontStyle(fontStyle)RangeBelirtilen aralık için yazı tipi stilini ayarlayın ('italic' veya 'normal').
setFontStyles(fontStyles)RangeYazı tipi stillerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFontWeight(fontWeight)RangeBelirtilen aralık için yazı tipi ağırlığını (normal/kalın) ayarlayın.
setFontWeights(fontWeights)RangeYazı tipi kalınlıklarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFormula(formula)RangeBu aralıktaki formülü günceller.
setFormulaR1C1(formula)RangeBu aralıktaki formülü günceller.
setFormulas(formulas)RangeDikdörtgen bir formül ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFormulasR1C1(formulas)RangeDikdörtgen bir formül ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setHorizontalAlignment(alignment)RangeBelirtilen aralık için yatay (soldan sağa) hizalamayı (sol/orta/sağ) ayarlayın.
setHorizontalAlignments(alignments)RangeYatay hizalamalarla dikdörtgen bir ızgara oluşturur.
setNote(note)RangeNotu belirtilen değere ayarlar.
setNotes(notes)RangeDikdörtgen bir not ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setNumberFormat(numberFormat)RangeSayı veya tarih biçimini belirtilen biçimlendirme dizesine ayarlar.
setNumberFormats(numberFormats)RangeSayı veya tarih biçimlerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setRichTextValue(value)RangeAralıktaki hücreler için zengin metin değerini ayarlar.
setRichTextValues(values)RangeZengin metin değerlerinin dikdörtgen bir ızgarasına ayarlanır.
setShowHyperlink(showHyperlink)RangeAralığın köprüleri gösterip göstermeyeceğini belirler.
setTextDirection(direction)RangeAralıktaki hücrelerin metin yönünü belirler.
setTextDirections(directions)RangeMetin yönlerinden oluşan dikdörtgen bir ızgara ayarlar.
setTextRotation(degrees)RangeAralıktaki hücreler için metin döndürme ayarlarını belirler.
setTextRotation(rotation)RangeAralıktaki hücreler için metin döndürme ayarlarını belirler.
setTextRotations(rotations)RangeMetin rotasyonlarından oluşan dikdörtgen bir ızgara ayarlar.
setTextStyle(style)RangeAralıktaki hücrelerin metin stilini ayarlar.
setTextStyles(styles)RangeMetin stillerinden oluşan dikdörtgen bir ızgara oluşturur.
setValue(value)RangeAralığın değerini ayarlar.
setValues(values)RangeDikdörtgen bir değer ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setVerticalAlignment(alignment)RangeBelirtilen aralık için dikey (üstten alta) hizalamayı (üst/orta/alt) ayarlayın.
setVerticalAlignments(alignments)RangeDikey hizalamalarla dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setVerticalText(isVertical)RangeAralıktaki hücrelerin metninin yığın halinde gösterilip gösterilmeyeceğini belirler.
setWrap(isWrapEnabled)RangeBelirtilen aralığın hücre sarma özelliğini ayarlayın.
setWrapStrategies(strategies)RangeDikdörtgen bir sarma stratejisi ızgarası ayarlar.
setWrapStrategy(strategy)RangeAralıktaki hücreler için metin kaydırma stratejisini belirler.
setWraps(isWrapEnabled)RangeSatır sonu politikalarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
shiftColumnGroupDepth(delta)RangeAralığın sütun gruplandırma derinliğini belirtilen miktar kadar değiştirir.
shiftRowGroupDepth(delta)RangeAralığın satır gruplandırma derinliğini belirtilen miktarda değiştirir.
sort(sortSpecObj)RangeBelirtilen aralıktaki hücreleri, sütuna ve belirtilen sıraya göre sıralar.
splitTextToColumns()voidOtomatik olarak algılanan bir sınırlayıcıya göre bir metin sütununu birden çok sütuna böler.
splitTextToColumns(delimiter)voidBelirtilen dizeyi özel ayırıcı olarak kullanarak bir metin sütununu birden çok sütuna böler.
splitTextToColumns(delimiter)voidBelirtilen sınırlayıcıya göre bir metin sütununu birden çok sütuna böler.
trimWhitespace()RangeBu aralıktaki her hücredeki boşlukları (boşluklar, sekmeler veya yeni satırlar gibi) kırpar.
uncheck()RangeAralıktaki onay kutularının durumunu "onaysız" olarak değiştirir.

Ayrıntılı dokümanlar

activate()

Belirtilen aralığı active range olarak, aralığın sol üst hücresini ise current cell olarak ayarlar.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:D10');
range.activate();

const selection = sheet.getSelection();
// Current cell: A1
const currentCell = selection.getCurrentCell();
// Active Range: A1:D10
const activeRange = selection.getActiveRange();

Return

Range: Zincirleme için bu aralık.


activateAsCurrentCell()

Belirtilen hücreyi current cell olarak ayarlar.

Belirtilen hücre mevcut bir aralıktaysa bu aralık, hücrenin geçerli hücre olduğu etkin aralık olur.

Belirtilen hücre mevcut bir aralıkta yoksa mevcut seçim kaldırılır ve hücre geçerli hücre ve etkin aralık olur.

Not: Belirtilen Range tek bir hücreden oluşmalıdır. Aksi takdirde istisna atılır.

// Gets the first sheet of the spreadsheet.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

// Gets the cell B5 and sets it as the active cell.
const range = sheet.getRange('B5');
const currentCell = range.activateAsCurrentCell();

// Logs the activated cell.
console.log(currentCell.getA1Notation());

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

addDeveloperMetadata(key)

Belirtilen anahtarla geliştirici meta verilerini aralığa ekler.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' to the developer metadata for row 2.
range.addDeveloperMetadata('NAME');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());

Parametreler

AdTürAçıklama
keyStringYeni geliştirici meta verilerinin anahtarı.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

addDeveloperMetadata(key, visibility)

Belirtilen anahtar ve görünürlükle geliştirici meta verilerini aralığa ekler.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT'
// for row 2 on Sheet1.
range.addDeveloperMetadata(
    'NAME',
    SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT,
);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getVisibility().toString());

Parametreler

AdTürAçıklama
keyStringYeni geliştirici meta verilerinin anahtarı.
visibilityDeveloperMetadataVisibilityYeni geliştirici meta verisinin görünürlüğü.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

addDeveloperMetadata(key, value)

Belirtilen anahtar ve değere sahip geliştirici meta verilerini aralığa ekler.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 of Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());

Parametreler

AdTürAçıklama
keyStringYeni geliştirici meta verilerinin anahtarı.
valueStringYeni geliştirici meta verisinin değeri.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

addDeveloperMetadata(key, value, visibility)

Belirtilen anahtar, değer ve görünürlükle geliştirici meta verilerini alana ekler.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to PROJECT for row 2 on the sheet.
range.addDeveloperMetadata(
    'NAME',
    'GOOGLE',
    SpreadsheetApp.DeveloperMetadataVisibility.PROJECT,
);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Parametreler

AdTürAçıklama
keyStringYeni geliştirici meta verilerinin anahtarı.
valueStringYeni geliştirici meta verisinin değeri.
visibilityDeveloperMetadataVisibilityYeni geliştirici meta verisinin görünürlüğü.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

applyColumnBanding()

Aralıka varsayılan bir sütun bantları teması uygular. Varsayılan olarak, bantlarda başlık rengi bulunur ve altbilgi rengi yoktur.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies column banding to row 2.
const colBanding = range.applyColumnBanding();

// Gets the first banding on the sheet and logs the color of the header column.
console.log(
    sheet.getBandings()[0]
        .getHeaderColumnColorObject()
        .asRgbColor()
        .asHexString(),
);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(
    sheet.getBandings()[0]
        .getSecondColumnColorObject()
        .asRgbColor()
        .asHexString(),
);

Return

Banding: Yeni bant.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

applyColumnBanding(bandingTheme)

Belirtilen bir sütun bantlama temasını aralığa uygular. Varsayılan olarak, bantlarda başlık rengi bulunur ve altbilgi rengi yoktur.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies the INDIGO color banding theme to the columns in row 2.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(
    sheet.getBandings()[0]
        .getSecondColumnColorObject()
        .asRgbColor()
        .asHexString(),
);

Parametreler

AdTürAçıklama
bandingThemeBandingThemeAralıktaki sütunlara uygulanacak renk teması.

Return

Banding: Yeni bant.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

applyColumnBanding(bandingTheme, showHeader, showFooter)

Belirtilen sütun bantlama temasını, belirtilen başlık ve altbilgi ayarlarıyla aralığa uygular.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 12-22 on the sheet.
const range = sheet.getRange('12:22');

// Applies the BLUE color banding theme to rows 12-22.
// Sets the header visibility to false and the footer visibility to true.
const colBanding = range.applyColumnBanding(
    SpreadsheetApp.BandingTheme.BLUE,
    false,
    true,
);

// Gets the banding color and logs it to the console.
console.log(
    sheet.getBandings()[0]
        .getSecondColumnColorObject()
        .asRgbColor()
        .asHexString(),
);

// Gets the header color object and logs it to the console. Returns null because
// the header visibility is set to false.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject());

// Gets the footer color and logs it to the console.
console.log(
    sheet.getBandings()[0]
        .getFooterColumnColorObject()
        .asRgbColor()
        .asHexString(),
);

Parametreler

AdTürAçıklama
bandingThemeBandingThemeAralıktaki sütunlara uygulanacak renk teması.
showHeaderBooleantrue ise bant tema başlığı rengi ilk sütuna uygulanır.
showFooterBooleantrue ise bant temalı altbilgi rengi son sütuna uygulanır.

Return

Banding: Yeni bant.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

applyRowBanding()

Aralıka varsayılan bir satır gruplandırma teması uygular. Varsayılan olarak, bantlarda başlık rengi bulunur ve altbilgi rengi yoktur.

// Opens the spreadsheet by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies row banding to rows 1-30.
range.applyRowBanding();

// Gets the hex color of the second banded row.
const secondRowColor =
    range.getBandings()[0].getSecondRowColorObject().asRgbColor().asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

Return

Banding: Alternatif arka plan rengi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

applyRowBanding(bandingTheme)

Belirtilen satır gruplandırma temasını aralığa uygular. Varsayılan olarak, bantlarda başlık rengi bulunur ve altbilgi rengi yoktur.

// Opens the spreadsheet by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding theme to rows 1-30.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the hex color of the second banded row.
const secondRowColor =
    range.getBandings()[0].getSecondRowColorObject().asRgbColor().asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

Parametreler

AdTürAçıklama
bandingThemeBandingThemeAralıktaki satırlara uygulanacak renk teması.

Return

Banding: Yeni bant.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

applyRowBanding(bandingTheme, showHeader, showFooter)

Belirtilen başlık ve altbilgi ayarlarıyla birlikte, belirtilen bir satır bantlama temasını aralığa uygular.

// Opens the spreadsheet by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding to rows 1-30 and
// specifies to hide the header and show the footer.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);

Parametreler

AdTürAçıklama
bandingThemeBandingThemeAralıktaki satırlara uygulanacak renk teması.
showHeaderBooleantrue ise bant tema başlığı rengi ilk satıra uygulanır.
showFooterBooleantrue ise bant tema altbilgi rengi son satıra uygulanır.

Return

Banding: Yeni bant.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

autoFill(destination, series)

destinationRange değerini, bu aralıktaki verilere göre verilerle doldurur. Yeni değerler, belirtilen series türüne göre de belirlenir. Hedef aralık bu aralığı içermeli ve yalnızca tek bir yönde genişletmelidir. Örneğin, aşağıdaki ifade A1:A20 A1:A4'daki mevcut değerlere göre artan bir sayı dizisiyle doldurur:

const sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
const sourceRange = sheet.getRange('A1:A4');
// The range to fill with values.
const destination = sheet.getRange('A1:A20');

// Inserts new values in A5:A20, continuing the pattern expressed in A1:A4
sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parametreler

AdTürAçıklama
destinationRangeDeğerlerle otomatik olarak doldurulacak aralık. Hedef aralık bu aralığı içermeli ve yalnızca tek bir yönde (yukarı, aşağı, sola veya sağa) genişletmelidir.
seriesAutoFillSeriesYeni değerleri hesaplamak için kullanılması gereken otomatik doldurma serisinin türü. Bu serinin etkisi, kaynak verilerin türüne ve miktarına göre değişir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

autoFillToNeighbor(series)

Komşu hücrelere göre yeni veri ile doldurulacak bir aralık hesaplar ve bu aralığı, bu aralıkta bulunan verilere göre otomatik olarak yeni değerlerle doldurur. Bu yeni değerler, belirtilen series türüne göre de belirlenir.

Hesaplanan hedef aralık, yeni değerlerin nereye ekleneceğini belirlemek için çevredeki verileri dikkate alır: Otomatik olarak doldurulan bir sütunun hemen solunda veya sağında veri varsa yeni değerler yalnızca bu bitişik verilere kadar uzanır.

Örneğin, A1:A20 bir dizi artan sayıyla doldurulmuşsa ve bu yöntem bir dizi tarih içeren B1:B4 aralığında çağrılırsa yeni değerler yalnızca B5:B20 alanına eklenir. Bu sayede bu yeni değerler, A sütunundaki değerleri içeren hücrelere "yapışır".

const sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
const sourceRange = sheet.getRange('B1:B4');

// Results in B5:B20 having values [1/5/2017, ... 1/20/2017]
sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parametreler

AdTürAçıklama
seriesAutoFillSeriesYeni değerleri hesaplamak için kullanılması gereken otomatik doldurma serisinin türü. Bu serinin etkisi, kaynak verilerin türüne ve miktarına göre değişir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

breakApart()

Aralıktaki çok sütunlu hücreleri tekrar tek hücrelere ayırın.

Bu işlevi bir aralık üzerinde çağırmak, bir aralık seçip Biçim > Hücreleri birleştir > Birleştirmeyi kaldır'ı tıklamakla aynıdır.

// Opens the spreadsheet by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Unmerges the range A1:C6 into individual cells.
range.breakApart();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

canEdit()

Kullanıcının, aralıktaki her hücreyi düzenleme izni olup olmadığını belirler. E-tablonun sahibi, korunan aralıkları ve sayfaları her zaman düzenleyebilir.

// Opens the spreadsheet by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Logs whether the user has permission to edit every cell in the range.
console.log(range.canEdit());

Return

Boolean: Kullanıcının aralıktaki her hücreyi düzenleme izni varsa true, aksi takdirde false değerini alır.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

check()

Aralıktaki onay kutularının durumunu "işaretli" olarak değiştirir. Aralıktaki, şu anda yapılandırılmış işaretli veya işaretli olmayan değeri içermeyen hücreler yoksayılır.

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the range A1:B10 to 'checked'.
const range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

clear()

İçerik ve biçim aralığını temizler.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.clear();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

clear(options)

Belirtilen ileri seviye seçeneklerle belirtildiği şekilde içerik aralığını, biçimi, veri doğrulama kurallarını ve/veya yorumları temizler. Varsayılan olarak tüm veriler temizlenir.

// The code below clears range C2:G7 in the active sheet, but preserves the
// format, data validation rules, and comments.
SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({
  contentsOnly: true
});

Parametreler

AdTürAçıklama
optionsObjectAşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi.

Gelişmiş parametreler

AdTürAçıklama
commentsOnlyBooleanYalnızca yorumların temizlenip temizlenmeyeceğini belirtir.
contentsOnlyBooleanYalnızca içeriğin temizlenip temizlenmeyeceği.
formatOnlyBooleanYalnızca biçimin temizlenip temizlenmeyeceği. Biçimin temizlenmesinin veri doğrulama kurallarının da temizlendiğini unutmayın.
validationsOnlyBooleanYalnızca veri doğrulama kurallarının temizlenip temizlenmeyeceği.
skipFilteredRowsBooleanFiltrelenmiş satırların temizlenip temizlenmeyeceği.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

clearContent()

Biçimlendirmeyi bozmadan aralığın içeriğini temizler.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.clearContent();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

clearDataValidations()

Aralıktaki veri doğrulama kurallarını temizler.

// Clear the data validation rules for cells A1:B5.
const range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

clearFormat()

Bu aralıktaki biçimlendirmeyi temizler.

Bu işlem, aralıkta bulunan hücre veya hücrelerin metin biçimlendirmesini temizler ancak sayı biçimlendirme kurallarını sıfırlamaz.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.clearFormat();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

clearNote()

Belirli bir hücre veya hücrelerdeki notu temizler.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.clearNote();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

collapseGroups()

Tamamen aralık içinde bulunan tüm grupları daraltır. Hiçbir grup tamamen aralık içinde değilse kısmen aralık içinde olan en derin genişletilmiş grup daraltılır.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getActiveRange();

// All row and column groups within the range are collapsed.
range.collapseGroups();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

copyFormatToRange(gridId, column, columnEnd, row, rowEnd)

Aralığın biçimlendirmesini belirtilen konuma kopyalar. Hedef, kaynak aralığından daha büyük veya daha küçükse kaynak buna göre tekrarlanır ya da kısaltılır. Bu yöntemin yalnızca biçimlendirmeyi kopyaladığını unutmayın.

gridId parametresinin ayrıntılı açıklaması için getGridId() bölümüne bakın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const source = ss.getSheets()[0];

const range = source.getRange('B2:D4');

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId
// of a sheet by calling sheet.getSheetId() or range.getGridId().
range.copyFormatToRange(1555299895, 4, 6, 4, 6);

Parametreler

AdTürAçıklama
gridIdIntegerKonumdan bağımsız olarak e-tablodaki sayfanın benzersiz kimliği.
columnIntegerHedef aralığın ilk sütunu.
columnEndIntegerHedef aralığın bitiş sütunu.
rowIntegerHedef aralığın başlangıç satırı.
rowEndIntegerHedef aralığın son satırı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Aşağıdaki kaynakları da incelemenizi öneririz:


copyFormatToRange(sheet, column, columnEnd, row, rowEnd)

Aralığın biçimlendirmesini belirtilen konuma kopyalar. Hedef, kaynak aralığından daha büyük veya daha küçükse kaynak buna göre tekrarlanır ya da kısaltılır. Bu yöntemin yalnızca biçimlendirmeyi kopyaladığını unutmayın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const source = ss.getSheets()[0];
const destination = ss.getSheets()[1];

const range = source.getRange('B2:D4');

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyFormatToRange(destination, 4, 6, 4, 6);

Parametreler

AdTürAçıklama
sheetSheetHedef sayfası.
columnIntegerHedef aralığın ilk sütunu.
columnEndIntegerHedef aralığın bitiş sütunu.
rowIntegerHedef aralığın başlangıç satırı.
rowEndIntegerHedef aralığın son satırı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

copyTo(destination)

Bir hücre aralığından başka bir hücre aralığına veri kopyalar. Hem değerler hem de biçimlendirme kopyalanır.

// The code below copies the first 5 columns over to the 6th column.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

Parametreler

AdTürAçıklama
destinationRangeKopyalanacağı hedef aralık. Yalnızca sol üst hücre konumu önemlidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

copyTo(destination, copyPasteType, transposed)

Bir hücre aralığından başka bir hücre aralığına veri kopyalar.

// The code below copies only the values of the first 5 columns over to the 6th
// column.
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange('A:E').copyTo(
    sheet.getRange('F1'),
    SpreadsheetApp.CopyPasteType.PASTE_VALUES,
    false,
);

Parametreler

AdTürAçıklama
destinationRangeKopyalanacağı hedef aralık. Yalnızca sol üst hücre konumu önemlidir.
copyPasteTypeCopyPasteTypeAralık içeriğinin hedefe nasıl yapıştırıldığını belirten bir tür.
transposedBooleanAralığın, transpoze edilmiş yönde yapıştırılıp yapıştırılmayacağını belirtir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

copyTo(destination, options)

Bir hücre aralığından başka bir hücre aralığına veri kopyalar. Varsayılan olarak hem değerler hem de biçimlendirme kopyalanır ancak bu, gelişmiş bağımsız değişkenler kullanılarak geçersiz kılınabilir.

// The code below copies only the values of the first 5 columns over to the 6th
// column.
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange('A:E').copyTo(sheet.getRange('F1'), {contentsOnly: true});

Parametreler

AdTürAçıklama
destinationRangeKopyalanacağı hedef aralık. Yalnızca sol üst hücre konumu önemlidir.
optionsObjectAşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi.

Gelişmiş parametreler

AdTürAçıklama
formatOnlyBooleanyalnızca biçimin kopyalanacağını belirtir
contentsOnlyBooleanYalnızca içeriğin kopyalanacağını belirtir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

copyValuesToRange(gridId, column, columnEnd, row, rowEnd)

Aralıktaki içeriği belirtilen konuma kopyalayın. Hedef, kaynak aralığından daha büyük veya daha küçükse kaynak buna göre tekrarlanır ya da kısaltılır.

gridId parametresinin ayrıntılı açıklaması için getGridId() bölümüne bakın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const source = ss.getSheets()[0];

const range = source.getRange('B2:D4');

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 0
range.copyValuesToRange(0, 4, 6, 4, 6);

Parametreler

AdTürAçıklama
gridIdIntegerKonumdan bağımsız olarak e-tablodaki sayfanın benzersiz kimliği.
columnIntegerHedef aralığın ilk sütunu.
columnEndIntegerHedef aralığın bitiş sütunu.
rowIntegerHedef aralığın başlangıç satırı.
rowEndIntegerHedef aralığın son satırı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Aşağıdaki kaynakları da incelemenizi öneririz:


copyValuesToRange(sheet, column, columnEnd, row, rowEnd)

Aralıktaki içeriği belirtilen konuma kopyalayın. Hedef, kaynak aralığından daha büyük veya daha küçükse kaynak buna göre tekrarlanır ya da kısaltılır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const source = ss.getSheets()[0];
const destination = ss.getSheets()[1];

const range = source.getRange('B2:D4');

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyValuesToRange(destination, 4, 6, 4, 6);

Parametreler

AdTürAçıklama
sheetSheetHedef sayfası.
columnIntegerHedef aralığın ilk sütunu.
columnEndIntegerHedef aralığın bitiş sütunu.
rowIntegerHedef aralığın başlangıç satırı.
rowEndIntegerHedef aralığın son satırı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

createDataSourcePivotTable(dataSource)

Veri kaynağından, bu aralıktaki ilk hücreye sabitlenmiş boş bir veri kaynağı pivot tablosu oluşturur.

Bu örnekte, yeni bir veri kaynağı pivot tablosunun nasıl oluşturulacağı ve yapılandırılacağı gösterilmektedir.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const anchorCell = spreadsheet.getSheets()[0].getRange('A1');
const dataSource = spreadsheet.getDataSources()[0];

const pivotTable = anchorCell.createDataSourcePivotTable(dataSource);
pivotTable.addRowGroup('dataColumnA');
pivotTable.addColumnGroup('dataColumnB');
pivotTable.addPivotValue(
    'dataColumnC',
    SpreadsheetApp.PivotTableSummarizeFunction.SUM,
);
pivotTable.addFilter(
    'dataColumnA',
    SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build(),
);

Parametreler

AdTürAçıklama
dataSourceDataSourcePivot tablonun oluşturulacağı veri kaynağı.

Return

DataSourcePivotTable: Yeni oluşturulan veri kaynağı pivot tablosu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

createDataSourceTable(dataSource)

Veri kaynağından, bu aralıktaki ilk hücreye sabitlenmiş boş bir veri kaynağı tablosu oluşturur.

Bu örnekte, yeni bir veri kaynağı tablosunun nasıl oluşturulacağı ve yapılandırılacağı gösterilmektedir.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const anchorCell = spreadsheet.getSheets()[0].getRange('A1');
const dataSource = spreadsheet.getDataSources()[0];

const dataSourceTable =
    anchorCell.createDataSourceTable(dataSource)
        .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
        .addSortSpec('dataColumnA', true)    // ascending=true
        .addSortSpec('dataColumnB', false);  // ascending=false

Parametreler

AdTürAçıklama
dataSourceDataSourcePivot tablonun oluşturulacağı veri kaynağı.

Return

DataSourceTable: Yeni oluşturulan veri kaynağı tablosu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

createDeveloperMetadataFinder()

Bu aralık kapsamındaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinderApi döndürür. Meta veriler yalnızca tamamen bu aralıkta yer alıyorsa aralığın kapsamındadır. Örneğin, "3:3" satırıyla ilişkili meta veriler "A1:D5" aralığının kapsamında değil, "1:5" aralığının kapsamındadır.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6.
const range = sheet.getRange('A1:C6');

// Creates a developer metadata finder to search for metadata in the scope of
// this range.
const developerMetaDataFinder = range.createDeveloperMetadataFinder();

// Logs information about the developer metadata finder to the console.
const developerMetaData = developerMetaDataFinder.find()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Return

DeveloperMetadataFinder: Bu aralık kapsamında meta veri aramak için bir geliştirici meta veri bulucusu.


createFilter()

Bir filtre oluşturur ve bu filtreyi sayfadaki belirtilen alana uygular. Bir sayfada birden fazla filtre oluşturamazsınız. Oluşturduğunuz filtreye erişmek ve filtreyi değiştirmek için getFilter() veya Sheet.getFilter() simgesini kullanın.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  const filter = range.getFilter();
  const criteria =
      SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
  filter.setColumnFilterCriteria(2, criteria);
}
Varsayılan e-tablo türü olan Grid e-tabloları için filtre oluşturmak üzere bu yöntemi kullanın. Tablo sayfaları, bir veritabanına bağlı olmayan sayfalardır. Diğer filtre türlerini oluşturmak için aşağıdakilere bakın:

Return

Filter: Yeni filtre.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

createPivotTable(sourceData)

Bu aralıktaki ilk hücreye sabitlenmiş, belirtilen sourceData alanından boş bir pivot tablo oluşturur.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 as a range in order to place the pivot table.
const range = sheet.getRange('A1');

// Gets the range of the source data for the pivot table.
const dataRange = sheet.getRange('E12:G20');

// Creates an empty pivot table from the specified source data.
const pivotTable = range.createPivotTable(dataRange);

// Logs the values from the pivot table's source data to the console.
console.log(pivotTable.getSourceDataRange().getValues());

Parametreler

AdTürAçıklama
sourceDataRangePivot tablonun oluşturulacağı veriler.

Return

PivotTable: Yeni oluşturulan PivotTable.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

createTextFinder(findText)

Aralık için bu aralıktaki metinleri bulup değiştirebilen bir metin bulucu oluşturur.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getActiveRange();

// Creates  a text finder for the range.
const textFinder = range.createTextFinder('dog');

// Returns the first occurrence of 'dog'.
const firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
const numOccurrencesReplaced = textFinder.replaceWith('cat');

Parametreler

AdTürAçıklama
findTextStringAranacak metin.

Return

TextFinder: Aralık için TextFinder


deleteCells(shiftDimension)

Bu hücre aralığını siler. Sayfada, belirtilen boyut boyunca mevcut veriler silinen aralığa doğru kaydırılır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Parametreler

AdTürAçıklama
shiftDimensionDimensionMevcut verilerin kaydırıldığı boyut.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

expandGroups()

Aralığı veya kontrol düğmesi bu aralıkla kesişen daraltılmış grupları genişletir. Kontrol düğmesi konumu, ayarlara bağlı olarak kontrol düğmesinin gösterildiği dizindir (doğrudan gruptan önce veya sonra). Aynı konumda birden fazla grup varsa en sığ grup genişletilir.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getActiveRange();

// All row and column groups within the range are expanded.
range.expandGroups();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getA1Notation()

A1 gösterimindeki aralığın dize açıklamasını döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange(1, 1, 2, 5);

// Logs "A1:E2"
Logger.log(range.getA1Notation());

Return

String: A1 gösterimindeki aralığın dize açıklaması.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getBackground()

Aralıktaki sol üst hücrenin arka plan rengini döndürür (örneğin, '#ffffff').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B5');
Logger.log(cell.getBackground());

Return

String: Arka planın renk kodu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getBackgroundObject()

Aralığın sol üst hücresinin arka plan rengini döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B5');
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

Return

Color: Aralığın sol üst hücresinin arka plan rengi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getBackgroundObjects()

Aralıktaki hücrelerin arka plan renklerini döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5:C6');
const bgColors = range.getBackgroundObjects();
for (const i in bgColors) {
  for (const j in bgColors[i]) {
    Logger.log(bgColors[i][j].asRgbColor().asHexString());
  }
}

Return

Color[][]: İki boyutlu bir arka plan rengi dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getBackgrounds()

Aralıktaki hücrelerin arka plan renklerini döndürür (örneğin, '#ffffff').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5:C6');
const bgColors = range.getBackgrounds();
for (const i in bgColors) {
  for (const j in bgColors[i]) {
    Logger.log(bgColors[i][j]);
  }
}

Return

String[][]: Arka planların renk kodlarından oluşan iki boyutlu bir dizi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getBandings()

Bu aralıktaki hücrelere uygulanan tüm bantları döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets a range.
const range = sheet.getRange('A1:K50');

// Gets the banding info for the range.
const bandings = range.getBandings();

// Logs the second row color for each banding to the console.
for (const banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Return

Banding[]: Bu aralıktaki hücrelere uygulanan tüm bantlar.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getCell(row, column)

Bir aralıktaki belirli bir hücreyi döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D4');

// The row and column here are relative to the range
// getCell(1,1) in this code returns the cell at B2
const cell = range.getCell(1, 1);
Logger.log(cell.getValue());

Parametreler

AdTürAçıklama
rowIntegerHücrenin aralığa göre satır numarası.
columnIntegerHücrenin aralığa göre sütunu.

Return

Range: Belirtilen koordinatlarda tek bir hücre içeren bir aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getColumn()

Bu aralığın başlangıç sütun konumunu döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D4');
// Logs "2.0"
Logger.log(range.getColumn());

Return

Integer: Aralığın e-tablodaki başlangıç sütunu konumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataRegion()

İçinde veri bulunan tüm bitişik hücreleri kapsayacak şekilde dört ana Direction yönünde genişletilmiş aralığın bir kopyasını döndürür. Aralık, köşegenler boyunca olanlar hariç boş hücrelerle çevriliyse aralığın kendisi döndürülür. Bu, aralığı seçip düzenleyicide Ctrl+A yazmaya benzer.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
sheet.getRange('C2').setValue(100);
sheet.getRange('B3').setValue(100);
sheet.getRange('D3').setValue(100);
sheet.getRange('C4').setValue(100);
// Logs "B2:D4"
Logger.log(sheet.getRange('C3').getDataRegion().getA1Notation());

Return

Range: Aralığın veri bölgesi veya e-tablonun tamamı için bir aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataRegion(dimension)

Belirtilen boyut Dimension.ROWS ise Direction.UP ve Direction.DOWN, boyut Dimension.COLUMNS ise Direction.NEXT ve Direction.PREVIOUS olarak genişletilmiş aralığın bir kopyasını döndürür. Aralığın genişletilmesi, aralığın yanında tablo gibi düzenlenmiş verilerin algılanmasına dayanır. Genişletilmiş aralık, tablo sınırları da dahil olmak üzere belirtilen boyut boyunca veri içeren tüm bitişik hücreleri kapsar. Orijinal aralık, belirtilen boyut boyunca boş hücrelerle çevriliyse aralığın kendisi döndürülür. Bu yöntem, aralığı seçip düzenleyicide sütunlar için Ctrl+Space veya satırlar için Shift+Space yazmaya benzer.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
sheet.getRange('C2').setValue(100);
sheet.getRange('B3').setValue(100);
sheet.getRange('D3').setValue(100);
sheet.getRange('C4').setValue(100);
// Logs "C2:C4"
Logger.log(
    sheet.getRange('C3')
        .getDataRegion(SpreadsheetApp.Dimension.ROWS)
        .getA1Notation(),
);
// Logs "B3:D3"
Logger.log(
    sheet.getRange('C3')
        .getDataRegion(SpreadsheetApp.Dimension.COLUMNS)
        .getA1Notation(),
);

Parametreler

AdTürAçıklama
dimensionDimensionAralığın genişletileceği boyut.

Return

Range: Aralığın veri bölgesi veya orijinal aralık tarafından kapsanan her sütunu ya da her satırı kapsayan bir aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataSourceFormula()

Aralıktaki ilk hücre için DataSourceFormula değerini veya hücre bir veri kaynağı formülü içermiyorsa null değerini döndürür.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1 on Sheet1.
const range = sheet.getRange('A1');

// Gets the data source formula from cell A1.
const dataSourceFormula = range.getDataSourceFormula();

// Gets the formula.
const formula = dataSourceFormula.getFormula();

// Logs the formula.
console.log(formula);

Return

DataSourceFormula: Hücrenin DataSourceFormula değeri.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataSourceFormulas()

Aralıktaki hücrelerin DataSourceFormula değerini döndürür.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:B5 on Sheet1.
const range = sheet.getRange('A1:B5');

// Gets an array of the data source formulas in the range A1:B5.
const dataSourceFormulas = range.getDataSourceFormulas();

// Logs the first formula in the array.
console.log(dataSourceFormulas[0].getFormula());

Return

DataSourceFormula[]: DataSourceFormula dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataSourcePivotTables()

Aralıkla kesişen tüm veri kaynağı pivot tablolarını alır.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets an array of the data source pivot tables in the range A1:G50.
const dataSourcePivotTables = range.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

Return

DataSourcePivotTable[]: Veri kaynağı pivot tablolarının listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataSourceTables()

Aralıkla kesişen tüm veri kaynağı tablolarını alır.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets the first data source table in the range A1:G50.
const dataSourceTable = range.getDataSourceTables()[0];

// Logs the time of the last completed data execution on the data source table.
console.log(dataSourceTable.getStatus().getLastExecutionTime());

Return

DataSourceTable[]: Veri kaynağı tablolarının listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataSourceUrl()

Bu aralıktaki verilerin URL'sini döndürür. Bu URL, grafik ve sorgu oluşturmak için kullanılabilir.

Code.gs

function doGet() {
  const ss = SpreadsheetApp.openById(
      '1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c',
  );
  const sheet = ss.getSheetByName('ContinentData');
  const range = sheet.getRange('A1:B8');

  const template = HtmlService.createTemplateFromFile('piechart');
  template.dataSourceUrl = range.getDataSourceUrl();
  return template.evaluate();
}

piechart.html

<!DOCTYPE html>
<html>
  <head>
    <!--Load the AJAX API-->
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      // Load the Visualization API and the corechart package.
      google.charts.load('current', {'packages': ['corechart']});

      // Set a callback to run when the Google Visualization API is loaded.
      google.charts.setOnLoadCallback(queryData);

      function queryData() {
        var query = new google.visualization.Query('<?= dataSourceUrl ?>');
        query.send(drawChart);
      }

      // Callback that creates and populates a data table,
      // instantiates the pie chart, passes in the data and
      // draws it.
      function drawChart(response) {
        if (response.isError()) {
          alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage());
          return;
        }
        var data = response.getDataTable();

        // Set chart options.
        var options = {
          title: 'Population by Continent',
          width: 400,
          height: 300
        };

        // Instantiate and draw the chart, passing in some options.
        var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <!-- Div that holds the pie chart. -->
    <div id="chart_div"></div>
  </body>
</html>

Return

String: Grafikler gibi diğer API'lere iletilebilecek bir veri kaynağı olarak bu aralık için bir URL.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataTable()

Bu nesnenin içindeki verileri DataTable olarak döndürme.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:B7 on Sheet1.
const range = sheet.getRange('A1:B7');

// Gets the range A1:B7 as a data table. The values in each column must be of
// the same type.
const datatable = range.getDataTable();

// Uses the Charts service to build a bar chart from the data table.
// This doesn't build an embedded chart. To do that, use
// sheet.newChart().addRange() instead.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Chart Title Here')
                  .build();

Return

DataTable: Veriler, veri tablosu olarak.


getDataTable(firstRowIsHeader)

Bu aralıktaki verileri DataTable olarak döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('A1:B7');

// Calling this method with "true" sets the first line to be the title of the
// axes
const datatable = range.getDataTable(true);

// Note that this doesn't build an EmbeddedChart, so you can't just use
// Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Title Here')
                  .build();

Parametreler

AdTürAçıklama
firstRowIsHeaderBooleanİlk satırın başlık olarak değerlendirilip değerlendirilmeyeceği.

Return

DataTable: Veriler, veri tablosu olarak.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataValidation()

Aralığın sol üst hücresindeki veri doğrulama kuralını döndürür. Hücrede veri doğrulama ayarlanmamışsa bu yöntem null değerini döndürür.

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

DataValidation: Aralığın sol üst hücresi için veri doğrulama kuralı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataValidations()

Aralıktaki tüm hücreler için veri doğrulama kurallarını döndürür. Belirli bir hücrede veri doğrulama ayarlanmamışsa bu yöntem, söz konusu hücrenin dizindeki konumu için null döndürü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);

Return

DataValidation[][]: Aralıktaki hücrelerle ilişkili iki boyutlu bir veri doğrulama kuralı dizisidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDeveloperMetadata()

Bu aralıkla ilişkili geliştirici meta verilerini alır.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds metadata to row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Logs the metadata to console.
for (const metadata of range.getDeveloperMetadata()) {
  console.log(`${metadata.getKey()}: ${metadata.getValue()}`);
}

Return

DeveloperMetadata[]: Bu aralıkla ilişkili geliştirici meta verileri.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDisplayValue()

Aralığın sol üst hücresindeki görüntülenen değeri döndürür. Değer bir String olmalıdır. Gösterilen değer, e-tablonun yerel ayarıyla otomatik olarak uygulanan biçimler dahil olmak üzere tarih, saat ve para birimi biçimlendirmesini dikkate alır. Boş hücreler boş bir dize döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its value to 'Test code.'
const cell = sheet.getRange('A30');
cell.setValue('Test code');

// Gets the value and logs it to the console.
console.log(cell.getDisplayValue());

Return

String: Bu hücrede gösterilen değerdir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDisplayValues()

Bu aralık için dikdörtgen değer ızgarasına döndürür.

Gösterilen değerlerin, satır ve sütuna göre dizine eklenen iki boyutlu bir dizisini döndürür. Değerler String nesneleridir. Gösterilen değer, e-tablonun yerel ayarıyla otomatik olarak uygulanan biçimler dahil olmak üzere tarih, saat ve para birimi biçimlendirmesini dikkate alır. Boş hücreler, dizede boş bir dizeyle temsil edilir. Aralık dizininin 1, 1 ile başladığını, JavaScript dizisinin ise [0][0] ile dizine eklendiğini unutmayın.

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
const values =
    SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

Return

String[][]: İki boyutlu bir değer dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFilter()

Bu aralığın ait olduğu sayfadaki filtreyi veya sayfada filtre yoksa null değerini döndürür.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
// Gets the existing filter on the sheet that the given range belongs to.
const filter = range.getFilter();

Return

Filter: Filtre.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontColorObject()

Aralığın sol üst köşesindeki hücrenin yazı tipi rengini döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontColorObject().asRgbColor().asHexString());

Return

Color: Aralıktaki sol üst hücrenin yazı tipi rengi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontColorObjects()

Aralıktaki hücrelerin yazı tipi renklerini döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontColorObjects();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j].asRgbColor().asHexString());
  }
}

Return

Color[][]: Aralıktaki hücrelerle ilişkili iki boyutlu bir yazı tipi rengi dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontFamilies()

Aralıktaki hücrelerin yazı tipi ailelerini döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontFamilies();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][]: Aralıktaki hücrelerle ilişkili iki boyutlu bir yazı tipi ailesi dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontFamily()

Aralığın sol üst köşesindeki hücrenin yazı tipi ailesini döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontFamily());

Return

String: Hücrenin yazı tipi ailesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontLine()

Aralığın sol üst köşesindeki hücrenin çizgi stilini ('underline', 'line-through' veya 'none') alır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontLine());

Return

String: Yazı tipi satırı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontLines()

Aralıktaki hücrelerin çizgi stilini ('underline', 'line-through' veya 'none') alır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontLines();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][]: Aralıktaki hücrelerle ilişkili iki boyutlu bir yazı tipi satırı dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontSize()

Aralığın sol üst köşesindeki hücrenin yazı tipi boyutunu punto cinsinden döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontSize());

Return

Integer: Punto boyutunda yazı tipi boyutu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontSizes()

Aralıktaki hücrelerin yazı tipi boyutlarını döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontSizes();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

Integer[][]: Aralıktaki hücrelerle ilişkili metinlerin yazı tipi boyutlarından oluşan iki boyutlu bir dizi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontStyle()

Aralığın sol üst köşesindeki hücrenin yazı tipi stilini ('italic' veya 'normal') döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontStyle());

Return

String: Hücredeki metnin yazı tipi stili.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontStyles()

Aralıktaki hücrelerin yazı tipi stillerini döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontStyles();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][]: Aralıktaki hücrelerle ilişkili metin yazı tipi stillerinin iki boyutlu dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontWeight()

Aralığın sol üst köşesindeki hücrenin yazı tipi kalınlığını (normal/kalın) döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontWeight());

Return

String: Hücredeki metnin yazı tipi ağırlığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFontWeights()

Aralıktaki hücrelerin yazı tipi ağırlıklarını döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontWeights();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][]: Aralıktaki hücrelerle ilişkili metinlerin yazı tipi ağırlıklarından oluşan iki boyutlu bir dizi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFormula()

Aralıktaki sol üst hücrenin formülünü (A1 gösterimi) veya hücre boşsa ya da formül içermiyorsa boş bir dize döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This assumes you have a function in B5 that sums up
// B2:B4
const range = sheet.getRange('B5');

// Logs the calculated value and the formula
Logger.log(
    'Calculated value: %s Formula: %s',
    range.getValue(),
    range.getFormula(),
);

Return

String: Hücrenin formülü.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFormulaR1C1()

Belirli bir hücrenin formülünü (R1C1 gösterimi) veya formül yoksa null değerini döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5');
const formula = range.getFormulaR1C1();
Logger.log(formula);

Return

String: R1C1 gösterimindeki formül.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFormulas()

Aralıktaki hücrelerin formüllerini (A1 gösterimi) döndürür. 2D dizideki girişler, formül içermeyen hücreler için boş dizelerdir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5:C6');
const formulas = range.getFormulas();
for (const i in formulas) {
  for (const j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Return

String[][]: Dize biçiminde iki boyutlu bir formül dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFormulasR1C1()

Aralıktaki hücrelerin formüllerini (R1C1 gösterimi) döndürür. 2D dizideki girişler, formül içermeyen hücreler için null olur.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5:C6');
const formulas = range.getFormulasR1C1();
for (const i in formulas) {
  for (const j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Return

String[][]: R1C1 gösterimindeki iki boyutlu bir formül dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getGridId()

Aralıktaki üst sayfanın ızgara kimliğini döndürür. Kimlikler, sıfırdan büyük rastgele tam sayı değerleridir.

// Log the grid ID of the first sheet (by tab position) in the spreadsheet.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getGridId());

Return

Integer: Üst sayfanın ızgara kimliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getHeight()

Aralığın yüksekliğini döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D4');
// logs 3.0
Logger.log(range.getHeight());

Return

Integer: Aralık yüksekliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getHorizontalAlignment()

Aralığın sol üst köşesindeki hücrenin metninin yatay hizalamasını (sol/orta/sağ) döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getHorizontalAlignment());

Return

String: Hücredeki metnin yatay hizalaması.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getHorizontalAlignments()

Aralıktaki hücrelerin yatay hizalamalarını döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getHorizontalAlignments();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][]: Aralıktaki hücrelerle ilişkili metinlerin yatay hizalamalarının iki boyutlu dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getLastColumn()

Son sütun konumunu döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D4');
// Logs "4.0"
Logger.log(range.getLastColumn());

Return

Integer: Aralığın e-tablodaki bitiş sütunu konumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getLastRow()

Son satır konumunu döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D4');
// Logs "4.0"
Logger.log(range.getLastRow());

Return

Integer: Aralığın e-tablodaki bitiş satır konumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getMergedRanges()

Tamamen geçerli aralık içinde olan veya geçerli aralıktaki en az bir hücreyi içeren birleştirilmiş hücreleri temsil eden bir Range nesne dizisi döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B3');

const mergedRanges = range.getMergedRanges();
for (let i = 0; i < mergedRanges.length; i++) {
  Logger.log(mergedRanges[i].getA1Notation());
  Logger.log(mergedRanges[i].getDisplayValue());
}

Return

Range[]: Aralıkla örtüşen birleştirilmiş hücreleri temsil eden bir Range nesnesi dizisi.


getNextDataCell(direction)

Aralığın ilk sütun ve satırındaki hücreden başlayarak, belirli bir yönde sonraki hücreyi döndürür. Bu hücre, içinde veri bulunan bitişik bir hücre aralığının kenarı veya elektronik tablonun o yönde kenarındaki hücredir. Bu, düzenleyicide Ctrl+[arrow key] yazılmasına eşdeğerdir.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('C3:E5');
// Logs "C1"
Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());

Parametreler

AdTürAçıklama
directionDirectionSonraki veri bölgesi kenar hücresinin bulunacağı yön.

Return

Range: Veri bölgesi kenar hücresi veya e-tablonun kenarındaki hücre.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getNote()

Belirtilen aralıkla ilişkili notu döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getNote());

Return

String: Belirli bir hücreyle ilişkili not.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getNotes()

Aralıktaki hücrelerle ilişkili notları döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getNotes();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][]: Aralıktaki hücrelerle ilişkili iki boyutlu bir not dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getNumColumns()

Bu aralıktaki sütun sayısını döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D5');
Logger.log(range.getNumColumns());

Return

Integer: Bu aralıktaki sütun sayısı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getNumRows()

Bu aralıktaki satır sayısını döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D5');
Logger.log(range.getNumRows());

Return

Integer: Bu aralıktaki satır sayısı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getNumberFormat()

Belirtilen aralığın sol üst hücresinin sayı veya tarih biçimini alın. Döndürülen biçim kalıpları E-Tablolar API dokümanlarında açıklanmıştır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('C4');
Logger.log(cell.getNumberFormat());

Return

String: Aralığın sol üst hücresinin sayı biçimi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getNumberFormats()

Aralıktaki hücrelerin sayı veya tarih biçimlerini döndürür. Döndürülen biçim kalıpları E-Tablolar API dokümanlarında açıklanmaktadır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5:C6');
const formats = range.getNumberFormats();
for (const i in formats) {
  for (const j in formats[i]) {
    Logger.log(formats[i][j]);
  }
}

Return

String[][]: İki boyutlu bir sayı biçimleri dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getRichTextValue()

Aralığın sol üst hücresinin zengin metin değerini veya hücre değeri metin değilse null değerini döndürür.

// Gets the Rich Text value of cell D4.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('D4:F6');
const richText = range.getRichTextValue();
console.log(richText.getText());

Return

RichTextValue: Aralığın sol üst hücresinin zengin metin değeridir. Hücre değeri metin değilse null değerini döndürür.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getRichTextValues()

Aralıktaki hücrelerin zengin metin değerlerini döndürür.

// Gets the Rich Text values for all cells in range B5:C6
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const values = range.getRichTextValues();

for (let i = 0; i < values.length; i++) {
  for (let j = 0; j < values[i].length; j++) {
    console.log(values[i][j].getText());
  }
}

Return

RichTextValue[][]: Zengin metin değerlerinin iki boyutlu bir dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getRow()

Bu aralığın satır konumunu döndürür. getRowIndex() ile aynıdır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2');
Logger.log(range.getRow());

Return

Integer: Aralığın satır konumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getRowIndex()

Bu aralığın satır konumunu döndürür. getRow() ile aynıdır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2');
Logger.log(range.getRowIndex());

Return

Integer: Aralığın satır konumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Aşağıdaki kaynakları da incelemenizi öneririz:


getSheet()

Bu aralığın ait olduğu sayfayı döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the sheet that the range belongs to.
const rangeSheet = range.getSheet();

// Gets the sheet name and logs it to the console.
console.log(rangeSheet.getName());

Return

Sheet: Bu aralığın ait olduğu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTextDirection()

Aralıktaki sol üst hücrenin metin yönünü döndürür. Hücre metin yönü otomatik algılama ile belirlenirse null döndürür.

// Get the text direction of cell B1.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B1:D4');
Logger.log(range.getTextDirection());

Return

TextDirection: Aralıktaki sol üst hücrenin metin yönü.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTextDirections()

Aralıktaki hücreler için metin yönergelerini döndürür. 2D dizideki girişler, otomatik algılama kullanan hücreler için null olur.

// Get the text directions for all cells in range B5:C6
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const directions = range.getTextDirections();

for (let i = 0; i < directions.length; i++) {
  for (let j = 0; j < directions[i].length; j++) {
    Logger.log(directions[i][j]);
  }
}

Return

TextDirection[][]: İki boyutlu bir metin yönleri dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTextRotation()

Aralıktaki sol üst hücrenin metin döndürme ayarlarını döndürür.

// Log the text rotation settings for a cell.
const sheet = SpreadsheetApp.getActiveSheet();

const cell = sheet.getRange('A1');
Logger.log(cell.getTextRotation());

Return

TextRotation: Metin döndürme ayarları.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTextRotations()

Aralıktaki hücrelerin metin döndürme ayarlarını döndürür.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

const results = range.getTextRotations();

for (const i in results) {
  for (const j in results[i]) {
    const rotation = results[i][j];
    Logger.log('Cell [%s, %s] has text rotation: %v', i, j, rotation);
  }
}

Return

TextRotation[][]: Aralıktaki hücrelerle ilişkili iki boyutlu bir metin rotasyonu dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTextStyle()

Aralıktaki sol üst hücrenin metin stilini döndürür.

// Get the text style of cell D4.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('D4:F6');
const style = range.getTextStyle();
Logger.log(style);

Return

TextStyle: Aralıktaki sol üst hücrenin metin stili.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTextStyles()

Aralıktaki hücrelerin metin stillerini döndürür.

// Get the text styles for all cells in range B5:C6
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const styles = range.getTextStyles();

for (let i = 0; i < styles.length; i++) {
  for (let j = 0; j < styles[i].length; j++) {
    Logger.log(styles[i][j]);
  }
}

Return

TextStyle[][]: İki boyutlu bir metin stili dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getValue()

Aralıktaki sol üst hücrenin değerini döndürür. Değer, hücrenin değerine bağlı olarak Number, Boolean, Date veya String türü olabilir. Boş hücreler boş bir dize döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the value of the top-left cell in the range and logs it to the console.
console.log(range.getValue());

Return

Object: Bu hücredeki değerdir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getValues()

Bu aralık için dikdörtgen değer ızgarasına döndürür.

Satır ve ardından sütuna göre dizine eklenen iki boyutlu bir değer dizisi döndürür. Değerler, hücrenin değerine bağlı olarak Number, Boolean, Date veya String türü olabilir. Boş hücreler, dizede boş bir dizeyle temsil edilir. Aralık dizininin 1, 1 ile başladığını, JavaScript dizisinin ise [0][0] ile dizine eklendiğini unutmayın.

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
const values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);
Web uygulamalarında Date değeri geçerli bir parametre değildir. getValues(), aralık Date değerine sahip bir hücre içeriyorsa web uygulamasına veri döndüremez. Bunun yerine, sayfadan alınan tüm değerleri Number, Boolean veya String gibi desteklenen bir JavaScript ilkel öğesine dönüştürün.

Return

Object[][]: İki boyutlu bir değer dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getVerticalAlignment()

Aralıktaki sol üst köşedeki hücrenin dikey hizalamasını (üst/orta/alt) döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getVerticalAlignment());

Return

String: Hücredeki metnin dikey hizalaması.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getVerticalAlignments()

Aralıktaki hücrelerin dikey hizalamalarını döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getVerticalAlignments();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][]: Aralıktaki hücrelerle ilişkili metinlerin dikey hizalamalarının iki boyutlu dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getWidth()

Aralığın sütunlardaki genişliğini döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the width of the range in number of columns and logs it to the console.
console.log(range.getWidth());

Return

Integer: Aralıktaki sütun sayısı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getWrap()

Hücredeki metnin sarmalanıp sarmalanmadığını döndürür. Daha ayrıntılı bir sarma stratejisi almak için getWrapStrategy() seçeneğini kullanın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getWrap());

Return

Boolean: Bu hücredeki metnin kaydırılıp kaydırılmadığını belirtir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getWrapStrategies()

Aralıktaki hücreler için metin kaydırma stratejilerini döndürür.

// Get the text wrapping strategies for all cells in range B5:C6
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const strategies = range.getWrapStrategies();

for (let i = 0; i < strategies.length; i++) {
  for (let j = 0; j < strategies[i].length; j++) {
    Logger.log(strategies[i][j]);
  }
}

Return

WrapStrategy[][]: Metin sarmalama stratejilerinden oluşan iki boyutlu bir dizi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getWrapStrategy()

Aralıktaki sol üst hücrenin metin kaydırma stratejisini döndürür.

// Get the text wrapping strategy of cell B1.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B1:D4');
Logger.log(range.getWrapStrategy());

Return

WrapStrategy: Aralıktaki sol üst hücrenin metin kaydırma stratejisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getWraps()

Hücrelerdeki metnin sarmalanıp sarmalanmadığını döndürür. Daha ayrıntılı bir sarma stratejisi almak için getWrapStrategies() seçeneğini kullanın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getVerticalAlignments();

for (const i in results) {
  for (const j in results[i]) {
    const isWrapped = results[i][j];
    if (isWrapped) {
      Logger.log('Cell [%s, %s] has wrapped text', i, j);
    }
  }
}

Return

Boolean[][]: Aralıktaki hücrelerle ilişkili metinlerin dikey hizalamalarının iki boyutlu dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

insertCells(shiftDimension)

Bu alana boş hücreler ekler. Yeni hücreler, daha önce bu aralığı kaplayan hücrelerdeki tüm biçimlendirmeleri korur. Sayfada, sağlanan boyut boyunca mevcut veriler eklenen aralıktan kaydırılır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Parametreler

AdTürAçıklama
shiftDimensionDimensionMevcut verilerin kaydırıldığı boyut.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

insertCheckboxes()

İşaretli için true ve işaretsiz için false ile yapılandırılmış onay kutularını aralıktaki her hücreye ekler. Aralıktaki tüm hücrelerin değerini false olarak ayarlar.

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'true'
// for checked and 'false' for unchecked. Also, sets the value of each cell in
// the range A1:B10 to 'false'.
range.insertCheckboxes();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

insertCheckboxes(checkedValue)

İşaretli için özel bir değerle ve işaretli olmayan için boş dizeyle yapılandırılmış onay kutularını aralıktaki her hücreye ekler. Aralıktaki her hücrenin değerini boş dize olarak ayarlar.

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes'
// for checked and the empty string for unchecked. Also, sets the value of each
// cell in the range A1:B10 to
//  the empty string.
range.insertCheckboxes('yes');

Parametreler

AdTürAçıklama
checkedValueObjectOnay kutusu veri doğrulaması için işaretli değer.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

insertCheckboxes(checkedValue, uncheckedValue)

Aralıktaki her hücreye, işaretli ve işaretli olmayan durumlar için özel değerlerle yapılandırılmış onay kutuları ekler. Aralıktaki her hücrenin değerini, işaretlenmemiş özel değere ayarlar.

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes'
// for checked and 'no' for unchecked. Also, sets the value of each cell in the
// range A1:B10 to 'no'.
range.insertCheckboxes('yes', 'no');

Parametreler

AdTürAçıklama
checkedValueObjectOnay kutusu veri doğrulaması için işaretli değer.
uncheckedValueObjectOnay kutusu veri doğrulaması için işaretli olmayan değer.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

isBlank()

Aralık tamamen boşsa true döndürülür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.isBlank());

Return

Boolean: Aralık boşsa true, aksi takdirde false değerini alır.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

isChecked()

Aralıktaki tüm hücrelerin onay kutusu durumunun "işaretli" olup olmadığını döndürür. Bazı hücreler işaretli, geri kalanı işaretsizse veya bazı hücrelerde onay kutusu veri doğrulaması yoksa null döndürür.

const range = SpreadsheetApp.getActive().getRange('A1:A3');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:A3.
range.insertCheckboxes('yes', 'no');

const range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Sets the value of isRange1Checked as true as it contains the checked value.
const isRange1Checked = range1.isChecked();

const range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('no');
// Sets the value of isRange2Checked as false as it contains the unchecked
// value.
const isRange2Checked = range2.isChecked();

const range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox
// value.
const isRange3Checked = range3.isChecked();

Return

Boolean: Aralıktaki tüm hücreler işaretliyse true, aralıktaki tüm hücreler işaretli değilse false veya hücrelerden herhangi birinin işareti yoksa ya da onay kutusu veri doğrulaması yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

isEndColumnBounded()

Aralığın sonunun belirli bir sütuna bağlı olup olmadığını belirler. Örneğin, A1:B10 veya B:B aralıkları (aralığın sonundaki sütunlara bağlı) için bu yöntem true döndürür. 3:7 veya A1:5 aralıkları (aralığın sonundaki belirli satırlara bağlı) için ise bu yöntem false döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular column and logs
// it to the console.
console.log(range.isEndColumnBounded());

Return

Boolean: Aralığın sonu belirli bir sütuna bağlıysa true, aksi takdirde false değerini alır.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

isEndRowBounded()

Aralığın sonunun belirli bir satıra bağlı olup olmadığını belirler. Örneğin, A1:B10 veya 3:7 aralıkları (aralığın sonundaki satırlarla sınırlı) için bu yöntem true değerini döndürür. B:B veya A1:C aralıkları (aralığın sonundaki belirli sütunlarla sınırlı) için ise false değerini döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular row and logs it
// to the console.
console.log(range.isEndRowBounded());

Return

Boolean: Aralığın sonu belirli bir satıra bağlıysa true, aksi takdirde false.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

isPartOfMerge()

Geçerli aralıktaki hücreler birleştirilmiş hücrelerle örtüşüyorsa true değerini döndürür.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B3');

// True if any of the cells in A1:B3 is included in a merge.
const isPartOfMerge = range.isPartOfMerge();

Return

Boolean: Aralık birleştirilmiş hücrelerle örtüşüyorsa true, aksi takdirde false döndürülür.


isStartColumnBounded()

Aralığın başlangıcının belirli bir sütuna bağlı olup olmadığını belirler. Örneğin, aralığın başındaki sütunlara bağlı olan A1:B10 veya B:B aralıkları için bu yöntem true değerini döndürür. Aralığın başındaki yalnızca bir satıra bağlı olan 3:7 aralığı için ise bu yöntem false değerini döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular column and logs
// it to the console.
console.log(range.isStartColumnBounded());

Return

Boolean: Aralığın başlangıcı belirli bir sütuna bağlıysa true, aksi takdirde false.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

isStartRowBounded()

Aralığın başlangıcının belirli bir satıra bağlı olup olmadığını belirler. Örneğin, aralığın başındaki satırlara bağlı olan A1:B10 veya 3:7 aralıkları için bu yöntem true değerini döndürür. Aralığın başındaki yalnızca belirli bir sütuna bağlı olan B:B aralığı için ise bu yöntem false değerini döndürür.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular row and logs it
// to the console.
console.log(range.isStartRowBounded());

Return

Boolean: Aralığın başlangıcı belirli bir satıra bağlıysa true, aksi takdirde false.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

merge()

Aralıktaki hücreleri tek bir blok halinde birleştirir.

const sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

mergeAcross()

Aralığın sütunlarındaki hücreleri birleştirin.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The code below merges cells C5:E5 into one cell
const range1 = sheet.getRange('C5:E5');
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
const range2 = sheet.getRange('F5:H6');
range2.mergeAcross();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

mergeVertically()

Aralıktaki hücreleri birleştirir.

const sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

moveTo(target)

Bu aralığı (hem biçimi hem de değerleri) kesip hedef alana yapıştırın.

// The code below moves the first 5 columns over to the 6th column
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange('A1:E').moveTo(sheet.getRange('F1'));

Parametreler

AdTürAçıklama
targetRangeBu aralığın kopyalanacağı hedef aralık. Yalnızca sol üst hücre konumu önemlidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

offset(rowOffset, columnOffset)

Bu aralıktan belirli sayıda satır ve sütun (negatif olabilir) uzaklıkta olan yeni bir aralık döndürür. Yeni aralık, orijinal aralıkla aynı boyuttadır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('A1');

// newCell references B2
const newCell = cell.offset(1, 1);

Parametreler

AdTürAçıklama
rowOffsetIntegerAralığın sol üst hücresinden aşağı doğru satır sayısı; negatif değerler, aralığın sol üst hücresinden yukarı doğru satırları temsil eder.
columnOffsetIntegerAralığın sol üst hücresinden sağdaki sütunların sayısı; negatif değerler, aralığın sol üst hücresinden soldaki sütunları temsil eder.

Return

Range: Zincirleme için bu aralık.


offset(rowOffset, columnOffset, numRows)

Geçerli aralığa göre yeni bir aralık döndürür. Bu aralığın sol üst noktası, geçerli aralıktan belirli satır ve sütunlar kadar uzaktadır ve hücrelerdeki yükseklik de belirlidir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('A1');

// newCell references B2:B3
const newRange = cell.offset(1, 1, 2);

Parametreler

AdTürAçıklama
rowOffsetIntegerAralığın sol üst hücresinden aşağı doğru satır sayısı; negatif değerler, aralığın sol üst hücresinden yukarı doğru satırları temsil eder.
columnOffsetIntegerAralığın sol üst hücresinden sağdaki sütunların sayısı; negatif değerler, aralığın sol üst hücresinden soldaki sütunları temsil eder.
numRowsIntegerYeni aralığın satır sayısı.

Return

Range: Zincirleme için bu aralık.


offset(rowOffset, columnOffset, numRows, numColumns)

Geçerli aralığa göre yeni bir aralık döndürür. Bu aralığın sol üst noktası, geçerli aralığından belirli satır ve sütunlar kadar uzaktadır ve hücrelerde belirli bir yükseklik ve genişliğe sahiptir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('A1');

// newCell references B2:C3
const newRange = cell.offset(1, 1, 2, 2);

Parametreler

AdTürAçıklama
rowOffsetIntegerAralığın sol üst hücresinden aşağı doğru satır sayısı; negatif değerler, aralığın sol üst hücresinden yukarı doğru satırları temsil eder.
columnOffsetIntegerAralığın sol üst hücresinden sağdaki sütunların sayısı; negatif değerler, aralığın sol üst hücresinden soldaki sütunları temsil eder.
numRowsIntegerYeni aralığın satır sayısı.
numColumnsIntegerYeni aralığın sütun genişliği.

Return

Range: Zincirleme için bu aralık.


protect()

İzin sahibi kullanıcılar dışındaki kullanıcıların düzenlemesini engelleyebilecek bir nesne oluşturur. Komut dosyası, aralığın düzenleyici listesini gerçekten değiştirene (Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) çağrısı yaparak veya Protection.setDomainEdit(editable) için yeni bir değer ayarlayarak) kadar izinler e-tablonun izinlerini yansıtır. Bu da aralığın korumasız kalması anlamına gelir. Aralık zaten korunuyorsa bu yöntem, mevcut aralıkla çakışan yeni bir korumalı aralık oluşturur. Bir hücre birden fazla korumalı aralık tarafından korunuyorsa ve bunlardan herhangi biri belirli bir kullanıcının hücreyi düzenlemesini engelliyorsa söz konusu kullanıcının hücreyi düzenlemesine izin verilmez.

// Protect range A1:B10, then remove all other users from the list of editors.
const ss = SpreadsheetApp.getActive();
const range = ss.getRange('A1:B10');
const protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if
// the user's edit permission comes from a group, the script throws an exception
// upon removing the group.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Return

Protection: Koruma ayarlarını temsil eden bir nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

randomize()

Belirtilen aralıktaki satırların sırasını rastgele hale getirir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('A1:C7');

// Randomizes the range
range.randomize();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

removeCheckboxes()

Aralıktaki tüm onay kutularını kaldırır. Her hücrenin veri doğrulamasını temizler ve hücre işaretli veya işaretsiz bir değer içeriyorsa değerini de temizler.

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

const range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

const range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

removeDuplicates()

Bu aralıktaki, önceki bir satırdaki değerlerin yinelemesi olan değerleri içeren satırları kaldırır. Aynı değerlere sahip ancak büyük/küçük harf kullanımı, biçimlendirme veya formül farklılığı olan satırlar yinelenen olarak kabul edilir. Bu yöntem, görünümden gizlenen (ör. bir filtre nedeniyle) yinelenen satırları da kaldırır. Bu aralığın dışındaki içerikler kaldırılmaz.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B1:D7');

// Remove duplicate rows in the range.
range.removeDuplicates();

Return

Range: Yinelenenler kaldırıldıktan sonra elde edilen aralık. Kaldırılan her satır için aralık boyutu bir satır azalır.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

removeDuplicates(columnsToCompare)

Belirtilen sütunlarda önceki bir satırdaki değerlerin yinelemesini içeren, bu aralıktaki satırları kaldırır. Aynı değerlere sahip ancak büyük/küçük harf kullanımı, biçimlendirme veya formül farklılığı olan satırlar yinelenen olarak kabul edilir. Bu yöntem, görünümden gizlenen yinelenen satırları da (ör. bir filtre nedeniyle) kaldırır. Bu aralığın dışındaki içerikler kaldırılmaz.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B1:D7');

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2, 4]);

Parametreler

AdTürAçıklama
columnsToCompareInteger[]Yinelenen değerler için analiz edilecek sütunlar. Sütun belirtilmezse tüm sütunlar yinelenenler açısından analiz edilir.

Return

Range: Yinelenenler kaldırıldıktan sonra elde edilen aralık. Kaldırılan her satır için aralık boyutu bir satır azalır.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setBackground(color)

CSS notasyonunda ('#ffffff' veya 'white' gibi) aralıktaki tüm hücrelerin arka plan rengini ayarlar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D5');
range.setBackground('red');

Parametreler

AdTürAçıklama
colorStringCSS notasyonunda bir renk kodu ('#ffffff' veya 'white' gibi); null değeri rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setBackgroundObject(color)

Aralıktaki tüm hücrelerin arka plan rengini ayarlar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const bgColor = SpreadsheetApp.newColor()
                    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
                    .build();

const range = sheet.getRange('B2:D5');
range.setBackgroundObject(bgColor);

Parametreler

AdTürAçıklama
colorColorAyarlanacak arka plan rengi; null değeri arka plan rengini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setBackgroundObjects(color)

Dikdörtgen bir arka plan rengi ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const colorAccent1 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                         .build();
const colorAccent2 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                         .build();
const colorAccent3 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                         .build();
const colorAccent4 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
                         .build();

const colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4],
];

const cell = sheet.getRange('B5:C6');
cell.setBackgroundObjects(colors);

Parametreler

AdTürAçıklama
colorColor[][]İki boyutlu bir renk dizisidir. null değerleri rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setBackgroundRGB(red, green, blue)

RGB değerlerini (0 ile 255 dahili tam sayılar) kullanarak arka planı belirtilen renge ayarlar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

Parametreler

AdTürAçıklama
redIntegerRGB gösterimindeki kırmızı değer.
greenIntegerRGB gösterimindeki yeşil değer.
blueIntegerRGB gösterimindeki mavi değer.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setBackgrounds(color)

Dikdörtgen bir arka plan rengi ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Renkler CSS notasyonundadır (ör. '#ffffff' veya 'white').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const colors = [
  ['red', 'white', 'blue'],
  ['#FF0000', '#FFFFFF', '#0000FF'],  // These are the hex equivalents
];

const cell = sheet.getRange('B5:D6');
cell.setBackgrounds(colors);

Parametreler

AdTürAçıklama
colorString[][]CSS notasyonunda iki boyutlu bir renk dizisi ('#ffffff' veya 'white' gibi); null değerleri rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setBorder(top, left, bottom, right, vertical, horizontal)

Kenarlık özelliğini ayarlar. Geçerli değerler true (açık), false (kapalı) ve null (değişiklik yok) şeklindedir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

Parametreler

AdTürAçıklama
topBooleanKenarlık için true, yok için false, değişiklik yok için null.
leftBooleanKenarlık için true, yok için false, değişiklik yok için null.
bottomBooleanKenarlık için true, yok için false, değişiklik yok için null.
rightBooleanKenarlık için true, yok için false, değişiklik yok için null.
verticalBooleanDahili dikey kenarlıklar için true, hiç kenarlık yok için false, değişiklik yok için null.
horizontalBooleanDahili yatay kenarlıklar için true, hiçbiri için false, değişiklik yok için null.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

Kenarlık özelliğini renk ve/veya stil ile ayarlar. Geçerli değerler true (açık), false (kapalı) ve null (değişiklik yok) şeklindedir. Renk için CSS notasyonunda renk kullanın (ör. '#ffffff' veya 'white').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(
    true,
    null,
    true,
    null,
    false,
    false,
    'red',
    SpreadsheetApp.BorderStyle.DASHED,
);

Parametreler

AdTürAçıklama
topBooleanKenarlık için true, yok için false, değişiklik yok için null.
leftBooleanKenarlık için true, yok için false, değişiklik yok için null.
bottomBooleanKenarlık için true, yok için false, değişiklik yok için null.
rightBooleanKenarlık için true, yok için false, değişiklik yok için null.
verticalBooleanDahili dikey kenarlıklar için true, hiç kenarlık yok için false, değişiklik yok için null.
horizontalBooleanDahili yatay kenarlıklar için true, hiçbiri için false, değişiklik yok için null.
colorStringCSS notasyonunda bir renk ('#ffffff' veya 'white' gibi), varsayılan renk için null (siyah).
styleBorderStyleKenarlıklar için bir stil. Varsayılan stil (döşeli) için null.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setDataValidation(rule)

Aralıktaki tüm hücreler için bir veri doğrulama kuralı belirler.

// Set the data validation rule 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);

Parametreler

AdTürAçıklama
ruleDataValidationAyarlanacak veri doğrulama kuralı veya veri doğrulamayı kaldırmak için null.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setDataValidations(rules)

Aralıktaki tüm hücreler için veri doğrulama kurallarını ayarlar. Bu yöntem, satır ve sütuna göre dizine eklenen iki boyutlu bir veri doğrulama dizisi alır. Dizi boyutları, aralık boyutlarıyla eşleşmelidir.

// Set the data validation rules for Sheet1!A1:B5 to require a value from
// Sheet2!A1:A10.
const destinationRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
const sourceRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
const rules = destinationRange.getDataValidations();
for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

Parametreler

AdTürAçıklama
rulesDataValidation[][]Ayarlanacak iki boyutlu veri doğrulama kuralı dizisi; null değerleri veri doğrulamayı kaldırır.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontColor(color)

Yazı tipi rengini CSS notasyonunda ('#ffffff' veya 'white' gibi) ayarlar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontColor('red');

Parametreler

AdTürAçıklama
colorStringCSS gösterimindeki yazı tipi rengi (ör. '#ffffff' veya 'white'); null değeri rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontColorObject(color)

Belirtilen aralığın yazı tipi rengini ayarlar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                  .build();

const cell = sheet.getRange('B2');
cell.setFontColor(color);

Parametreler

AdTürAçıklama
colorColorAyarlanacak yazı tipi rengi. null değeri rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontColorObjects(colors)

Yazı tipi renklerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const colorAccent1 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                         .build();
const colorAccent2 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                         .build();
const colorAccent3 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                         .build();
const colorAccent4 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
                         .build();

const colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4],
];

const cell = sheet.getRange('B5:C6');
cell.setFontColorObjects(colors);

Parametreler

AdTürAçıklama
colorsColor[][]İki boyutlu bir renk dizisidir. null değerleri yazı tipi rengini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontColors(colors)

Yazı tipi renklerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Renkler CSS notasyonundadır (ör. '#ffffff' veya 'white').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const colors = [
  ['red', 'white', 'blue'],
  ['#FF0000', '#FFFFFF', '#0000FF'],  // These are the hex equivalents
];

const cell = sheet.getRange('B5:D6');
cell.setFontColors(colors);

Parametreler

AdTürAçıklama
colorsObject[][]CSS notasyonunda iki boyutlu bir renk dizisi ('#ffffff' veya 'white' gibi); null değerleri rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontFamilies(fontFamilies)

Yazı tipi ailelerinden dikdörtgen bir ızgara oluşturur (bu aralığın boyutlarıyla eşleşmelidir). "Arial" veya "Helvetica", yazı tipi ailesine örnek olarak verilebilir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const fonts = [
  ['Arial', 'Helvetica', 'Verdana'],
  ['Courier New', 'Arial', 'Helvetica'],
];

const cell = sheet.getRange('B2:D3');
cell.setFontFamilies(fonts);

Parametreler

AdTürAçıklama
fontFamiliesObject[][]İki boyutlu bir yazı tipi ailesi dizisi; null değerleri yazı tipi ailesini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontFamily(fontFamily)

"Arial" veya "Helvetica" gibi yazı tipi ailesini ayarlar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontFamily('Helvetica');

Parametreler

AdTürAçıklama
fontFamilyStringAyarlanacak yazı tipi ailesi. null değeri yazı tipi ailesini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontLine(fontLine)

Belirtilen aralığın yazı tipi çizgi stilini ('underline', 'line-through' veya 'none') belirler.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontLine('line-through');

Parametreler

AdTürAçıklama
fontLineStringYazı tipi satır stili ('underline', 'line-through' veya 'none'). null değeri yazı tipi satır stilini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontLines(fontLines)

Dikdörtgen bir çizgi stili ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const fontLines = [['underline', 'line-through', 'none']];

const range = sheet.getRange('B2:D2');
range.setFontLines(fontLines);

Parametreler

AdTürAçıklama
fontLinesObject[][]Yazı tipi çizgi stillerinden oluşan iki boyutlu bir dizi ('underline', 'line-through' veya 'none'); null değerleri yazı tipi çizgi stilini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontSize(size)

Yazı tipi boyutunu belirler. Boyut, kullanılacak punto boyutudur.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontSize(20);

Parametreler

AdTürAçıklama
sizeIntegerPunto boyutunda bir yazı tipi boyutu.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontSizes(sizes)

Yazı tipi boyutlarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Boyutlar nokta cinsindendir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const fontSizes = [[16, 20, 24]];

const range = sheet.getRange('B2:D2');
range.setFontSizes(fontSizes);

Parametreler

AdTürAçıklama
sizesObject[][]İki boyutlu bir boyut dizisi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontStyle(fontStyle)

Belirtilen aralık için yazı tipi stilini ayarlayın ('italic' veya 'normal').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontStyle('italic');

Parametreler

AdTürAçıklama
fontStyleStringYazı tipi stili ('italic' veya 'normal'); null değeri yazı tipi stilini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontStyles(fontStyles)

Yazı tipi stillerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const fontStyles = [['italic', 'normal']];

const range = sheet.getRange('B2:C2');
range.setFontStyles(fontStyles);

Parametreler

AdTürAçıklama
fontStylesObject[][]'italic' veya 'normal' olan iki boyutlu bir yazı tipi stili dizisi; null değerleri yazı tipi stilini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontWeight(fontWeight)

Belirtilen aralık için yazı tipi ağırlığını (normal/kalın) ayarlayın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontWeight('bold');

Parametreler

AdTürAçıklama
fontWeightStringYazı tipi kalınlığı ('bold' veya 'normal'); null değeri yazı tipi kalınlığını sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFontWeights(fontWeights)

Yazı tipi kalınlıklarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Yazı tipi kalınlığı örneği "bold"dur.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const fontStyles = [['bold', 'bold', 'normal']];

const range = sheet.getRange('B2:D2');
range.setFontWeights(fontStyles);

Parametreler

AdTürAçıklama
fontWeightsObject[][]'bold' veya 'normal' olan iki boyutlu bir yazı tipi ağırlığı dizisi; null değerleri yazı tipi ağırlığını sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFormula(formula)

Bu aralıktaki formülü günceller. Belirtilen formül A1 gösterimde olmalıdır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B5');
cell.setFormula('=SUM(B3:B4)');

Parametreler

AdTürAçıklama
formulaStringHücre için ayarlanacak formülü temsil eden bir dize.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFormulaR1C1(formula)

Bu aralıktaki formülü günceller. Belirtilen formül R1C1 gösterimde olmalıdır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B5');
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

Parametreler

AdTürAçıklama
formulaStringBir dize formülü.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFormulas(formulas)

Dikdörtgen bir formül ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Verilen formüller A1 gösterimde olmalıdır. Bu yöntem, satır ve ardından sütuna göre dizine eklenen iki boyutlu bir formül dizisi alır. Dizi boyutları, aralık boyutlarıyla eşleşmelidir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This sets the formulas to be a row of sums, followed by a row of averages
// right below. The size of the two-dimensional array must match the size of the
// range.
const formulas = [
  ['=SUM(B2:B4)', '=SUM(C2:C4)', '=SUM(D2:D4)'],
  ['=AVERAGE(B2:B4)', '=AVERAGE(C2:C4)', '=AVERAGE(D2:D4)'],
];

const cell = sheet.getRange('B5:D6');
cell.setFormulas(formulas);

Parametreler

AdTürAçıklama
formulasString[][]Formüllerden oluşan iki boyutlu dize dizisi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFormulasR1C1(formulas)

Dikdörtgen bir formül ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Verilen formüller R1C1 gösterimde olmalıdır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This creates formulas for a row of sums, followed by a row of averages.
const sumOfRowsAbove = '=SUM(R[-3]C[0]:R[-1]C[0])';
const averageOfRowsAbove = '=AVERAGE(R[-4]C[0]:R[-2]C[0])';

// The size of the two-dimensional array must match the size of the range.
const formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove],
];

const cell = sheet.getRange('B5:D6');
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Parametreler

AdTürAçıklama
formulasString[][]R1C1 biçiminde iki boyutlu bir formül dizisi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setHorizontalAlignment(alignment)

Belirtilen aralık için yatay (soldan sağa) hizalamayı (sol/orta/sağ) ayarlayın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setHorizontalAlignment('center');

Parametreler

AdTürAçıklama
alignmentStringHizalama ('left', 'center' veya 'normal'); null değeri hizalamayı sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setHorizontalAlignments(alignments)

Yatay hizalamalarla dikdörtgen bir ızgara ayarlar. setHorizontalAlignment(alignment) bölümüne bakın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const horizontalAlignments = [['left', 'right', 'center']];

const range = sheet.getRange('B2:D2');
range.setHorizontalAlignments(horizontalAlignments);

Parametreler

AdTürAçıklama
alignmentsObject[][]'left', 'center' veya 'normal' olan iki boyutlu bir hizalama dizisi; null değeri, hizalamayı sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Aşağıdaki kaynakları da incelemenizi öneririz:


setNote(note)

Notu belirtilen değere ayarlar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setNote('This is a note');

Parametreler

AdTürAçıklama
noteStringAralık için ayarlanacak not değeri. null değeri notu kaldırır.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setNotes(notes)

Dikdörtgen bir not ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const notes = [
  ['it goes', 'like this', 'the fourth, the fifth'],
  ['the minor fall', 'and the', 'major lift'],
];

const cell = sheet.getRange('B2:D3');
cell.setNotes(notes);

Parametreler

AdTürAçıklama
notesObject[][]İki boyutlu bir not dizisidir. null değerleri notu kaldırır.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Aşağıdaki kaynakları da incelemenizi öneririz:


setNumberFormat(numberFormat)

Sayı veya tarih biçimini belirtilen biçimlendirme dizesine ayarlar. Kabul edilen biçim kalıpları E-Tablolar API dokümanlarında açıklanmaktadır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
// Always show 3 decimal points
cell.setNumberFormat('0.000');

Parametreler

AdTürAçıklama
numberFormatStringSayı biçimi dizesi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setNumberFormats(numberFormats)

Sayı veya tarih biçimlerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Değerler, E-Tablolar API dokümanlarında açıklandığı gibi biçim kalıbı dizeleridir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const formats = [['0.000', '0,000,000', '$0.00']];

const range = sheet.getRange('B2:D2');
range.setNumberFormats(formats);

Parametreler

AdTürAçıklama
numberFormatsObject[][]İki boyutlu bir sayı biçimleri dizisi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setRichTextValue(value)

Aralıktaki hücreler için zengin metin değerini ayarlar.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello"
// bolded.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const richText = SpreadsheetApp.newRichTextValue()
                     .setText('Hello world')
                     .setTextStyle(0, 5, bold)
                     .build();
range.setRichTextValue(richText);

Parametreler

AdTürAçıklama
valueRichTextValueİstediğiniz zengin metin değeri.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setRichTextValues(values)

Zengin metin değerlerinin dikdörtgen bir ızgarasına ayarlanır.

// Sets the cells in range A1:A2 to have Rich Text values.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:A2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const italic = SpreadsheetApp.newTextStyle().setItalic(true).build();
const richTextA1 = SpreadsheetApp.newRichTextValue()
                       .setText('This cell is bold')
                       .setTextStyle(bold)
                       .build();
const richTextA2 = SpreadsheetApp.newRichTextValue()
                       .setText('bold words, italic words')
                       .setTextStyle(0, 11, bold)
                       .setTextStyle(12, 24, italic)
                       .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Parametreler

AdTürAçıklama
valuesRichTextValue[][]İstediğiniz zengin metin değerleri.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Aralığın köprüleri gösterip göstermeyeceğini belirler.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its hyperlink value.
const range = sheet.getRange('A30');
range.setValue('https://www.example.com');

// Sets cell A30 to show hyperlinks.
range.setShowHyperlink(true);

Parametreler

AdTürAçıklama
showHyperlinkBooleanKöprünün gösterilip gösterilmeyeceği.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTextDirection(direction)

Aralıktaki hücrelerin metin yönünü belirler. Belirtilen yön null ise yön tahmin edilir ve ayarlanır.

// Sets right-to-left text direction for the range.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parametreler

AdTürAçıklama
directionTextDirectionİstenen metin yönü; null ise yön ayarlanmadan önce anlaşılır.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTextDirections(directions)

Metin yönlerinden oluşan dikdörtgen bir ızgara ayarlar. Belirtilen yön null ise yön tahmin edilir ve ayarlanır.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextDirections());

Parametreler

AdTürAçıklama
directionsTextDirection[][]İstenen metin yönleri; belirtilen bir yön null ise ayardan önce anlaşılır.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTextRotation(degrees)

Aralıktaki hücreler için metin döndürme ayarlarını belirler. Giriş, standart metin yönü ile istenen yön arasındaki açıya karşılık gelir. Sıfır girişi, metnin standart yönde ayarlandığını gösterir.

Soldan sağa metin yönü için pozitif açılar saat yönünün tersine, sağdan sola metin yönü için ise saat yönündedir.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setTextRotation(45);

Parametreler

AdTürAçıklama
degreesIntegerStandart yön ile istenen yön arasındaki açı. Soldan sağa metinlerde pozitif açılar saat yönünün tersine doğrudur.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTextRotation(rotation)

Aralıktaki hücreler için metin döndürme ayarlarını belirler.

// Sets all cell's in range B2:D4 to have the same text rotation settings as
// cell A1.
const sheet = SpreadsheetApp.getActiveSheet();

const rotation = sheet.getRange('A1').getTextRotation();

sheet.getRange('B2:D4').setTextRotation(rotation);

Parametreler

AdTürAçıklama
rotationTextRotationİstediğiniz metin döndürme ayarları.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTextRotations(rotations)

Metin rotasyonlarından oluşan dikdörtgen bir ızgara ayarlar.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextRotations());

Parametreler

AdTürAçıklama
rotationsTextRotation[][]İstediğiniz metin döndürme ayarları.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTextStyle(style)

Aralıktaki hücrelerin metin stilini ayarlar.

// Sets the cells in range C5:D6 to have underlined size 15 font.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('C5:D6');
const style =
    SpreadsheetApp.newTextStyle().setFontSize(15).setUnderline(true).build();
range.setTextStyle(style);

Parametreler

AdTürAçıklama
styleTextStyleİstediğiniz metin stili.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTextStyles(styles)

Metin stillerinden oluşan dikdörtgen bir ızgara oluşturur.

// Sets text styles for cells in range A1:B2
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const otherStyle = SpreadsheetApp.newTextStyle()
                       .setBold(true)
                       .setUnderline(true)
                       .setItalic(true)
                       .setForegroundColor('#335522')
                       .setFontSize(44)
                       .build();
range.setTextStyles([
  [bold, otherStyle],
  [otherStyle, bold],
]);

Parametreler

AdTürAçıklama
stylesTextStyle[][]İstediğiniz metin stilleri.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setValue(value)

Aralığın değerini ayarlar. Değer sayı, dize, boole veya tarih olabilir. '=' ile başlarsa formül olarak yorumlanır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setValue(100);

Parametreler

AdTürAçıklama
valueObjectAralığın değeri.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setValues(values)

Dikdörtgen bir değer ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Bir değer = ile başlıyorsa formül olarak yorumlanır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const values = [['2.000', '1,000,000', '$2.99']];

const range = sheet.getRange('B2:D2');
range.setValues(values);

Parametreler

AdTürAçıklama
valuesObject[][]İki boyutlu bir değer dizisi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setVerticalAlignment(alignment)

Belirtilen aralık için dikey (üstten alta) hizalamayı (üst/orta/alt) ayarlayın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setVerticalAlignment('middle');

Parametreler

AdTürAçıklama
alignmentStringHizalama ('top', 'middle' veya 'bottom'); null değeri hizalamayı sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setVerticalAlignments(alignments)

Dikey hizalamalarla dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const alignments = [['top', 'middle', 'bottom']];

const range = sheet.getRange('B2:D2');
range.setVerticalAlignments(alignments);

Parametreler

AdTürAçıklama
alignmentsObject[][]'top', 'middle' veya 'bottom' değerini alan iki boyutlu bir hizalama dizisi; null değeri, hizalamayı sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Aşağıdaki kaynakları da incelemenizi öneririz:


setVerticalText(isVertical)

Aralıktaki hücrelerin metninin yığın halinde gösterilip gösterilmeyeceğini belirler. Metin dikey olarak yığılmışsa metin döndürme derecesi ayarı yoksayılır.

// Sets all cell's in range B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setVerticalText(true);

Parametreler

AdTürAçıklama
isVerticalBooleanMetnin yığılıp yığılmayacağı.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setWrap(isWrapEnabled)

Belirtilen aralığın hücre sarma özelliğini ayarlayın.

Kaydırma özelliği etkin olan hücreler (varsayılan), içeriğin tamamını gösterecek şekilde yeniden boyutlandırılır. Satır sonuna sığdırma özelliği devre dışı bırakılmış hücreler, yeniden boyutlandırılmadan veya birden fazla satıra yayılmadan hücrede mümkün olduğunca fazla yer kaplar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setWrap(true);

Parametreler

AdTürAçıklama
isWrapEnabledBooleanMetnin kaydırılıp kaydırılmayacağı.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setWrapStrategies(strategies)

Dikdörtgen bir sarma stratejisi ızgarası ayarlar.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setWrapStrategies(range1.getWrapStrategies());

Parametreler

AdTürAçıklama
strategiesWrapStrategy[][]İstenen sarma stratejileri.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setWrapStrategy(strategy)

Aralıktaki hücreler için metin kaydırma stratejisini belirler.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parametreler

AdTürAçıklama
strategyWrapStrategyİstenen sarma stratejisi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setWraps(isWrapEnabled)

Satır sonu politikalarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Kaydırma özelliği etkinleştirilmiş hücreler (varsayılan ayar), içeriğin tamamını gösterecek şekilde yeniden boyutlandırılır. Satır sonuna sarma özelliği devre dışı bırakılmış hücreler, yeniden boyutlandırılmadan veya birden fazla satıra yayılmadan hücrede mümkün olduğunca fazla yer kaplar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const wraps = [[true, true, false]];

const range = sheet.getRange('B2:D2');
range.setWraps(wraps);

Parametreler

AdTürAçıklama
isWrapEnabledObject[][]Metnin bir hücreye sığıp sığmayacağını belirleyen iki boyutlu bir kaydırma değişkeni dizisi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Aşağıdaki kaynakları da incelemenizi öneririz:


shiftColumnGroupDepth(delta)

Aralığın sütun gruplandırma derinliğini belirtilen miktar kadar değiştirir.

Bu işlem, aralıkla kesişen gruplar oluşturma, değiştirme veya silme etkisine sahiptir. Pozitif deltalarda gruplar oluşturulur ve/veya değiştirilir. Negatif deltalarda ise gruplar silinir ve/veya değiştirilir.

Grup derinliği sıfırın altına veya sekizin üzerine düşürüldüğünde bu durum herhangi bir etki yaratmaz.

column group control position BEFORE ise ilk satırın derinliği değiştirilmeye çalışılırken hata oluşur.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getActiveRange();

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

Parametreler

AdTürAçıklama
deltaIntegerBu aralığın sütun grubu derinliğinin değiştirileceği miktar.

Return

Range: Zincirleme için bu aralık.

Atışlar

Error: Kontrol konumu GroupControlTogglePosition.BEFORE olduğunda ilk sütunun derinliğini değiştirmeye çalışırken

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

shiftRowGroupDepth(delta)

Aralığın satır gruplandırma derinliğini belirtilen miktarda değiştirir.

Bu işlem, aralıkla kesişen gruplar oluşturma, değiştirme veya silme etkisine sahiptir. Pozitif deltalarda gruplar oluşturulur ve/veya değiştirilir. Negatif deltalarda ise gruplar silinir ve/veya değiştirilir.

Grup derinliği sıfırın altına veya sekizin üzerine düşürüldüğünde bu durum herhangi bir etki yaratmaz.

row group control position BEFORE ise ilk satırın derinliği değiştirilmeye çalışılırken hata oluşur.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getActiveRange();

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

Parametreler

AdTürAçıklama
deltaIntegerBu aralığın satır grubu derinliğinin değiştirileceği miktar.

Return

Range: Zincirleme için bu aralık.

Atışlar

Error: Kontrol konumu GroupControlTogglePosition.BEFORE olduğunda ilk satırın derinliğini değiştirmeye çalışırken

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

sort(sortSpecObj)

Belirtilen aralıktaki hücreleri, sütuna ve belirtilen sıraya göre sıralar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('A1:C7');

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([
  {column: 2, ascending: false},
  {column: 1, ascending: true},
]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more
// readable code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([
  {column: 2, ascending: true},
  {column: 1, ascending: true},
]);

Parametreler

AdTürAçıklama
sortSpecObjObjectSıralama ölçütü olarak kullanılacak sütunlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

splitTextToColumns()

Otomatik olarak algılanan bir sınırlayıcıya göre bir metin sütununu birden çok sütuna böler.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns();

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

splitTextToColumns(delimiter)

Belirtilen dizeyi özel ayırıcı olarak kullanarak bir metin sütununu birden çok sütuna böler.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns('#');

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametreler

AdTürAçıklama
delimiterStringBölünecek özel ayırıcı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

splitTextToColumns(delimiter)

Belirtilen sınırlayıcıya göre bir metin sütununu birden çok sütuna böler.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametreler

AdTürAçıklama
delimiterTextToColumnsDelimiterBölünecek hazır sınırlayıcı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

trimWhitespace()

Bu aralıktaki her hücredeki boşlukları (boşluklar, sekmeler veya yeni satırlar gibi) kırpar. Her hücrenin metninin başındaki ve sonundaki tüm boşlukları kaldırır ve kalan boşluk karakterlerinin alt dizelerini tek bir boşluk karakterine indirger.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

range.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

uncheck()

Aralıktaki onay kutularının durumunu "işaretli değil" olarak değiştirir. Aralıktaki, şu anda yapılandırılmış işaretli veya işaretli olmayan değeri içermeyen hücreler yoksayılır.

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the range A1:B10 to 'unchecked'.
const range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Kullanımdan kaldırılan yöntemler