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öntem | Dönüş türü | Kısa açıklama |
---|---|---|
activate() | Range | Belirtilen aralığı active range olarak ayarlar ve üst
current cell olarak aralıktaki sol hücreyi seçin. |
activateAsCurrentCell() | Range | Belirtilen hücreyi current cell olarak ayarlar. |
addDeveloperMetadata(key) | Range | Belirtilen anahtara sahip geliştirici meta verilerini aralığa ekler. |
addDeveloperMetadata(key, visibility) | Range | Belirtilen anahtara ve görünürlüğe sahip geliştirici meta verilerini aralığa ekler. |
addDeveloperMetadata(key, value) | Range | Belirtilen anahtar ve değere sahip geliştirici meta verilerini aralığa ekler. |
addDeveloperMetadata(key, value, visibility) | Range | Belirtilen anahtar, değer ve görünürlüğe sahip geliştirici meta verilerini aralığa ekler. |
applyColumnBanding() | Banding | Aralığa varsayılan bir sütun şeridi oluşturma teması uygular. |
applyColumnBanding(bandingTheme) | Banding | Aralığa belirli bir sütun şerit oluşturma teması uygular. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | Belirtilen üstbilgi ve altbilgiye sahip aralığa belirli bir sütun şerit oluşturma teması uygular Ayarlar'da devre dışı bırakabilirsiniz. |
applyRowBanding() | Banding | Aralığa varsayılan bir satır şeridi oluşturma teması uygular. |
applyRowBanding(bandingTheme) | Banding | Aralığa, belirtilen bir satır şeridi oluşturma teması uygular. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | Belirtilen üstbilgi ve altbilgi ayarlarıyla aralığa belirli bir satır şeridi oluşturma teması uygular. |
autoFill(destination, series) | void | destinationRange aralığını bu aralıktaki verilere dayalı verilerle doldurur. |
autoFillToNeighbor(series) | void | 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. |
breakApart() | Range | Aralıktaki çok sütunlu hücreleri tekrar tek tek hücrelere bölün. |
canEdit() | Boolean | Kullanıcının aralıktaki her hücreyi düzenleme izni olup olmadığını belirler. |
check() | Range | Aralıktaki onay kutularının durumunu "işaretli" olarak değiştirir. |
clear() | Range | İçerik ve biçim aralığını temizler. |
clear(options) | Range | Aşağıdaki gibi içerik aralığını, biçimi, veri doğrulama kurallarını ve/veya yorumları temizler: verilen gelişmiş seçeneklerdir. |
clearContent() | Range | Biçimlendirmeyi değiştirmeden aralığın içeriğini temizler. |
clearDataValidations() | Range | Aralıkla ilgili veri doğrulama kurallarını temizler. |
clearFormat() | Range | Bu aralığın biçimlendirmesini temizler. |
clearNote() | Range | Verilen hücredeki veya hücrelerdeki notu temizler. |
collapseGroups() | Range | Tamamen aralık içinde yer alan tüm grupları daraltır. |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | Aralığın biçimlendirmesini belirtilen konuma kopyalayın. |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | Aralığın biçimlendirmesini belirtilen konuma kopyalayın. |
copyTo(destination) | void | Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar. |
copyTo(destination, copyPasteType, transposed) | void | Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar. |
copyTo(destination, options) | void | Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar. |
copyValuesToRange(gridId, column, columnEnd, row, rowEnd) | void | Aralığın içeriğini belirtilen konuma kopyalayın. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | Aralığın içeriğini belirtilen konuma kopyalayın. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | Veri kaynağından, ilk hücreye sabitlenmiş boş bir veri kaynağı pivot tablosu oluşturur bu aralıkta. |
createDataSourceTable(dataSource) | DataSourceTable | Veri kaynağından, bu sayfadaki ilk hücreye sabitlenmiş boş bir veri kaynağı tablosu oluşturur aralığı. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Bu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinderApi değeri döndürür aralığı. |
createFilter() | Filter | Bir filtre oluşturur ve bunu sayfada belirtilen aralığa uygular. |
createPivotTable(sourceData) | PivotTable | Belirtilen sourceData sütunundan, ilk hücreye sabitlenmiş boş bir pivot tablo oluşturur
bu aralıkta. |
createTextFinder(findText) | TextFinder | Aralık için, bu aralıktaki metni bulup değiştirebilen bir metin bulucu oluşturur. |
deleteCells(shiftDimension) | void | Bu hücre aralığını siler. |
expandGroups() | Range | Aralık veya kontrol açma/kapatma düğmesi bu aralıkla kesişen daraltılmış grupları genişletir. |
getA1Notation() | String | A1 gösteriminde aralığın dize açıklamasını döndürür. |
getBackground() | String | Aralıkta sol üstteki hücrenin arka plan rengini döndürür (örneğin, '#ffffff' ). |
getBackgroundObject() | Color | Aralı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) | Range | Bir aralıktaki belirli bir hücreyi döndürür. |
getColumn() | Integer | Bu aralığın başlangıç sütunu konumunu döndürür. |
getDataRegion() | Range | 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. |
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() | DataSourceFormula | 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. |
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() | String | Bu aralıktaki veriler için, grafik ve sorgu oluşturmak amacıyla kullanılabilecek bir URL döndürür. |
getDataTable() | DataTable | Bu nesnenin içindeki verileri DataTable olarak döndürün. |
getDataTable(firstRowIsHeader) | DataTable | Bu aralıktaki verileri DataTable olarak döndürün. |
getDataValidation() | DataValidation | Aralı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() | String | Aralı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() | Filter | Bu aralığın ait olduğu sayfadaki filtreyi veya filtre yoksa null döndürür.
yapacaksınız. |
getFontColorObject() | Color | Aralığı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() | String | Aralığın sol üst köşesindeki hücrenin yazı tipi ailesini döndürür. |
getFontLine() | String | Aralığı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() | Integer | Aralığı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() | String | Sol ü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() | String | Aralığı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() | String | Aralığın sol üst hücresine ilişkin formülü (A1 gösterimini) veya hücre boş veya formül içermiyor. |
getFormulaR1C1() | String | Belirli 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() | Integer | Aralığın üst sayfasının ızgara kimliğini döndürür. |
getHeight() | Integer | Aralığın yüksekliğini döndürür. |
getHorizontalAlignment() | String | Hü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() | Integer | Bitiş sütunu konumunu döndürür. |
getLastRow() | Integer | Bitiş 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) | Range | 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, |
getNote() | String | Verilen aralıkla ilişkili notu döndürür. |
getNotes() | String[][] | Aralıktaki hücrelerle ilişkili notları döndürür. |
getNumColumns() | Integer | Bu aralıktaki sütun sayısını döndürür. |
getNumRows() | Integer | Bu aralıktaki satır sayısını döndürür. |
getNumberFormat() | String | Verilen 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() | RichTextValue | 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. |
getRichTextValues() | RichTextValue[][] | Aralıktaki hücreler için Zengin Metin değerlerini döndürür. |
getRow() | Integer | Bu aralık için satır konumunu döndürür. |
getRowIndex() | Integer | Bu aralık için satır konumunu döndürür. |
getSheet() | Sheet | Bu aralığın ait olduğu sayfayı döndürür. |
getTextDirection() | TextDirection | Aralığı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() | TextRotation | Aralığı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() | TextStyle | Aralığın sol üst hücresinin metin stilini döndürür. |
getTextStyles() | TextStyle[][] | Aralıktaki hücrelerin metin stillerini döndürür. |
getValue() | Object | Aralı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() | String | Hü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() | Integer | Sütunlardaki aralığın genişliğini döndürür. |
getWrap() | Boolean | Hü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() | WrapStrategy | Aralığı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) | Range | Bu aralığa boş hücreler ekler. |
insertCheckboxes() | Range | 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 . |
insertCheckboxes(checkedValue) | Range | 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. |
insertCheckboxes(checkedValue, uncheckedValue) | Range | Aralıktaki her bir hücreye onay kutuları ekler, işaretli olanlar için özel değerlerle yapılandırılır kontrol edebilirsiniz. |
isBlank() | Boolean | Aralık tamamen boşsa true değerini döndürür. |
isChecked() | Boolean | Aralıktaki tüm hücrelerin onay kutusu durumunun "işaretli" olup olmadığını döndürür. |
isEndColumnBounded() | Boolean | Aralık sonunun belirli bir sütuna bağlı olup olmadığını belirler. |
isEndRowBounded() | Boolean | Aralık sonunun belirli bir satıra bağlı olup olmadığını belirler. |
isPartOfMerge() | Boolean | Geçerli aralıktaki hücreler birleştirilmiş hücrelerle çakışırsa true değerini döndürür. |
isStartColumnBounded() | Boolean | Aralık başlangıcının belirli bir sütuna bağlı olup olmadığını belirler. |
isStartRowBounded() | Boolean | Aralık başlangıcının belirli bir satıra bağlı olup olmadığını belirler. |
merge() | Range | Aralıktaki hücreleri tek bir blok halinde birleştirir. |
mergeAcross() | Range | Aralıktaki hücreleri, aralıktaki sütunlarda birleştirin. |
mergeVertically() | Range | Aralıktaki hücreleri birleştirir. |
moveTo(target) | void | Bu aralıktan kesip (hem biçim hem de değerler) hedef aralığa yapıştırın. |
offset(rowOffset, columnOffset) | Range | Belirtilen 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) | Range | 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. |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | 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. |
protect() | Protection | Aralığa erişimi olan kullanıcılar dışında, aralığın düzenlenmesine karşı korunabilecek bir nesne oluşturur. izni gerekir. |
randomize() | Range | Verilen aralıktaki satırların sırasını rastgele hale getirir. |
removeCheckboxes() | Range | Aralıktaki tüm onay kutularını kaldırır. |
removeDuplicates() | Range | Bu aralık içinde bulunan ve herhangi bir önceki satırda yer alır. |
removeDuplicates(columnsToCompare) | Range | 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. |
setBackground(color) | Range | CSS gösteriminde ('#ffffff' gibi) aralıktaki tüm hücrelerin arka plan rengini ayarlar
veya 'white' ). |
setBackgroundObject(color) | Range | Aralıktaki tüm hücrelerin arka plan rengini ayarlar. |
setBackgroundObjects(color) | Range | Arka plan renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setBackgroundRGB(red, green, blue) | Range | RGB değerlerini (0 ile 255 arasındaki tam sayılar dahil) kullanarak arka planı belirtilen renge ayarlar. |
setBackgrounds(color) | Range | Arka plan renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setBorder(top, left, bottom, right, vertical, horizontal) | Range | Kenarlık özelliğini ayarlar. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | Range | Kenarlık özelliğini renk ve/veya stille ayarlar. |
setDataValidation(rule) | Range | Aralıktaki tüm hücreler için tek bir veri doğrulama kuralı ayarlar. |
setDataValidations(rules) | Range | Aralıktaki tüm hücreler için veri doğrulama kurallarını ayarlar. |
setFontColor(color) | Range | CSS gösteriminde yazı tipi rengini ayarlar ('#ffffff' veya 'white' gibi). |
setFontColorObject(color) | Range | Verilen aralığın yazı tipi rengini ayarlar. |
setFontColorObjects(colors) | Range | Yazı tipi renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontColors(colors) | Range | Yazı tipi renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontFamilies(fontFamilies) | Range | Yazı tipi ailelerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontFamily(fontFamily) | Range | Yazı tipi ailesini ayarlar (ör. "SFTP") veya "Helvetica". |
setFontLine(fontLine) | Range | Verilen 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) | Range | Yazı tipi boyutunu ayarlar. Boyut, kullanılacak nokta boyutudur. |
setFontSizes(sizes) | Range | Yazı tipi boyutlarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontStyle(fontStyle) | Range | Verilen aralığın ('italic' veya 'normal' ) yazı tipi stilini ayarlayın. |
setFontStyles(fontStyles) | Range | Yazı tipi stillerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontWeight(fontWeight) | Range | Belirtilen aralık için yazı tipi ağırlığını (normal/kalın) ayarlayın. |
setFontWeights(fontWeights) | Range | Yazı tipi ağırlıklarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFormula(formula) | Range | Bu aralığa ilişkin formülü günceller. |
setFormulaR1C1(formula) | Range | Bu aralığa ilişkin formülü günceller. |
setFormulas(formulas) | Range | Dikdörtgen formül ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFormulasR1C1(formulas) | Range | Dikdörtgen formül ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setHorizontalAlignment(alignment) | Range | Verilen aralık (sol/orta/sağ) için yatay (soldan sağa) hizalamayı ayarlayın. |
setHorizontalAlignments(alignments) | Range | Yatay hizalamalardan oluşan dikdörtgen bir ızgara ayarlar. |
setNote(note) | Range | Notu verilen değere ayarlar. |
setNotes(notes) | Range | Dikdörtgen bir not ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setNumberFormat(numberFormat) | Range | Sayıyı veya tarih biçimini, verilen biçimlendirme dizesine ayarlar. |
setNumberFormats(numberFormats) | Range | Sayı veya tarih biçimlerinden oluşan dikdörtgen bir tablo ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setRichTextValue(value) | Range | Aralıktaki hücreler için Zengin Metin değerini ayarlar. |
setRichTextValues(values) | Range | Zengin Metin değerlerinin dikdörtgen ızgarasını ayarlar. |
setShowHyperlink(showHyperlink) | Range | Aralığın köprüleri gösterip göstermeyeceğini belirler. |
setTextDirection(direction) | Range | Aralıktaki hücrelerin metin yönünü ayarlar. |
setTextDirections(directions) | Range | Metin yönlerinden oluşan dikdörtgen bir ızgara ayarlar. |
setTextRotation(degrees) | Range | Aralıktaki hücreler için metin döndürme ayarlarını belirler. |
setTextRotation(rotation) | Range | Aralıktaki hücreler için metin döndürme ayarlarını belirler. |
setTextRotations(rotations) | Range | Metin döndürmeleri için dikdörtgen bir tablo ayarlar. |
setTextStyle(style) | Range | Aralıktaki hücrelerin metin stilini ayarlar. |
setTextStyles(styles) | Range | Metin stillerinden oluşan dikdörtgen bir ızgara ayarlar. |
setValue(value) | Range | Aralığın değerini ayarlar. |
setValues(values) | Range | Dikdörtgen bir değer ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setVerticalAlignment(alignment) | Range | Verilen aralık (üst/orta/alt) için dikey (üstten alta) hizalamayı ayarlayın. |
setVerticalAlignments(alignments) | Range | Dikey hizalamaları içeren dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setVerticalText(isVertical) | Range | Aralıktaki hücreler için metnin yığın halinde yığılıp yığılmayacağını ayarlar. |
setWrap(isWrapEnabled) | Range | Verilen aralığın hücre sarmalamayı ayarlayın. |
setWrapStrategies(strategies) | Range | Sarma stratejilerinden oluşan bir dikdörtgen ızgara ayarlar. |
setWrapStrategy(strategy) | Range | Aralıktaki hücreler için metin kaydırma stratejisini ayarlar. |
setWraps(isWrapEnabled) | Range | Kelime kaydırma politikalarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
shiftColumnGroupDepth(delta) | Range | Aralığın sütun gruplama derinliğini belirtilen tutara göre değiştirir. |
shiftRowGroupDepth(delta) | Range | Aralığın satır gruplama derinliğini belirtilen tutara göre değiştirir. |
sort(sortSpecObj) | Range | Verilen aralıktaki hücreleri, belirtilen sütun ve düzene göre sıralar. |
splitTextToColumns() | void | Bir metin sütununu, otomatik olarak algılanan sınırlayıcıya göre birden fazla sütuna böler. |
splitTextToColumns(delimiter) | void | Belirtilen dizeyi özel sınırlayıcı olarak kullanarak bir metin sütununu birden fazla sütuna böler. |
splitTextToColumns(delimiter) | void | Bir metin sütununu, belirtilen sınırlayıcıya göre birden fazla sütuna böler. |
trimWhitespace() | Range | Bu aralıktaki her hücredeki boşlukları (ör. boşluklar, sekmeler veya yeni satırlar) kırpar. |
uncheck() | Range | Aralı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
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni 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
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
visibility | DeveloperMetadataVisibility | Yeni 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
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni 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
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verilerinin değeri. |
visibility | DeveloperMetadataVisibility | Yeni 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
Ad | Tür | Açıklama |
---|---|---|
bandingTheme | BandingTheme | Aralı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
Ad | Tür | Açıklama |
---|---|---|
bandingTheme | BandingTheme | Aralıktaki sütunlara uygulanacak bir renk teması. |
showHeader | Boolean | true ise şerit oluşturma teması başlık rengi ilk
sütununa girin. |
showFooter | Boolean | true 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
Ad | Tür | Açıklama |
---|---|---|
bandingTheme | BandingTheme | Aralı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
Ad | Tür | Açıklama |
---|---|---|
bandingTheme | BandingTheme | Aralıktaki satırlara uygulanacak renk teması. |
showHeader | Boolean | true değerine ayarlanırsa şerit oluşturma teması başlık rengi ilk satıra uygulanır. |
showFooter | Boolean | true 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
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Değ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ğ.) |
series | AutoFillSeries | Yeni 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
Ad | Tür | Açıklama |
---|---|---|
series | AutoFillSeries | Yeni 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
Ad | Tür | Açıklama |
---|---|---|
options | Object | Aşağıda listelenen, gelişmiş parametreleri belirten bir JavaScript nesnesi. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
commentsOnly | Boolean | Yalnızca yorumların temizlenip temizlenmeyeceğini belirler. |
contentsOnly | Boolean | Yalnızca içeriğin temizlenip temizlenmeyeceğini belirler. |
formatOnly | Boolean | Yalnızca biçimin temizlenip temizlenmeyeceğini belirler. temizlemenin biçimi veri doğrulama kurallarını da temizler. |
validationsOnly | Boolean | Yalnızca veri doğrulama kurallarının temizlenip temizlenmeyeceğini belirler. |
skipFilteredRows | Boolean | Filtrelenmiş 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
Ad | Tür | Açıklama |
---|---|---|
gridId | Integer | Konumdan bağımsız olarak, sayfanın e-tablodaki benzersiz kimliği. |
column | Integer | Hedef aralığın ilk sütunu. |
columnEnd | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
rowEnd | Integer | Hedef 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
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Hedef sayfa. |
column | Integer | Hedef aralığın ilk sütunu. |
columnEnd | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
rowEnd | Integer | Hedef 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
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Kopyalanacak 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
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Kopyalanacak hedef aralık; hücrenin yalnızca sol üstteki konumu alakalı olmalıdır. |
copyPasteType | CopyPasteType | Aralık içeriğinin seçeceğiz. |
transposed | Boolean | Aralığı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
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Kopyalanacak hedef aralık; hücrenin yalnızca sol üstteki konumu alakalı olmalıdır. |
options | Object | Aşağıda listelenen, gelişmiş parametreleri belirten bir JavaScript nesnesi. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
formatOnly | Boolean | yalnızca biçimin kopyalanması gerektiğini belirtir |
contentsOnly | Boolean | yalnı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
Ad | Tür | Açıklama |
---|---|---|
gridId | Integer | Konumdan bağımsız olarak, sayfanın e-tablodaki benzersiz kimliği. |
column | Integer | Hedef aralığın ilk sütunu. |
columnEnd | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
rowEnd | Integer | Hedef 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
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Hedef sayfa. |
column | Integer | Hedef aralığın ilk sütunu. |
columnEnd | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
rowEnd | Integer | Hedef 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
Ad | Tür | Açıklama |
---|---|---|
dataSource | DataSource | Pivot 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
Ad | Tür | Açıklama |
---|---|---|
dataSource | DataSource | Pivot 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); }
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:
PivotTable.addFilter(sourceDataColumn, filterCriteria)
ile pivot tablo filtresi oluşturunDataSourceSheet.addFilter(columnName, filterCriteria)
ile veritabanına bağlı bir sayfa için filtre oluşturun.DataSourcePivotTable.addFilter(columnName, filterCriteria)
ile veritabanına bağlı pivot tablo için filtre oluşturun
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
Ad | Tür | Açıklama |
---|---|---|
sourceData | Range | Pivot 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
Ad | Tür | Açıklama |
---|---|---|
findText | String | Aranacak 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
Ad | Tür | Açıklama |
---|---|---|
shiftDimension | Dimension | Mevcut 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
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Aralığa göre hücre satırı. |
column | Integer | Aralığ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
Ad | Tür | Açıklama |
---|---|---|
dimension | Dimension | Aralığı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
Ad | Tür | Açıklama |
---|---|---|
firstRowIsHeader | Boolean | İ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
Ad | Tür | Açıklama |
---|---|---|
direction | Direction | Bir 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]);
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
Ad | Tür | Açıklama |
---|---|---|
shiftDimension | Dimension | Mevcut 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
Ad | Tür | Açıklama |
---|---|---|
checkedValue | Object | Onay 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
Ad | Tür | Açıklama |
---|---|---|
checkedValue | Object | Onay kutusu veri doğrulaması için işaretli değer. |
uncheckedValue | Object | Onay 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
Boolean
— true
, 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 Boolean
— 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
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
Ad | Tür | Açıklama |
---|---|---|
target | Range | Bu 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
Ad | Tür | Açıklama |
---|---|---|
rowOffset | Integer | Aralığı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. |
columnOffset | Integer | Aralığı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
Ad | Tür | Açıklama |
---|---|---|
rowOffset | Integer | Aralığı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. |
columnOffset | Integer | Aralığı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. |
numRows | Integer | Yeni 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
Ad | Tür | Açıklama |
---|---|---|
rowOffset | Integer | Aralığı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. |
columnOffset | Integer | Aralığı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. |
numRows | Integer | Yeni aralıktaki satırların yüksekliği. |
numColumns | Integer | Yeni 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
Ad | Tür | Açıklama |
---|---|---|
columnsToCompare | Integer[] | 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
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS 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
Ad | Tür | Açıklama |
---|---|---|
color | Color | Ayarlanacak 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
Ad | Tür | Açıklama |
---|---|---|
color | Color[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
red | Integer | RGB gösterimindeki kırmızı değer. |
green | Integer | RGB gösterimindeki yeşil değer. |
blue | Integer | RGB 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
Ad | Tür | Açıklama |
---|---|---|
color | String[][] | 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
Ad | Tür | Açıklama |
---|---|---|
top | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
left | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
bottom | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
right | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
vertical | Boolean | İç dikey kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
horizontal | Boolean | İç 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
Ad | Tür | Açıklama |
---|---|---|
top | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
left | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
bottom | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
right | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
vertical | Boolean | İç dikey kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
horizontal | Boolean | İç yatay kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
color | String | CSS gösteriminde bir renk ('#ffffff' veya 'white' gibi), varsayılan renk için null (siyah). |
style | BorderStyle | Kenarlı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
Ad | Tür | Açıklama |
---|---|---|
rule | DataValidation | Ayarlanacak 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
Ad | Tür | Açıklama |
---|---|---|
rules | DataValidation[][] | 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
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS 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
Ad | Tür | Açıklama |
---|---|---|
color | Color | Ayarlanacak 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
Ad | Tür | Açıklama |
---|---|---|
colors | Color[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
colors | Object[][] | 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
Ad | Tür | Açıklama |
---|---|---|
fontFamilies | Object[][] | 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
Ad | Tür | Açıklama |
---|---|---|
fontFamily | String | Ayarlanacak 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
Ad | Tür | Açıklama |
---|---|---|
fontLine | String | Yazı 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
Ad | Tür | Açıklama |
---|---|---|
fontLines | Object[][] | 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
Ad | Tür | Açıklama |
---|---|---|
size | Integer | Nokta 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
Ad | Tür | Açıklama |
---|---|---|
sizes | Object[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
fontStyle | String | Yazı 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
Ad | Tür | Açıklama |
---|---|---|
fontStyles | Object[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
fontWeight | String | Yazı 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
Ad | Tür | Açıklama |
---|---|---|
fontWeights | Object[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
formula | String | Hü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
Ad | Tür | Açıklama |
---|---|---|
formula | String | Dize 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
Ad | Tür | Açıklama |
---|---|---|
formulas | String[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
formulas | String[][] | 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
Ad | Tür | Açıklama |
---|---|---|
alignment | String | Hizalama ('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
Ad | Tür | Açıklama |
---|---|---|
alignments | Object[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
note | String | Aralı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
Ad | Tür | Açıklama |
---|---|---|
notes | Object[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
numberFormat | String | Sayı 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
Ad | Tür | Açıklama |
---|---|---|
numberFormats | Object[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
value | RichTextValue | İ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
Ad | Tür | Açıklama |
---|---|---|
values | RichTextValue[][] | İ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
setShowHyperlink(showHyperlink)
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
Ad | Tür | Açıklama |
---|---|---|
showHyperlink | Boolean | Kö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
Ad | Tür | Açıklama |
---|---|---|
direction | TextDirection | İ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
Ad | Tür | Açıklama |
---|---|---|
directions | TextDirection[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
degrees | Integer | Standart 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
Ad | Tür | Açıklama |
---|---|---|
rotation | TextRotation | İ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
Ad | Tür | Açıklama |
---|---|---|
rotations | TextRotation[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
style | TextStyle | İ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
Ad | Tür | Açıklama |
---|---|---|
styles | TextStyle[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
value | Object | Aralığı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
Ad | Tür | Açıklama |
---|---|---|
values | Object[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
alignment | String | Hizalama ('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
Ad | Tür | Açıklama |
---|---|---|
alignments | Object[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
isVertical | Boolean | Metnin 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
Ad | Tür | Açıklama |
---|---|---|
isWrapEnabled | Boolean | Metnin 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
Ad | Tür | Açıklama |
---|---|---|
strategies | WrapStrategy[][] | İ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
Ad | Tür | Açıklama |
---|---|---|
strategy | WrapStrategy | İ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
Ad | Tür | Açıklama |
---|---|---|
isWrapEnabled | Object[][] | 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
Ad | Tür | Açıklama |
---|---|---|
delta | Integer | Bu 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
Ad | Tür | Açıklama |
---|---|---|
delta | Integer | Bu 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
Ad | Tür | Açıklama |
---|---|---|
sortSpecObj | Object | Sı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
Ad | Tür | Açıklama |
---|---|---|
delimiter | String | Bö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
Ad | Tür | Açıklama |
---|---|---|
delimiter | TextToColumnsDelimiter | Bö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