Class Range

Aralık

E-tablo aralıklarına erişme ve bu aralıkları değiştirme Bir aralık, sayfadaki tek bir hücre veya bitişik hücreler.

Yöntemler

YöntemDönüş türüKısa açıklama
activate()RangeBelirtilen aralığı active range olarak ayarlar ve üst current cell olarak aralıktaki sol hücreyi seçin.
activateAsCurrentCell()RangeBelirtilen hücreyi current cell olarak ayarlar.
addDeveloperMetadata(key)RangeBelirtilen anahtara sahip geliştirici meta verilerini aralığa ekler.
addDeveloperMetadata(key, visibility)RangeBelirtilen anahtara ve görünürlüğe sahip 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üğe sahip geliştirici meta verilerini aralığa ekler.
applyColumnBanding()BandingAralığa varsayılan bir sütun şeridi oluşturma teması uygular.
applyColumnBanding(bandingTheme)BandingAralığa belirli bir sütun şerit oluşturma teması uygular.
applyColumnBanding(bandingTheme, showHeader, showFooter)BandingBelirtilen üstbilgi ve altbilgiye sahip aralığa belirli bir sütun şerit oluşturma teması uygular Ayarlar'da devre dışı bırakabilirsiniz.
applyRowBanding()BandingAralığa varsayılan bir satır şeridi oluşturma teması uygular.
applyRowBanding(bandingTheme)BandingAralığa, belirtilen bir satır şeridi oluşturma teması uygular.
applyRowBanding(bandingTheme, showHeader, showFooter)BandingBelirtilen üstbilgi ve altbilgi ayarlarıyla aralığa belirli bir satır şeridi oluşturma teması uygular.
autoFill(destination, series)voiddestinationRange aralığını bu aralıktaki verilere dayalı verilerle doldurur.
autoFillToNeighbor(series)voidKomşu hücrelere göre yeni verilerle doldurulacak aralığı hesaplar ve otomatik olarak doldurur bu aralıktaki verilere dayalı olarak yeni değerlerle değiştirilir.
breakApart()RangeAralıktaki çok sütunlu hücreleri tekrar tek tek hücrelere bölü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)RangeAşağıdaki gibi içerik aralığını, biçimi, veri doğrulama kurallarını ve/veya yorumları temizler: verilen gelişmiş seçeneklerdir.
clearContent()RangeBiçimlendirmeyi değiştirmeden aralığın içeriğini temizler.
clearDataValidations()RangeAralıkla ilgili veri doğrulama kurallarını temizler.
clearFormat()RangeBu aralığın biçimlendirmesini temizler.
clearNote()RangeVerilen hücredeki veya hücrelerdeki notu temizler.
collapseGroups()RangeTamamen aralık içinde yer alan tüm grupları daraltır.
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)voidAralığın biçimlendirmesini belirtilen konuma kopyalayın.
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)voidAralığın biçimlendirmesini belirtilen konuma kopyalayın.
copyTo(destination)voidBir hücre aralığındaki verileri başka bir hücre aralığına kopyalar.
copyTo(destination, copyPasteType, transposed)voidBir hücre aralığındaki verileri başka bir hücre aralığına kopyalar.
copyTo(destination, options)voidBir hücre aralığındaki verileri başka bir hücre aralığına kopyalar.
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)voidAralığın içeriğini belirtilen konuma kopyalayın.
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)voidAralığın içeriğini belirtilen konuma kopyalayın.
createDataSourcePivotTable(dataSource)DataSourcePivotTableVeri kaynağından, ilk hücreye sabitlenmiş boş bir veri kaynağı pivot tablosu oluşturur bu aralıkta.
createDataSourceTable(dataSource)DataSourceTableVeri kaynağından, bu sayfadaki ilk hücreye sabitlenmiş boş bir veri kaynağı tablosu oluşturur aralığı.
createDeveloperMetadataFinder()DeveloperMetadataFinderBu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinderApi değeri döndürür aralığı.
createFilter()FilterBir filtre oluşturur ve bunu sayfada belirtilen aralığa uygular.
createPivotTable(sourceData)PivotTableBelirtilen sourceData sütunundan, ilk hücreye sabitlenmiş boş bir pivot tablo oluşturur bu aralıkta.
createTextFinder(findText)TextFinderAralık için, bu aralıktaki metni bulup değiştirebilen bir metin bulucu oluşturur.
deleteCells(shiftDimension)voidBu hücre aralığını siler.
expandGroups()RangeAralık veya kontrol açma/kapatma düğmesi bu aralıkla kesişen daraltılmış grupları genişletir.
getA1Notation()StringA1 gösteriminde aralığın dize açıklamasını döndürür.
getBackground()StringAralıkta sol üstteki hücrenin arka plan rengini döndürür (örneğin, '#ffffff').
getBackgroundObject()ColorAralıkta sol üstteki hücrenin 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 şeritleri 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ütunu konumunu döndürür.
getDataRegion()RangeDört kardinal Direction içinde genişletilen aralığın, tümünü kapsayacak şekilde bir kopyasını döndürür veri bulunan bitişik hücreler.
getDataRegion(dimension)RangeŞu durumda Direction.UP ve Direction.DOWN aralığının bir kopyasını döndürür: belirtilen boyut Dimension.ROWS veya boyut Dimension.COLUMNS ise Direction.NEXT ve Direction.PREVIOUS olur.
getDataSourceFormula()DataSourceFormulaAralıktaki ilk hücre için DataSourceFormula değerini veya aralıktaki ilk hücre için null değerini döndürür hücre, veri kaynağı formülü içermiyor.
getDataSourceFormulas()DataSourceFormula[]Aralıktaki hücreler için DataSourceFormula değerlerini 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 veriler için, grafik ve sorgu oluşturmak amacıyla kullanılabilecek bir URL döndürür.
getDataTable()DataTableBu nesnenin içindeki verileri DataTable olarak döndürün.
getDataTable(firstRowIsHeader)DataTableBu aralıktaki verileri DataTable olarak döndürün.
getDataValidation()DataValidationAralıkta sol üstteki hücre için 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ıkta sol üstte bulunan hücrenin görüntülenen değerini döndürür.
getDisplayValues()String[][]Bu aralığın değerlerin dikdörtgen tablosunu döndürür.
getFilter()FilterBu aralığın ait olduğu sayfadaki filtreyi veya filtre yoksa null döndürür. yapacaksınız.
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 alır ('underline', 'line-through' veya 'none').
getFontLines()String[][]Aralıktaki ('underline', 'line-through' veya 'none').
getFontSize()IntegerAralığın sol üst köşesindeki hücrenin nokta boyutunda yazı tipi boyutunu döndürür.
getFontSizes()Integer[][]Aralıktaki hücrelerin yazı tipi boyutlarını döndürür.
getFontStyle()StringSol üstteki hücrenin yazı tipi stilini ('italic' veya 'normal') döndürür köşesine eklenir.
getFontStyles()String[][]Aralıktaki hücrelerin yazı tipi stillerini döndürür.
getFontWeight()StringAralığın sol üst köşesindeki hücrenin yazı tipi ağırlığı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ığın sol üst hücresine ilişkin formülü (A1 gösterimini) veya hücre boş veya formül içermiyor.
getFormulaR1C1()StringBelirli bir hücrenin formülünü (R1C1 gösterimini) veya yoksa null değerini döndürür.
getFormulas()String[][]Aralıktaki hücrelere ait formülleri (A1 gösterimi) döndürür.
getFormulasR1C1()String[][]Aralıktaki hücrelere ait formülleri (R1C1 gösterimi) döndürür.
getGridId()IntegerAralığın üst sayfasının ızgara kimliğini döndürür.
getHeight()IntegerAralığın yüksekliğini döndürür.
getHorizontalAlignment()StringHücrenin sol üstteki metninin yatay hizalamasını (sola/orta/sağ) döndürür köşesine eklenir.
getHorizontalAlignments()String[][]Aralıktaki hücrelerin yatay hizalamalarını döndürür.
getLastColumn()IntegerBitiş sütunu konumunu döndürür.
getLastRow()IntegerBitiş satırı konumunu döndürür.
getMergedRanges()Range[]Tamamen var olan birleştirilmiş hücreleri temsil eden Range nesne dizisini döndürür veya geçerli aralıktaki en az bir hücreyi içermelidir.
getNextDataCell(direction)RangeAralığın ilk sütunundaki ve satırındaki hücreden başlayarak, veri içeren bitişik bir hücre aralığının kenarı olan yön kenarını, e-tablonun kenarına,
getNote()StringVerilen 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()StringVerilen aralığın sol üst tarafındaki hücrenin sayısını veya tarih biçimlendirmesini alın.
getNumberFormats()String[][]Aralıktaki hücrelerin sayısını veya tarih biçimlerini döndürür.
getRichTextValue()RichTextValueAralığın sol üst hücresi için Zengin Metin değerini veya hücreyse null değerini döndürür değer metin değil.
getRichTextValues()RichTextValue[][]Aralıktaki hücreler için Zengin Metin değerlerini döndürür.
getRow()IntegerBu aralık için satır konumunu döndürür.
getRowIndex()IntegerBu aralık için satır konumunu döndürür.
getSheet()SheetBu aralığın ait olduğu sayfayı döndürür.
getTextDirection()TextDirectionAralığın sol üst hücresinin metin yönünü döndürür.
getTextDirections()TextDirection[][]Aralıktaki hücrelerin metin yönlerini döndürür.
getTextRotation()TextRotationAralığın sol üst hücresi için metin döndürme ayarlarını döndürür.
getTextRotations()TextRotation[][]Aralıktaki hücreler için metin döndürme ayarlarını döndürür.
getTextStyle()TextStyleAralığın sol üst hücresinin metin stilini döndürür.
getTextStyles()TextStyle[][]Aralıktaki hücrelerin metin stillerini döndürür.
getValue()ObjectAralıkta sol üstte bulunan hücrenin değerini döndürür.
getValues()Object[][]Bu aralığın değerlerin dikdörtgen tablosunu döndürür.
getVerticalAlignment()StringHücrenin sol üst köşesinde dikey hizalamasını (üst/orta/alt) döndürür aralığı.
getVerticalAlignments()String[][]Aralıktaki hücrelerin dikey hizalamalarını döndürür.
getWidth()IntegerSütunlardaki aralığın genişliğini döndürür.
getWrap()BooleanHücredeki metnin kaydırılıp kaydırılmayacağını döndürür.
getWrapStrategies()WrapStrategy[][]Aralıktaki hücreler için metin kaydırma stratejilerini döndürür.
getWrapStrategy()WrapStrategyAralığın sol üst hücresinin metin kaydırma stratejisini döndürür.
getWraps()Boolean[][]Hücrelerdeki metnin kaydırılıp kaydırılmadığını döndürür.
insertCells(shiftDimension)RangeBu aralığa boş hücreler ekler.
insertCheckboxes()RangeAralıktaki her bir hücreye onay kutuları ekler. İşaretli olanlar ve işaretli olanlar için true ile yapılandırılır. İşaretlenmemiş için false.
insertCheckboxes(checkedValue)RangeAralıktaki her bir hücreye onay kutuları ekler. Bu alanlar, işaretlenmiş ve işaretlenmiş olanlar için özel bir değerle yapılandırılır. boş dizeyi işaretlemeyin.
insertCheckboxes(checkedValue, uncheckedValue)RangeAralıktaki her bir hücreye onay kutuları ekler, işaretli olanlar için özel değerlerle yapılandırılır kontrol edebilirsiniz.
isBlank()BooleanAralık tamamen boşsa true değerini döndürür.
isChecked()BooleanAralıktaki tüm hücrelerin onay kutusu durumunun "işaretli" olup olmadığını döndürür.
isEndColumnBounded()BooleanAralık sonunun belirli bir sütuna bağlı olup olmadığını belirler.
isEndRowBounded()BooleanAralık sonunun belirli bir satıra bağlı olup olmadığını belirler.
isPartOfMerge()BooleanGeçerli aralıktaki hücreler birleştirilmiş hücrelerle çakışırsa true değerini döndürür.
isStartColumnBounded()BooleanAralık başlangıcının belirli bir sütuna bağlı olup olmadığını belirler.
isStartRowBounded()BooleanAralık 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ıktaki hücreleri, aralıktaki sütunlarda birleştirin.
mergeVertically()RangeAralıktaki hücreleri birleştirir.
moveTo(target)voidBu aralıktan kesip (hem biçim hem de değerler) hedef aralığa yapıştırın.
offset(rowOffset, columnOffset)RangeBelirtilen satır ve sütun sayısına göre bu aralıktan uzaklık verilen yeni bir aralık döndürür (negatif olabilir).
offset(rowOffset, columnOffset, numRows)RangeSol üst noktası uzaklık verilen geçerli aralığa göre yeni bir aralık döndürür belirtilen satır ve sütunlara göre ve hücrelerde belirtilen yükseklikle geçerli aralıktan değiştirebilirsiniz.
offset(rowOffset, columnOffset, numRows, numColumns)RangeSol üst noktası uzaklık verilen geçerli aralığa göre yeni bir aralık döndürür geçerli aralıktan verilen satır ve sütunlara göre ve belirtilen yükseklik ve genişlikte hücreler.
protect()ProtectionAralığa erişimi olan kullanıcılar dışında, aralığın düzenlenmesine karşı korunabilecek bir nesne oluşturur. izni gerekir.
randomize()RangeVerilen 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ık içinde bulunan ve herhangi bir önceki satırda yer alır.
removeDuplicates(columnsToCompare)RangeBu aralık içinde bulunan ve belirtilen sütunlarda yinelenen değerler içeren satırları kaldırır önceki herhangi bir satırda değer olarak görünür.
setBackground(color)RangeCSS gösteriminde ('#ffffff' gibi) aralıktaki tüm hücrelerin arka plan rengini ayarlar veya 'white').
setBackgroundObject(color)RangeAralıktaki tüm hücrelerin arka plan rengini ayarlar.
setBackgroundObjects(color)RangeArka plan renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setBackgroundRGB(red, green, blue)RangeRGB değerlerini (0 ile 255 arasındaki tam sayılar dahil) kullanarak arka planı belirtilen renge ayarlar.
setBackgrounds(color)RangeArka plan renklerinin dikdörtgen ızgarasını 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 stille ayarlar.
setDataValidation(rule)RangeAralıktaki tüm hücreler için tek bir veri doğrulama kuralı ayarlar.
setDataValidations(rules)RangeAralıktaki tüm hücreler için veri doğrulama kurallarını ayarlar.
setFontColor(color)RangeCSS gösteriminde yazı tipi rengini ayarlar ('#ffffff' veya 'white' gibi).
setFontColorObject(color)RangeVerilen aralığın yazı tipi rengini ayarlar.
setFontColorObjects(colors)RangeYazı tipi renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFontColors(colors)RangeYazı tipi renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFontFamilies(fontFamilies)RangeYazı tipi ailelerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFontFamily(fontFamily)RangeYazı tipi ailesini ayarlar (ör. "SFTP") veya "Helvetica".
setFontLine(fontLine)RangeVerilen aralığın ('underline', 'line-through' veya 'none').
setFontLines(fontLines)RangeÇizgi stillerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFontSize(size)RangeYazı tipi boyutunu ayarlar. Boyut, kullanılacak nokta boyutudur.
setFontSizes(sizes)RangeYazı tipi boyutlarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFontStyle(fontStyle)RangeVerilen aralığın ('italic' veya 'normal') yazı tipi stilini ayarlayın.
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 ağırlıklarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFormula(formula)RangeBu aralığa ilişkin formülü günceller.
setFormulaR1C1(formula)RangeBu aralığa ilişkin formülü günceller.
setFormulas(formulas)RangeDikdörtgen formül ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setFormulasR1C1(formulas)RangeDikdörtgen formül ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setHorizontalAlignment(alignment)RangeVerilen aralık (sol/orta/sağ) için yatay (soldan sağa) hizalamayı ayarlayın.
setHorizontalAlignments(alignments)RangeYatay hizalamalardan oluşan dikdörtgen bir ızgara ayarlar.
setNote(note)RangeNotu verilen değere ayarlar.
setNotes(notes)RangeDikdörtgen bir not ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setNumberFormat(numberFormat)RangeSayıyı veya tarih biçimini, verilen biçimlendirme dizesine ayarlar.
setNumberFormats(numberFormats)RangeSayı veya tarih biçimlerinden oluşan dikdörtgen bir tablo 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 ızgarasını ayarlar.
setShowHyperlink(showHyperlink)RangeAralığın köprüleri gösterip göstermeyeceğini belirler.
setTextDirection(direction)RangeAralıktaki hücrelerin metin yönünü ayarlar.
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 döndürmeleri için dikdörtgen bir tablo ayarlar.
setTextStyle(style)RangeAralıktaki hücrelerin metin stilini ayarlar.
setTextStyles(styles)RangeMetin stillerinden oluşan dikdörtgen bir ızgara ayarlar.
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)RangeVerilen aralık (üst/orta/alt) için dikey (üstten alta) hizalamayı ayarlayın.
setVerticalAlignments(alignments)RangeDikey hizalamaları içeren dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
setVerticalText(isVertical)RangeAralıktaki hücreler için metnin yığın halinde yığılıp yığılmayacağını ayarlar.
setWrap(isWrapEnabled)RangeVerilen aralığın hücre sarmalamayı ayarlayın.
setWrapStrategies(strategies)RangeSarma stratejilerinden oluşan bir dikdörtgen ızgara ayarlar.
setWrapStrategy(strategy)RangeAralıktaki hücreler için metin kaydırma stratejisini ayarlar.
setWraps(isWrapEnabled)RangeKelime kaydırma politikalarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
shiftColumnGroupDepth(delta)RangeAralığın sütun gruplama derinliğini belirtilen tutara göre değiştirir.
shiftRowGroupDepth(delta)RangeAralığın satır gruplama derinliğini belirtilen tutara göre değiştirir.
sort(sortSpecObj)RangeVerilen aralıktaki hücreleri, belirtilen sütun ve düzene göre sıralar.
splitTextToColumns()voidBir metin sütununu, otomatik olarak algılanan sınırlayıcıya göre birden fazla sütuna böler.
splitTextToColumns(delimiter)voidBelirtilen dizeyi özel sınırlayıcı olarak kullanarak bir metin sütununu birden fazla sütuna böler.
splitTextToColumns(delimiter)voidBir metin sütununu, belirtilen sınırlayıcıya göre birden fazla sütuna böler.
trimWhitespace()RangeBu aralıktaki her hücredeki boşlukları (ör. boşluklar, sekmeler veya yeni satırlar) kırpar.
uncheck()RangeAralıktaki onay kutularının durumunu "işareti kaldırıldı" olarak değiştirir.

Ayrıntılı belgeler

activate()

Belirtilen aralığı, en üstteki active range olacak şekilde ayarlar current cell olarak aralıktaki sol hücreyi seçin.

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

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D10
var 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 etkin olacak hücrenin bulunduğu aralık.

Belirtilen hücre mevcut aralıklardan herhangi birinde bulunmuyorsa 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 kabul edersiniz.

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

// Gets the cell B5 and sets it as the active cell.
var range = sheet.getRange('B5');
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

addDeveloperMetadata(key)

Belirtilen anahtara 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 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

addDeveloperMetadata(key, visibility)

Belirtilen anahtara ve görünürlüğe 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 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 verilerinin görünürlüğü.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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 verilerinin değeri.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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üğe 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 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 verilerinin değeri.
visibilityDeveloperMetadataVisibilityYeni geliştirici meta verilerinin görünürlüğü.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

applyColumnBanding()

Aralığa varsayılan bir sütun şeridi oluşturma teması uygular. Varsayılan olarak şerit oluşturma; üstbilgiye sahiptir ve altbilgi rengi.

// 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 müzik grupları.

Yetkilendirme

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

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

applyColumnBanding(bandingTheme)

Aralığa belirli bir sütun şerit oluşturma teması uygular. Varsayılan olarak şerit oluşturma; başlık ve altbilgi rengi yok.

// 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 bir renk teması.

Return

Banding — Yeni müzik grupları.

Yetkilendirme

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

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

applyColumnBanding(bandingTheme, showHeader, showFooter)

Belirtilen üstbilgi ve altbilgiye sahip aralığa belirli bir sütun şerit oluşturma teması uygular Ayarlar'da devre dışı bırakabilirsiniz.

// 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 bir renk teması.
showHeaderBooleantrue ise şerit oluşturma teması başlık rengi ilk sütununa girin.
showFooterBooleantrue ise şerit oluşturma teması altbilgi rengi son sütununa girin.

Return

Banding — Yeni müzik grupları.

Yetkilendirme

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

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

applyRowBanding()

Aralığa varsayılan bir satır şeridi oluşturma teması uygular. Varsayılan olarak şerit oluşturma; üstbilgiye sahiptir ve altbilgi rengi.

// 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 — Bant oluşturma.

Yetkilendirme

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

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

applyRowBanding(bandingTheme)

Aralığa, belirtilen bir satır şeridi oluşturma teması uygular. Varsayılan olarak şerit oluşturma; üstbilgiye sahiptir ve altbilgi rengi.

// 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 müzik grupları.

Yetkilendirme

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

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

applyRowBanding(bandingTheme, showHeader, showFooter)

Belirtilen üstbilgi ve altbilgi ayarlarıyla aralığa belirli bir satır şeridi oluşturma teması 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 değerine ayarlanırsa şerit oluşturma teması başlık rengi ilk satıra uygulanır.
showFooterBooleantrue değerine ayarlanırsa şerit oluşturma teması altbilgi rengi son satıra uygulanır.

Return

Banding — Yeni müzik grupları.

Yetkilendirme

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

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

autoFill(destination, series)

destinationRange aralığını bu aralıktaki verilere dayalı verilerle doldurur. Yeni değerler belirtilen series türüne göre de belirlenir. Hedef aralık şunları içermelidir: yalnızca tek bir yöne doğru genişletin. Örneğin, aşağıdakiler A1:A20 alanını doldurur A1:A4 içindeki mevcut değerlere göre artan bir sayı dizisiyle:

var sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
var sourceRange = sheet.getRange("A1:A4");
// The range to fill with values.
var 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ığı içeren bir liste oluşturabilir ve yalnızca tek bir yönde (yukarı, aşağı, sola veya sağ.)
seriesAutoFillSeriesYeni değerleri hesaplamak için kullanılması gereken autoFill serisinin türü. İlgili içeriği oluşturmak için kullanılan bu serinin etkisi, kaynak verilerin türüne ve miktarına göre farklılık gösterir.

Yetkilendirme

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

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

autoFillToNeighbor(series)

Komşu hücrelere göre yeni verilerle doldurulacak aralığı hesaplar ve otomatik olarak doldurur bu aralıktaki verilere dayalı olarak yeni değerlerle değiştirilir. Bu yeni değerler ayrıca belirtilen series türüne göre belirlenir.

Hesaplanan hedef aralığı, yeni trafiğin nerede olduğunu belirlemek için çevredeki verileri dikkate alır. değerleri eklenmelidir: Sütunun hemen solunda veya sağında Otomatik olarak doldurulduğundan, yeni değerler yalnızca bu bitişik verilere kadar genişler.

Örneğin, A1:A20 bir dizi artan sayıyla doluysa ve bu yöntem bir tarih dizisini içeren B1:B4 aralığında çağrılır; yeni değerler yalnızca B5:B20 içine eklendi. Bu şekilde, söz konusu yeni değerler “kalıcı” ekleyebileceğiniz değerleri gösterilir.

var sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
var 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 autoFill serisinin türü. İlgili içeriği oluşturmak için kullanılan bu serinin etkisi, kaynak verilerin türüne ve miktarına göre farklılık gösterir.

Yetkilendirme

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

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

breakApart()

Aralıktaki çok sütunlu hücreleri tekrar tek tek hücrelere bölün.

Bu işlevi bir aralıkta çağırmak, bir aralık seçip üzerine basarak Biçimlendir > Hücreleri birleştir > Birleştirilenleri ayı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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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-tablo sahibi her zaman korunan aralıkları ve sayfaları 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; false aksi takdirde.

Yetkilendirme

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

  • 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 hücreleri yoksayar Bu segmentler, şu anda yapılandırılmış veya işaretli olmayan değerleri içermiyor.

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

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

clear()

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

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

var range = sheet.getRange("A1:D10");
range.clear();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

clear(options)

Aşağıdaki gibi içerik aralığını, biçimi, veri doğrulama kurallarını ve/veya yorumları temizler: verilen gelişmiş seçeneklerdir. 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 belirler.
contentsOnlyBooleanYalnızca içeriğin temizlenip temizlenmeyeceğini belirler.
formatOnlyBooleanYalnızca biçimin temizlenip temizlenmeyeceğini belirler. temizlemenin biçimi veri doğrulama kurallarını da temizler.
validationsOnlyBooleanYalnızca veri doğrulama kurallarının temizlenip temizlenmeyeceğini belirler.
skipFilteredRowsBooleanFiltrelenmiş satırların temizlenip temizlenmeyeceğini belirler.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

clearContent()

Biçimlendirmeyi değiştirmeden aralığın içeriğini temizler.

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

var range = sheet.getRange("A1:D10");
range.clearContent();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

clearDataValidations()

Aralıkla ilgili veri doğrulama kurallarını temizler.

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

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

clearFormat()

Bu aralığın biçimlendirmesini temizler.

Bu işlemle, aralıktaki hücre veya hücrelerin metin biçimlendirmesi temizlenir, ancak bunlarda herhangi bir sıfırlanmaz sayı biçimlendirme kuralları vardır.

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

var range = sheet.getRange("A1:D10");
range.clearFormat();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

clearNote()

Verilen hücredeki veya hücrelerdeki notu temizler.

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

var range = sheet.getRange("A1:D10");
range.clearNote();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

collapseGroups()

Tamamen aralık içinde yer alan tüm grupları daraltır. Hiçbir grup tam olarak kapsam içinde değilse aralığın içinde kısmen bulunan en derin genişletilmiş grup daraltılır.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 kopyalayın. Hedef daha büyük veya küçükse kaynak aralıktan daha fazla ise kaynak uygun şekilde tekrarlanır veya kısaltılır. Bu yöntemi yalnızca biçimlendirmeyi kopyalar.

ızgaraId parametresinin ayrıntılı açıklaması için getGridId() adresini ziyaret edin.

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

var 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, sayfanın e-tablodaki 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 bitiş satırı.

Yetkilendirme

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

  • 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 kopyalayın. Hedef daha büyük veya küçükse kaynak aralıktan daha fazla ise kaynak uygun şekilde tekrarlanır veya kısaltılır. Bu yöntemi yalnızca biçimlendirmeyi kopyalar.

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

var 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 sayfa.
columnIntegerHedef aralığın ilk sütunu.
columnEndIntegerHedef aralığın bitiş sütunu.
rowIntegerHedef aralığın başlangıç satırı.
rowEndIntegerHedef aralığın bitiş satırı.

Yetkilendirme

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

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

copyTo(destination)

Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar. Hem değerler hem de biçimlendirme kopyalandığından emin olun.

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

Parametreler

AdTürAçıklama
destinationRangeKopyalanacak hedef aralık; hücrenin yalnızca sol üstteki konumu alakalı olmalıdır.

Yetkilendirme

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

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

copyTo(destination, copyPasteType, transposed)

Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar.

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

Parametreler

AdTürAçıklama
destinationRangeKopyalanacak hedef aralık; hücrenin yalnızca sol üstteki konumu alakalı olmalıdır.
copyPasteTypeCopyPasteTypeAralık içeriğinin seçeceğiz.
transposedBooleanAralığın ters çevrilmiş yönde yapıştırılıp yapıştırılmayacağı.

Yetkilendirme

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

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

copyTo(destination, options)

Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar. Varsayılan olarak hem değerler hem de biçimlendirmeler kopyalanır, ancak bu durum 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.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});

Parametreler

AdTürAçıklama
destinationRangeKopyalanacak hedef aralık; hücrenin yalnızca sol üstteki konumu alakalı olmalıdır.
optionsObjectAşağıda listelenen, gelişmiş parametreleri belirten bir JavaScript nesnesi.

Gelişmiş parametreler

AdTürAçıklama
formatOnlyBooleanyalnızca biçimin kopyalanması gerektiğini belirtir
contentsOnlyBooleanyalnızca içeriğin kopyalanması gerektiğini belirtir

Yetkilendirme

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

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

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

Aralığın içeriğini belirtilen konuma kopyalayın. Hedef daha büyük veya küçükse kaynak aralıktan daha fazla ise kaynak uygun şekilde tekrarlanır veya kısaltılır.

ızgaraId parametresinin ayrıntılı açıklaması için getGridId() adresini ziyaret edin.

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

var 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, sayfanın e-tablodaki 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 bitiş satırı.

Yetkilendirme

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

  • 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ığın içeriğini belirtilen konuma kopyalayın. Hedef daha büyük veya küçükse kaynak aralıktan daha fazla ise kaynak uygun şekilde tekrarlanır veya kısaltılır.

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

var 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 sayfa.
columnIntegerHedef aralığın ilk sütunu.
columnEndIntegerHedef aralığın bitiş sütunu.
rowIntegerHedef aralığın başlangıç satırı.
rowEndIntegerHedef aralığın bitiş satırı.

Yetkilendirme

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

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

createDataSourcePivotTable(dataSource)

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

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

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

createDataSourceTable(dataSource)

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

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

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

var dataSourceTable = anchorCell.createDataSourceTable(dataSource);
    .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
    .addSortSpec('dataColumnA', /* ascending= *\/ true)
    .addSortSpec('dataColumnB', /* 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

createDeveloperMetadataFinder()

Bu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinderApi değeri döndürür aralığı. Meta veriler, yalnızca aralık dahilinde olduğu sürece bu aralığın kapsamındadır. aralığı. Örneğin, "3:3" satırıyla ilişkili meta veriler bir aralığın kapsamında değildir "A1:D5" ancak "1:5" aralığı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ındaki meta verileri aramak için kullanılan bir geliştirici meta veri bulucudur.


createFilter()

Bir filtre oluşturur ve bunu sayfada belirtilen aralığa uygular. En fazla tek bir filtre ekler. Filtrenizi oluşturduktan sonra erişmek ve değiştirmek için getFilter() veya Sheet.getFilter() tuşlarını kullanın.

let ss = SpreadsheetApp.getActiveSheet();
let 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() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}
Varsayılan sayfa türü olan Grid sayfa 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

createPivotTable(sourceData)

Belirtilen sourceData sütunundan, ilk hücreye sabitlenmiş boş bir pivot tablo oluşturur bu aralıkta.

// 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

createTextFinder(findText)

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

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

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

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

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var 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, sağlanan boyuta göre mevcut veriler kaydırılır seçilen aralığa doğru ilerler.

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

var range = sheet.getRange("A1:D10");
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Parametreler

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

Yetkilendirme

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

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

expandGroups()

Aralık veya kontrol açma/kapatma düğmesi bu aralıkla kesişen daraltılmış grupları genişletir. İlgili içeriği oluşturmak için kullanılan kontrol açma/kapatma konumu, kontrol açma/kapatma düğmesinin gösterildiği dizindir. Bu işlem, sonra da ekleyebilirsiniz. Aynı konumda birden fazla grup varsa en kapsamlı grup genişletilir.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getA1Notation()

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

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

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

Return

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

Yetkilendirme

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

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

getBackground()

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

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

var cell = sheet.getRange("B5");
Logger.log(cell.getBackground());

Return

String — Arka planın renk kodu.

Yetkilendirme

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

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

getBackgroundObject()

Aralıkta sol üstteki hücrenin arka plan rengini döndürür.

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

var cell = sheet.getRange("B5");
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

Return

Color — Aralıkta sol üstteki hücrenin arka plan rengi.

Yetkilendirme

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

  • 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.

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

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

Return

Color[][] — İki boyutlu bir arka plan renkleri dizisi.

Yetkilendirme

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

  • 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').

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

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

Return

String[][] — Arka planların iki boyutlu renk kodları dizisi.

Yetkilendirme

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

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

getBandings()

Bu aralıktaki hücrelere uygulanan tüm şeritleri 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 (let banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Return

Banding[] — Bu aralıktaki tüm hücrelere uygulanan tüm şeritler.

Yetkilendirme

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

  • 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.

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

var 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
var cell = range.getCell(1, 1);
Logger.log(cell.getValue());

Parametreler

AdTürAçıklama
rowIntegerAralığa göre hücre satırı.
columnIntegerAralığa göre hücrenin sütunu.

Return

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

Yetkilendirme

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

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

getColumn()

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

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getDataRegion()

Dört kardinal Direction içinde genişletilen aralığın, tümünü kapsayacak şekilde bir kopyasını döndürür veri bulunan bitişik hücreler. Aralık, aşağıdakileri içermeyen boş hücrelerle çevriliyse üzere aralığın kendisi döndürülür. Bu, aralığı seçmeye benzer ve Düzenleyicide Ctrl+A yazıyor.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getDataRegion(dimension)

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

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var 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 her bir sütunu ya da orijinal aralık.

Yetkilendirme

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

  • 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 aralıktaki ilk hücre için null değerini döndürür hücre, veri kaynağı formülü içermiyor.

// 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ücre için DataSourceFormula.

Yetkilendirme

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

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

getDataSourceFormulas()

Aralıktaki hücreler için DataSourceFormula değerlerini 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getDataSourceUrl()

Bu aralıktaki veriler için, grafik ve sorgu oluşturmak amacıyla kullanılabilecek bir URL döndürür.

Code.gs

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

  var 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 — Grafik gibi başka API'lere aktarılabilecek bir veri kaynağı olarak bu aralığın URL'si.

Yetkilendirme

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

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

getDataTable()

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

// 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 — veri tablosu olarak veriler.


getDataTable(firstRowIsHeader)

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

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

// Calling this method with "true" sets the first line to be the title of the axes
var 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.
var chart = Charts.newBarChart()
    .setDataTable(datatable)
    .setOption("title", "Your Title Here")
    .build();

Parametreler

AdTürAçıklama
firstRowIsHeaderBooleanİlk satırın başlık olarak ele alınıp alınmayacağını belirtir.

Return

DataTable — Veri tablosu olarak veriler.

Yetkilendirme

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

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

getDataValidation()

Aralıkta sol üstteki hücre için veri doğrulama kuralını döndürür. Veri doğrulama değerine ayarlanırsa bu yöntem null değerini döndürür.

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

Return

DataValidation — Aralıkta sol üstteki hücre için veri doğrulama kuralı.

Yetkilendirme

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

  • 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. Veri doğrulama belirli bir hücrede ayarlanmışsa bu yöntem, hücrenin dizideki konumu için null değerini döndürür.

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Return

DataValidation[][] — Şuradaki hücrelerle ilişkili veri doğrulama kurallarından oluşan iki boyutlu bir dizi: aralığı.

Yetkilendirme

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

  • 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getDisplayValue()

Aralıkta sol üstte bulunan hücrenin görüntülenen değerini döndürür. Değer String. Görüntülenen değer, aşağıdakiler de dahil olmak üzere tarih, saat ve para birimi biçimlendirme biçimleri, e-tablonun yerel ayarı tarafından otomatik olarak uygulanır. Boş hücreler, boş değer döndürür dize.

// 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ğer.

Yetkilendirme

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

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

getDisplayValues()

Bu aralığın değerlerin dikdörtgen tablosunu döndürür.

Satıra ve ardından sütuna göre dizine eklenen, görüntülenen değerlerin iki boyutlu bir dizisini döndürür. İlgili içeriği oluşturmak için kullanılan değerler String nesnedir. Görüntülenen değer, e-tablonun yerel ayarına göre otomatik olarak uygulanan biçimler dahil olmak üzere para birimi biçimlendirme ayarını değiştirebilirsiniz. Boş hücreler, dizideki boş bir dizeyle temsil edilir. Bir görevin aralık dizini 1, 1 itibarıyla başlıyor, JavaScript dizisi [0][0] adresinden dizine eklendi.

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getFilter()

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

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

Return

Filter — Filtre.

Yetkilendirme

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

  • 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.

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

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

Return

Color: Aralıkta sol üstteki hücrenin yazı tipi rengi.

Yetkilendirme

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

  • 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.

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

var results = range.getFontColorObjects();

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

Return

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

Yetkilendirme

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

  • 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.

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

var results = range.getFontFamilies();

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

Return

String[][] — Aralıktaki hücrelerle ilişkili yazı tipi ailelerinin iki boyutlu dizisi.

Yetkilendirme

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

  • 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.

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

Logger.log(range.getFontFamily());

Return

String — Hücrenin yazı tipi ailesi.

Yetkilendirme

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

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

getFontLine()

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

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

Logger.log(range.getFontLine());

Return

String: Yazı tipi satırı.

Yetkilendirme

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

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

getFontLines()

Aralıktaki ('underline', 'line-through' veya 'none').

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

var results = range.getFontLines();

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

Return

String[][] — Aralıktaki hücrelerle ilişkili yazı tipi çizgilerinin iki boyutlu bir dizisi.

Yetkilendirme

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

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

getFontSize()

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

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

Logger.log(range.getFontSize());

Return

Integer: Nokta boyutundaki yazı tipi boyutu.

Yetkilendirme

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

  • 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.

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

var results = range.getFontSizes();

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

Return

Integer[][] — Aralıktaki hücrelerle ilişkili metnin yazı tipi boyutlarının iki boyutlu dizisi.

Yetkilendirme

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

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

getFontStyle()

Sol üstteki hücrenin yazı tipi stilini ('italic' veya 'normal') döndürür köşesine eklenir.

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

Logger.log(range.getFontStyle());

Return

String — Hücredeki metnin yazı tipi stili.

Yetkilendirme

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

  • 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.

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

var results = range.getFontStyles();

for (var i in results) {
  for (var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getFontWeight()

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

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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.

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

var results = range.getFontWeights();

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

Return

String[][] — Aralıktaki hücrelerle ilişkili metnin yazı tipi ağırlıklarının iki boyutlu bir dizisi.

Yetkilendirme

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

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

getFormula()

Aralığın sol üst hücresine ilişkin formülü (A1 gösterimini) veya hücre boş veya formül içermiyor.

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

// This assumes you have a function in B5 that sums up
// B2:B4
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getFormulaR1C1()

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

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

var range = sheet.getRange("B5");
var formula = range.getFormulaR1C1();
Logger.log(formula);

Return

String: R1C1 gösterimindeki formül.

Yetkilendirme

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

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

getFormulas()

Aralıktaki hücrelere ait formülleri (A1 gösterimi) döndürür. 2D dizideki girişler, formül içermeyen hücreler için boş dizeler oluşturun.

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

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

Return

String[][] — Dize biçimindeki iki boyutlu bir formül dizisi.

Yetkilendirme

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

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

getFormulasR1C1()

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

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

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

Return

String[][] — R1C1 gösteriminde iki boyutlu bir formül dizisi.

Yetkilendirme

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

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

getGridId()

Aralığın üst sayfasının ızgara kimliğini döndürür. Kimlikler, negatif olmayan rastgele tam sayı değerleridir.

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

Logger.log(range.getGridId());

Return

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

Yetkilendirme

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

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

getHeight()

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

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

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

Return

Integer: Aralığın yüksekliği.

Yetkilendirme

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

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

getHorizontalAlignment()

Hücrenin sol üstteki metninin yatay hizalamasını (sola/orta/sağ) döndürür köşesine eklenir.

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

Logger.log(range.getHorizontalAlignment());

Return

String — Hücredeki metnin yatay hizalaması.

Yetkilendirme

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

  • 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.

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

var results = range.getHorizontalAlignments();

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

Return

String[][] — Şuradaki hücrelerle ilişkili metinlerin iki boyutlu yatay hizalama dizisi: aralığı.

Yetkilendirme

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

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

getLastColumn()

Bitiş sütunu konumunu döndürür.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getLastRow()

Bitiş satırı konumunu döndürür.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getMergedRanges()

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

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

var range = sheet.getRange("A1:B3");

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

Return

Range[] — Aralıkla çakışan birleştirilmiş hücreleri temsil eden Range nesneden oluşan bir dizi.


getNextDataCell(direction)

Aralığın ilk sütunundaki ve satırındaki hücreden başlayarak, veri içeren bitişik bir hücre aralığının kenarı olan yön kenarını, e-tablonun kenarına, Düzenleyicide Ctrl+[arrow key] yazmakla aynı etkiye sahiptir.

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

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

Parametreler

AdTürAçıklama
directionDirectionBir sonraki 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getNote()

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

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

Logger.log(range.getNote());

Return

String — Belirtilen hücreyle ilişkili not.

Yetkilendirme

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

  • 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.

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

var results = range.getNotes();

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

Return

String[][] — Aralıktaki hücrelerle ilişkili notların iki boyutlu bir dizisi.

Yetkilendirme

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

  • 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.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getNumberFormat()

Verilen aralığın sol üst tarafındaki hücrenin sayısını veya tarih biçimlendirmesini alın. Döndürülen biçim ilgili talimatları E-Tablolar API'sinde bulabilirsiniz. dokümanlarına göz atın.

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

var cell = sheet.getRange("C4");
Logger.log(cell.getNumberFormat());

Return

String: Aralığın sol üst tarafındaki hücrenin sayı biçimi.

Yetkilendirme

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

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

getNumberFormats()

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

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

var range = sheet.getRange("B5:C6");
var formats = range.getNumberFormats();
for (var i in formats) {
  for (var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getRichTextValue()

Aralığın sol üst hücresi için Zengin Metin değerini veya hücreyse null değerini döndürür değer metin değil.

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

Return

RichTextValue — Aralıkta sol üstteki hücrenin Zengin Metin değeri veya hücreyse null değer metin değil.

Yetkilendirme

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

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

getRichTextValues()

Aralıktaki hücreler için Zengin Metin değerlerini döndürür.

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

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

Return

RichTextValue[][]: İki boyutlu bir Zengin Metin değerleri dizisi.

Yetkilendirme

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

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

getRow()

Bu aralık için satır konumunu döndürür. getRowIndex() ile aynıdır.

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

var range = sheet.getRange("B2");
Logger.log(range.getRow());

Return

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

Yetkilendirme

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

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

getRowIndex()

Bu aralık için satır konumunu döndürür. getRow() ile aynıdır.

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

var range = sheet.getRange("B2");
Logger.log(range.getRowIndex());

Return

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

Yetkilendirme

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

  • 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getTextDirection()

Aralığın sol üst hücresinin metin yönünü döndürür. Hücre, null değerini döndürür metnin yönü otomatik algılama ile belirlenir.

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

Return

TextDirection — Aralıkta bulunan sol üstteki hücrenin metin yönü.

Yetkilendirme

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

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

getTextDirections()

Aralıktaki hücrelerin metin yönlerini döndürür. Otomatik algılama kullanan hücreler için 2D dizideki girişler null.

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

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

Return

TextDirection[][] — İki boyutlu bir metin yönü dizisi.

Yetkilendirme

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

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

getTextRotation()

Aralığın sol üst hücresi için metin döndürme ayarlarını döndürür.

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

var cell = sheet.getRange("A1");
Logger.log(cell.getTextRotation());

Return

TextRotation: Metin döndürme ayarları.

Yetkilendirme

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

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

getTextRotations()

Aralıktaki hücreler için metin döndürme ayarlarını döndürür.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

var results = range.getTextRotations();

for (var i in results) {
  for (var j in results[i]) {
    var 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 metin döndürme dizisi.

Yetkilendirme

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

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

getTextStyle()

Aralığın sol üst hücresinin metin stilini döndürür.

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

Return

TextStyle — Aralıkta sol üstteki hücrenin metin stili.

Yetkilendirme

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

  • 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
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var styles = range.getTextStyles();

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

Return

TextStyle[][] — İki boyutlu bir metin stilleri dizisi.

Yetkilendirme

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

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

getValue()

Aralıkta sol üstte bulunan hücrenin değerini döndürür. Değer Number türünde olabilir Hücrenin değerine bağlı olarak Boolean, Date veya String. Boş hücreler boş 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ğer.

Yetkilendirme

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

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

getValues()

Bu aralığın değerlerin dikdörtgen tablosunu döndürür.

Satır ve ardından sütuna göre dizine eklenmiş iki boyutlu bir değer dizisi döndürür. Değerler şunlar olabilir: bağlı olarak Number, Boolean, Date veya String türünde hücrenin değerini girin. Boş hücreler, dizideki boş bir dizeyle temsil edilir. Bunu unutmayın bir aralık dizini 1, 1 değerinden başlarken JavaScript dizisi, [0][0] adresinden dizine eklenir.

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

Return

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

Yetkilendirme

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

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

getVerticalAlignment()

Hücrenin sol üst köşesinde dikey hizalamasını (üst/orta/alt) döndürür aralığı.

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

Logger.log(range.getVerticalAlignment());

Return

String — Hücredeki metnin dikey hizalaması.

Yetkilendirme

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

  • 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.

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

var results = range.getVerticalAlignments();

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

Return

String[][] — Şuradaki hücrelerle ilişkili metinlerin iki boyutlu dikey hizalama dizisi: aralığı.

Yetkilendirme

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

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

getWidth()

Sütunlardaki aralığın 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getWrap()

Hücredeki metnin kaydırılıp kaydırılmayacağını döndürür. Daha ayrıntılı sarmalama stratejisi için getWrapStrategy() değerini kullanın.

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

Logger.log(range.getWrap());

Return

Boolean — Bu hücredeki metnin kaydırılıp kaydırılmadığı.

Yetkilendirme

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

  • 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
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var strategies = range.getWrapStrategies();

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

Return

WrapStrategy[][] — İki boyutlu bir metin kaydırma stratejileri dizisi.

Yetkilendirme

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

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

getWrapStrategy()

Aralığın sol üst hücresinin metin kaydırma stratejisini döndürür.

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

Return

WrapStrategy — Aralıkta sol üstteki hücrenin metin kaydırma stratejisi.

Yetkilendirme

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

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

getWraps()

Hücrelerdeki metnin kaydırılıp kaydırılmadığını döndürür. Daha ayrıntılı sarmalama stratejisi için getWrapStrategies() değerini kullanın.

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

var results = range.getVerticalAlignments();

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

Return

Boolean[][] — Şuradaki hücrelerle ilişkili metinlerin iki boyutlu dikey hizalama dizisi: aralığı.

Yetkilendirme

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

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

insertCells(shiftDimension)

Bu aralığa boş hücreler ekler. Yeni hücreler, hücrelerdeki tüm biçimlendirmeleri korur işliyor. Sayfada sağlanan boyuta sahip mevcut veriler eklenen aralıktan uzaklaştırıldı.

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

var range = sheet.getRange("A1:D10");
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Parametreler

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

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

insertCheckboxes()

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

insertCheckboxes(checkedValue)

Aralıktaki her bir hücreye onay kutuları ekler. Bu alanlar, işaretlenmiş ve işaretlenmiş olanlar için özel bir değerle yapılandırılır. boş dizeyi işaretlemeyin. Aralıktaki her hücrenin değerini boş dizeye ayarlar.

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

insertCheckboxes(checkedValue, uncheckedValue)

Aralıktaki her bir hücreye onay kutuları ekler, işaretli olanlar için özel değerlerle yapılandırılır kontrol edebilirsiniz. Aralıktaki her hücrenin değerini, özel işaretlenmemiş değere ayarlar.

var 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şaretlenmemiş değer.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

isBlank()

Aralık tamamen boşsa true değerini döndürür.

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

Logger.log(range.isBlank());

Return

Boolean — Aralık boşsa true; Aksi takdirde false.

Yetkilendirme

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

  • 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şaretlenmişse ve geri kalanlar işaretlenmemişse veya bazı hücrelerde onay kutusu yoksa null döndürür. veri doğrulama.

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

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

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

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

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

Return

Booleantrue, aralıktaki tüm hücreler işaretliyse, false aralığın işareti kaldırılır; hücrelerden herhangi birinin işareti kaldırıldıysa veya hücrelerden herhangi birinin işareti kaldırıldıysa null onay kutusu veri doğrulaması.

Yetkilendirme

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

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

isEndColumnBounded()

Aralık sonunun belirli bir sütuna bağlı olup olmadığını belirler. Örneğin, Bu, aralığın sonundaki sütunlara bağlı A1:B10 veya B:B aralıkları için yöntem true değerini döndürür; yalnızca bağlı olan 3:7 veya A1:5 aralıkları için aralığı sonundaki belirli satırlara eklemekte, 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 end of the range is bound to a particular column and logs it to the
// console.
console.log(range.isEndColumnBounded());

Return

Aralığın sonu belirli bir sütuna bağlıysa Booleantrue; false aksi takdirde.

Yetkilendirme

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

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

isEndRowBounded()

Aralık sonunun belirli bir satıra bağlı olup olmadığını belirler. Örneğin, Bu, aralığın sonundaki satırlara bağlı A1:B10 veya 3:7 aralıkları için yöntem true değerini döndürür; yalnızca bağlı olan B:B veya A1:C aralıkları için söz konusu olduğunda, 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 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; false aksi takdirde.

Yetkilendirme

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

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

isPartOfMerge()

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

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

var range = sheet.getRange("A1:B3");

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

Return

Boolean — Aralık, birleştirilmiş hücrelerle çakışıyorsa true, aksi takdirde false değerini döndürür.


isStartColumnBounded()

Aralık 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ı, bu yöntem true değerini döndürür; yalnızca şu adresteki bir satıra bağlı olan 3:7 aralığı için: aralığın başlangıcında, 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; false aksi takdirde.

Yetkilendirme

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

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

isStartRowBounded()

Aralık başlangıcının belirli bir satıra bağlı olup olmadığını belirler. Örneğin, aralığın başlangıcındaki satırlara bağlı olan A1:B10 veya 3:7 aralıkları, bu yöntem true değerini döndürür; yalnızca belirli bir değere bağlı olan B:B aralığı için sütununda yer alırsa 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; false aksi takdirde.

Yetkilendirme

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

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

merge()

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

mergeAcross()

Aralıktaki hücreleri, aralıktaki sütunlarda birleştirin.

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

// The code below merges cells C5:E5 into one cell
var range1 = sheet.getRange("C5:E5");
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
var range2 = sheet.getRange("F5:H6");
range2.mergeAcross();

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

mergeVertically()

Aralıktaki hücreleri birleştirir.

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

moveTo(target)

Bu aralıktan kesip (hem biçim hem de değerler) hedef aralığa yapıştırın.

// The code below moves the first 5 columns over to the 6th column
var sheet = SpreadsheetApp.getActiveSheet()
sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));

Parametreler

AdTürAçıklama
targetRangeBu aralığın kopyalanacağı hedef aralık; hücrenin yalnızca sol üstteki konumu emin olun.

Yetkilendirme

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

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

offset(rowOffset, columnOffset)

Belirtilen satır ve sütun sayısına göre bu aralıktan uzaklaştırılan yeni bir aralık döndürür (negatif olabilir). Yeni aralık, orijinal aralıkla aynı boyuttadır.

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

var cell = sheet.getRange("A1");

// newCell references B2
var 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ıya doğru satırları temsil eder.
columnOffsetIntegerAralığın sol üst tarafındaki hücrenin sağındaki sütun 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)

Sol üst noktası uzaklık verilen geçerli aralığa göre yeni bir aralık döndürür belirtilen satır ve sütunlara göre ve hücrelerde belirtilen yükseklikle geçerli aralıktan değiştirebilirsiniz.

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

var cell = sheet.getRange("A1");

// newCell references B2:B3
var 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ıya doğru satırları temsil eder.
columnOffsetIntegerAralığın sol üst tarafındaki hücrenin sağındaki sütun sayısı; negatif değerler aralığın sol üst hücresinden soldaki sütunları temsil eder.
numRowsIntegerYeni aralıktaki satırların yüksekliği.

Return

Range: Zincirleme için bu aralık.


offset(rowOffset, columnOffset, numRows, numColumns)

Sol üst noktası uzaklık verilen geçerli aralığa göre yeni bir aralık döndürür geçerli aralıktan verilen satır ve sütunlara göre ve belirtilen yükseklik ve genişlikte hücreler.

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

var cell = sheet.getRange("A1");

// newCell references B2:C3
var 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ıya doğru satırları temsil eder.
columnOffsetIntegerAralığın sol üst tarafındaki hücrenin sağındaki sütun sayısı; negatif değerler aralığın sol üst hücresinden soldaki sütunları temsil eder.
numRowsIntegerYeni aralıktaki satırların yüksekliği.
numColumnsIntegerYeni aralığın sütunlarındaki genişlik.

Return

Range: Zincirleme için bu aralık.


protect()

Aralığa erişimi olan kullanıcılar dışında, aralığın düzenlenmesine karşı korunabilecek bir nesne oluşturur. izni gerekir. Komut dosyası, aralık için düzenleyenler listesini gerçekten değiştirene kadar ( Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) veya yeni bir Protection.setDomainEdit(editable) değeri için geçerliyse bu izinler, (bu, aralığın korunmaz kaldığı anlamına gelir). Aralık zaten korunuyorsa bu yöntem, mevcut aralıkla çakışan yeni bir korunan aralık oluşturur. Eğer Bir hücre birden çok korumalı aralıkla korunur ve bunların herhangi biri, belirli bir kullanıcının hücre düzenlendiğinde, bu kullanıcının hücreyi düzenlemesine izin verilmez.

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var 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.
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

randomize()

Verilen aralıktaki satırların sırasını rastgele hale getirir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 bir hücrenin veri doğrulamasını temizler ve ayrıca, hücre işaretli veya işaretlenmemiş değeri içeriyorsa değerini de temizler.

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

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

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

removeDuplicates()

Bu aralık içinde bulunan ve herhangi bir önceki satırda yer alır. Aynı değerlere, ancak farklı büyük/küçük harflere, biçimlendirmelere veya formüllere sahip satırlar yinelenme olarak değerlendirilir. Bu yöntem ayrıca görünümden gizlenen yinelenen satırları da kaldırır ( bir filtre nedeniyle görüntülenebilir). Bu aralığın dışındaki içerikler kaldırılmaz.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var 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. Aralığın boyutu şu şekilde azalır: satırı kaldırılır.

Yetkilendirme

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

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

removeDuplicates(columnsToCompare)

Bu aralık içinde bulunan ve belirtilen sütunlarda yinelenen değerler içeren satırları kaldırır önceki herhangi bir satırda değer olarak görünür. Aynı değerlere sahip ancak büyük/küçük harf kullanımı, biçimlendirmesi ve kabul edilir. Bu yöntem, gizlenen yinelenen satırları da kaldırır görünür (örneğin, bir filtre nedeniyle). Bu aralığın dışındaki içerikler kaldırılmaz.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var 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 olup olmadığını görmek için analiz edilecek sütunlar. Sütun sağlanmazsa tüm sütunlar yinelemeler için analiz edilir.

Return

Range: Yinelenenler kaldırıldıktan sonra elde edilen aralık. Aralığın boyutu şu şekilde azalır: satırı kaldırılır.

Yetkilendirme

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

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

setBackground(color)

CSS gösteriminde ('#ffffff' gibi) aralıktaki tüm hücrelerin arka plan rengini ayarlar veya 'white').

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

var range = sheet.getRange("B2:D5");
range.setBackground("red");

Parametreler

AdTürAçıklama
colorStringCSS gösteriminde bir renk kodu ('#ffffff' veya 'white' gibi); CANNOT TRANSLATE null değeri, rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var bgColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setBackgroundObjects(color)

Arka plan renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir).

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

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

Parametreler

AdTürAçıklama
colorColor[][]İki boyutlu renk dizisi; null değerleri, rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setBackgroundRGB(red, green, blue)

RGB değerlerini (0 ile 255 arasındaki tam sayılar dahil) kullanarak arka planı belirtilen renge ayarlar.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setBackgrounds(color)

Arka plan renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Renkler CSS gösteriminde ('#ffffff' veya 'white' gibi).

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

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

Parametreler

AdTürAçıklama
colorString[][]CSS gösteriminde iki boyutlu bir renk dizisi ('#ffffff' veya 'white'); null değerleri, rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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.

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

var 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.
verticalBooleanİç dikey kenarlıklar için true, hiçbiri için false, değişiklik yok için null.
horizontalBooleanİç 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 stille ayarlar. Geçerli değerler true (açık), false (kapalı) ve null (değişiklik yok) şeklindedir. Renk için CSS gösteriminde Renk seçeneğini ('#ffffff' veya 'white' gibi) kullanın.

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

var 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.
verticalBooleanİç dikey kenarlıklar için true, hiçbiri için false, değişiklik yok için null.
horizontalBooleanİç yatay kenarlıklar için true, hiçbiri için false, değişiklik yok için null.
colorStringCSS gösteriminde bir renk ('#ffffff' veya 'white' gibi), varsayılan renk için null (siyah).
styleBorderStyleKenarlıklar için bir stil, varsayılan stil (sabit) için null.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setDataValidation(rule)

Aralıktaki tüm hücreler için tek bir veri doğrulama kuralı ayarlar.

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
ruleDataValidationAyarlanacak veri doğrulama kuralı veya veri doğrulamasını kaldırmak için null.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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 iki boyutlu bir satıra ve ardından sütuna göre dizine eklenen veri doğrulama dizisidir. Dizi boyutları; eşlemeyi seçin.

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var 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 kuralları dizisi null değerleri veri doğrulamasını kaldırın.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFontColor(color)

CSS gösteriminde yazı tipi rengini ayarlar ('#ffffff' veya 'white' gibi).

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

var cell = sheet.getRange("B2");
cell.setFontColor("red");

Parametreler

AdTürAçıklama
colorStringCSS gösterimindeki yazı tipi rengi (ör. '#ffffff' veya 'white'); CANNOT TRANSLATE null değeri, rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFontColorObject(color)

Verilen aralığın yazı tipi rengini ayarlar.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setFontColorObjects(colors)

Yazı tipi renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir).

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

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

Parametreler

AdTürAçıklama
colorsColor[][]İki boyutlu renk dizisi; null değerleri, yazı tipi rengini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFontColors(colors)

Yazı tipi renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Renkler mevcut CSS gösterimi ('#ffffff' veya 'white' gibi).

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

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

Parametreler

AdTürAçıklama
colorsObject[][]CSS gösteriminde iki boyutlu bir renk dizisi ('#ffffff' veya 'white'); null değerleri, rengi sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFontFamilies(fontFamilies)

Yazı tipi ailelerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Örnekler yazı tipi aileleri "SFTP" şeklindedir veya "Helvetica".

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

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

Parametreler

AdTürAçıklama
fontFamiliesObject[][]Yazı tipi ailelerinin iki boyutlu dizisi null değerleri, yazı tipi ailesini seçin.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFontFamily(fontFamily)

Yazı tipi ailesini belirler (ör. "SFTP") veya "Helvetica".

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setFontLine(fontLine)

Belirtilen aralığın ('underline', 'line-through' veya 'none').

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

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

Parametreler

AdTürAçıklama
fontLineStringYazı tipi çizgi stili, 'underline', 'line-through' veya 'none'; null değeri, yazı tipi çizgi stilini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFontLines(fontLines)

Çizgi stillerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).

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

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

Parametreler

AdTürAçıklama
fontLinesObject[][]Yazı tipi çizgi stillerinin iki boyutlu dizisi ('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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setFontSize(size)

Yazı tipi boyutunu ayarlar. Boyut, kullanılacak nokta boyutudur.

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

var cell = sheet.getRange("B2");
cell.setFontSize(20);

Parametreler

AdTürAçıklama
sizeIntegerNokta boyutunda yazı tipi boyutu.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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: puan.

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

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

Parametreler

AdTürAçıklama
sizesObject[][]İki boyutlu boyut dizisi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFontStyle(fontStyle)

Verilen aralığın ('italic' veya 'normal') yazı tipi stilini ayarlayın.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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).

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

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

Parametreler

AdTürAçıklama
fontStylesObject[][]İki boyutlu bir yazı tipi stilleri dizisi ('italic' veya 'normal'); null değerleri, yazı tipi stilini sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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.

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

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

Parametreler

AdTürAçıklama
fontWeightStringYazı tipi ağırlığı ('bold' veya 'normal'); null değeri yazı tipi ağırlığını sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFontWeights(fontWeights)

Yazı tipi ağırlıklarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Örnek olarak yazı tipi genişliği "kalın" olmalıdır.

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

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

Parametreler

AdTürAçıklama
fontWeightsObject[][]İki boyutlu bir yazı tipi ağırlıkları dizisi ('bold' veya 'normal'); null değerleri, yazı tipi ağırlığını sıfırladı.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFormula(formula)

Bu aralığa ilişkin formülü günceller. Verilen formül A1 gösteriminde olmalıdır.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setFormulaR1C1(formula)

Bu aralığa ilişkin formülü günceller. Verilen formül R1C1 gösteriminde olmalıdır.

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

var 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
formulaStringDize formülü.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFormulas(formulas)

Dikdörtgen formül ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Verilen formüller A1 gösteriminde olmalıdır. Bu yöntemde satıra göre dizine eklenen iki boyutlu bir formül dizisi kullanılır. sütuna göre. Dizi boyutları, aralık boyutlarına karşılık gelmelidir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var 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.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

Parametreler

AdTürAçıklama
formulasString[][]İki boyutlu bir formül dizisi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setFormulasR1C1(formulas)

Dikdörtgen formül ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Verilen formüller R1C1 gösteriminde olmalıdır.

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

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setHorizontalAlignment(alignment)

Verilen aralık (sol/orta/sağ) için yatay (soldan sağa) hizalamayı ayarlayın.

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

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

Parametreler

AdTürAçıklama
alignmentStringHizalama ('left', 'center' veya 'normal'; CANNOT TRANSLATE null değeri hizalamayı sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setHorizontalAlignments(alignments)

Yatay hizalamalardan oluşan dikdörtgen bir ızgara ayarlar. bkz. setHorizontalAlignment(alignment)

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

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

Parametreler

AdTürAçıklama
alignmentsObject[][]İki boyutlu bir hizalama dizisi ('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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

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


setNote(note)

Notu verilen değere ayarlar.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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).

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

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

Parametreler

AdTürAçıklama
notesObject[][]İki boyutlu not dizisi; null değerleri notu kaldırır.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

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


setNumberFormat(numberFormat)

Sayıyı veya tarih biçimini, verilen biçimlendirme dizesine ayarlar. Kabul edilen biçim kalıpları E-Tablolar API dokümanlarında açıklanmıştır.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 tablo ayarlar (bu aralığın boyutlarıyla eşleşmelidir). İlgili içeriği oluşturmak için kullanılan değerleri, E-Tablolar API dokümanları.

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

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

Parametreler

AdTürAçıklama
valueRichTextValueİstenen Zengin Metin değeri.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setRichTextValues(values)

Zengin Metin değerlerinin dikdörtgen ızgarasını ayarlar.

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var 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[][]İstenen Zengin Metin değerleri.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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ğini belirler.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setTextDirection(direction)

Aralıktaki hücrelerin metin yönünü ayarlar. Belirtilen yön null ise emin olun.

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var 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ün önceki ayarını değiştirebilirsiniz.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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 emin olun.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

Parametreler

AdTürAçıklama
directionsTextDirection[][]İstenen metin yönleri; belirtilen yön null ise tahmin edilir.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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ş açıya karşılık gelir yatay olarak ayarlayın. Sıfır girişi, metnin standart yöne ayarlandığından emin olun.

Soldan sağa metin yönü için pozitif açılar saat yönünün tersine, sağdan sola doğru ise saat yönündedir.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

Parametreler

AdTürAçıklama
degreesIntegerStandart yön ve istenen yön arasında istenen açı. Soldan sağa metinde 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

Parametreler

AdTürAçıklama
rotationTextRotationİstenen metin döndürme ayarları.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setTextRotations(rotations)

Metin döndürmeleri için dikdörtgen bir tablo ayarlar.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

Parametreler

AdTürAçıklama
rotationsTextRotation[][]İstenen metin döndürme ayarları.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

Parametreler

AdTürAçıklama
styleTextStyleİstenen metin stili.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setTextStyles(styles)

Metin stillerinden oluşan dikdörtgen bir ızgara ayarlar.

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setValue(value)

Aralığın değerini ayarlar. Değer; sayısal, dize, boole veya tarih olabilir. Başlıyorsa '=' ise formül olarak yorumlanır.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 = ise bir formül olarak yorumlanır.

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

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setVerticalAlignment(alignment)

Verilen aralık (üst/orta/alt) için dikey (üstten alta) hizalamayı ayarlayın.

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

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

Parametreler

AdTürAçıklama
alignmentStringHizalama ('top', 'middle' veya 'bottom'; CANNOT TRANSLATE null değeri hizalamayı sıfırlar.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setVerticalAlignments(alignments)

Dikey hizalamaları içeren dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).

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

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

Parametreler

AdTürAçıklama
alignmentsObject[][]İki boyutlu bir hizalama dizisi: '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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ücreler için metnin yığın halinde yığılıp yığılmayacağını ayarlar. Metin yığılmışsa dikey olarak metin döndürme derecesi ayarı yok sayılır.

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

Parametreler

AdTürAçıklama
isVerticalBooleanMetnin gruplanıp gruplanmayacağı.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setWrap(isWrapEnabled)

Verilen aralığın hücre sarmalamayı ayarlayın.

Sarmalama etkin olan (varsayılan) hücreler, tüm içerikleri göstermek için yeniden boyutlandırılır. Sarmalama olan hücreler yeniden boyutlandırmadan veya birden fazla satıra çalıştırmadan hücrede mümkün olduğunca çok görüntüleme devre dışı bırakılır.

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

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setWrapStrategies(strategies)

Sarma stratejilerinden oluşan bir dikdörtgen ızgara ayarlar.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

Parametreler

AdTürAçıklama
strategiesWrapStrategy[][]İstenen sarmalama stratejileri.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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 ayarlar.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parametreler

AdTürAçıklama
strategyWrapStrategyİstenen sarmalama stratejisi.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

setWraps(isWrapEnabled)

Kelime kaydırma politikalarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Şu hücrenin olduğu hücreler: kaydırma etkin (varsayılan) tüm içeriğini göstermek için yeniden boyutlandırma. Sarmalama devre dışı olan hücreler yeniden boyutlandırmadan veya birden fazla satıra çalıştırmadan hücrede mümkün olduğunca çok görüntülemesini sağlar.

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

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

Parametreler

AdTürAçıklama
isWrapEnabledObject[][]Sarmalanıp sarmalanmayacağını belirleyen iki boyutlu sarmalama değişkenleri olup olmadığını kontrol edin.

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

  • 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 gruplama derinliğini belirtilen tutara göre değiştirir.

Bu, aralığı. Pozitif deltalar için gruplar oluşturulur ve/veya değiştirilir; negatif deltalar için gruplar Değiştirilmiş ve/veya Kaldırılmış olmasıdır.

Grup derinliği sıfırın altına veya sekizin üzerine düşürüldüğünde bu durumun herhangi bir etkisi olmaz.

column group control position BEFORE, kaydırmaya çalışıldığında hata veriyor derinliğini artırabilirsiniz.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var 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.

Fırlatma

Error — kontrol konumu: GroupControlTogglePosition.BEFORE

Yetkilendirme

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

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

shiftRowGroupDepth(delta)

Aralığın satır gruplama derinliğini belirtilen tutara göre değiştirir.

Bu, aralığı. Pozitif deltalar için gruplar oluşturulur ve/veya değiştirilir; negatif deltalar için gruplar Değiştirilmiş ve/veya Kaldırılmış olmasıdır.

Grup derinliği sıfırın altına veya sekizin üzerine düşürüldüğünde bu durumun herhangi bir etkisi olmaz.

row group control position değeri BEFORE ise derinliğini öğrenebilirsiniz.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var 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.

Fırlatma

Error — Kontrol düğmesi etkinken ilk satırın derinliğini değiştirmeye çalışırken konum GroupControlTogglePosition.BEFORE

Yetkilendirme

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

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

sort(sortSpecObj)

Verilen aralıktaki hücreleri, belirtilen sütun ve düzene göre sıralar.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

splitTextToColumns()

Bir metin sütununu, otomatik olarak algılanan sınırlayıcıya göre birden fazla 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|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

splitTextToColumns(delimiter)

Belirtilen dizeyi özel sınırlayıcı olarak kullanarak bir metin sütununu birden fazla 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|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametreler

AdTürAçıklama
delimiterStringBölme için kullanılacak özel sınırlayıcı.

Yetkilendirme

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

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

splitTextToColumns(delimiter)

Bir metin sütununu, belirtilen sınırlayıcıya göre birden fazla 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|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting 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 önceden ayarlanmış sınırlayıcı.

Yetkilendirme

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

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

trimWhitespace()

Bu aralıktaki her hücredeki boşlukları (ör. boşluklar, sekmeler veya yeni satırlar) kırpar. Kaldırılanlar her hücrenin metninin başındaki ve sonundaki tüm boşlukları ve kalan boşluk karakterlerini tek bir alana ekleyin.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

uncheck()

Aralıktaki onay kutularının durumunu "işareti kaldırıldı" olarak değiştirir. Aralıktaki hücreleri yoksayar Bu segmentler, şu anda yapılandırılmış veya işaretli olmayan değerleri içermiyor.

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

Return

Range: Zincirleme için bu aralık.

Yetkilendirme

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

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

Desteği sonlandırılan yöntemler