Class Sheet

Sayfa

E-tablo sayfalarına erişme ve bunları değiştirme Sık kullanılan işlemler, bir sayfayı yeniden adlandırma ve aralığa erişmedir kaldırabilirsiniz.

Yöntemler

YöntemDönüş türüKısa açıklama
activate()SheetBu sayfayı etkinleştirir.
addDeveloperMetadata(key)SheetBelirtilen anahtarla geliştirici meta verilerini sayfaya ekler.
addDeveloperMetadata(key, visibility)SheetBelirtilen anahtar ve görünürlüğe sahip geliştirici meta verilerini sayfaya ekler.
addDeveloperMetadata(key, value)SheetBelirtilen anahtar ve değere sahip geliştirici meta verilerini sayfaya ekler.
addDeveloperMetadata(key, value, visibility)SheetBelirtilen anahtar, değer ve görünürlüğe sahip geliştirici meta verilerini sayfaya ekler.
appendRow(rowContents)SheetSayfadaki geçerli veri bölgesinin altına bir satır ekler.
asDataSourceSheet()DataSourceSheetSayfa SheetType.DATASOURCE türündeyse sayfayı DataSourceSheet, aksi takdirde null olarak döndürür.
autoResizeColumn(columnPosition)SheetBelirli bir sütunun genişliğini, içeriğine uyacak şekilde ayarlar.
autoResizeColumns(startColumn, numColumns)Sheetİçeriklerine sığması için belirtilen sütun konumundan başlayan tüm sütunların genişliğini ayarlar.
autoResizeRows(startRow, numRows)SheetVerilen satır konumundan başlayan tüm satırların yüksekliğini, içeriklerinin sığacağı şekilde ayarlar.
clear()Sheetİçerik sayfasını ve biçimlendirme bilgilerini temizler.
clear(options)SheetVerilen gelişmiş seçeneklerde belirtilen içerik sayfasını ve/veya biçimi temizler.
clearConditionalFormatRules()voidSayfadaki tüm koşullu biçimlendirme kurallarını kaldırır.
clearContents()SheetBiçimlendirme bilgilerini korurken içindekiler sayfasını temizler.
clearFormats()Sheetİçeriği korurken biçimlendirme sayfasını temizler.
clearNotes()SheetTüm notların bulunduğu sayfayı temizler.
collapseAllColumnGroups()SheetSayfadaki tüm sütun gruplarını daraltır.
collapseAllRowGroups()SheetSayfadaki tüm satır gruplarını daraltır.
copyTo(spreadsheet)SheetSayfayı, kaynakla aynı e-tablo olabilecek belirli bir e-tabloya kopyalar.
createDeveloperMetadataFinder()DeveloperMetadataFinderŞu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür: bu sayfadaki bilgilere göz atın.
createTextFinder(findText)TextFinderSayfa için bir metin bulucu oluşturur ve sayfadaki metni bulup değiştirebilir.
deleteColumn(columnPosition)SheetBelirtilen sütun konumundaki sütunu siler.
deleteColumns(columnPosition, howMany)voidBelirli bir sütun konumundan başlayan bir dizi sütunu siler.
deleteRow(rowPosition)SheetVerilen satır konumundaki satırı siler.
deleteRows(rowPosition, howMany)voidBelirtilen satır konumundan başlayan satır sayısını siler.
expandAllColumnGroups()SheetSayfadaki tüm sütun gruplarını genişletir.
expandAllRowGroups()SheetSayfadaki tüm satır gruplarını genişletir.
expandColumnGroupsUpToDepth(groupDepth)SheetTüm sütun gruplarını belirtilen derinliğe kadar genişletir ve diğer tüm sütun gruplarını daraltır.
expandRowGroupsUpToDepth(groupDepth)SheetTüm satır gruplarını belirtilen derinliğe kadar genişletir ve diğer tüm satır gruplarını daraltır.
getActiveCell()RangeBu sayfadaki etkin hücreyi döndürür.
getActiveRange()RangeEtkin sayfada seçili aralığı veya etkin bir aralık yoksa null değerini döndürür.
getActiveRangeList()RangeListEtkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null'i döndürür. değerleridir.
getBandings()Banding[]Bu sayfadaki tüm şeritleri döndürür.
getCharts()EmbeddedChart[]Bu sayfadaki bir grafik dizisi döndürür.
getColumnGroup(columnIndex, groupDepth)GroupBelirtilen dizin ve grup derinliğindeki sütun grubunu döndürür.
getColumnGroupControlPosition()GroupControlTogglePositionSayfadaki tüm sütun grupları için GroupControlTogglePosition değerini döndürür.
getColumnGroupDepth(columnIndex)IntegerVerilen dizindeki sütunun grup derinliğini döndürür.
getColumnWidth(columnPosition)IntegerBelirli bir sütunun piksel cinsinden genişliğini alır.
getConditionalFormatRules()ConditionalFormatRule[]Bu sayfadaki tüm koşullu biçim kurallarını alın.
getCurrentCell()RangeEtkin sayfadaki geçerli hücreyi veya geçerli hücre yoksa null değerini döndürür.
getDataRange()RangeVerilerin bulunduğu boyutlara karşılık gelen bir Range döndürür.
getDataSourceFormulas()DataSourceFormula[]Tüm veri kaynağı formüllerini alır.
getDataSourcePivotTables()DataSourcePivotTable[]Tüm veri kaynağı pivot tablolarını alır.
getDataSourceTables()DataSourceTable[]Tüm veri kaynağı tablolarını alır.
getDeveloperMetadata()DeveloperMetadata[]Bu sayfayla ilişkili tüm geliştirici meta verilerini alın.
getDrawings()Drawing[]Sayfa üzerindeki bir çizim dizisini döndürür.
getFilter()FilterBu sayfadaki filtreyi veya filtre yoksa null değerini döndürür.
getFormUrl()StringYanıtları bu sayfaya gönderen formun URL'sini veya bu URL'ye sahipse null döndürür. sayfasında ilişkili form yok.
getFrozenColumns()IntegerDondurulmuş sütunların sayısını döndürür.
getFrozenRows()IntegerDondurulmuş satır sayısını döndürür.
getImages()OverGridImage[]Sayfadaki tüm kılavuz üzeri resimleri döndürür.
getIndex()IntegerSayfanın üst e-tablosundaki konumunu alır.
getLastColumn()Integerİçerik barındıran son sütunun konumunu döndürür.
getLastRow()Integerİçerik barındıran son satırın konumunu döndürür.
getMaxColumns()Integerİçeriğinden bağımsız olarak, sayfadaki mevcut sütun sayısını döndürür.
getMaxRows()Integerİçeriğinden bağımsız olarak sayfadaki satırların geçerli sayısını döndürür.
getName()StringSayfanın adını döndürür.
getNamedRanges()NamedRange[]Bu sayfadaki tüm adlandırılmış aralıkları alır.
getParent()SpreadsheetBu sayfayı içeren Spreadsheet değerini döndürür.
getPivotTables()PivotTable[]Bu sayfadaki tüm pivot tabloları döndürür.
getProtections(type)Protection[]Sayfadaki tüm korumalı aralıkları temsil eden bir nesne dizisini veya tek bir öğeyi alır diziyi temsil eder.
getRange(row, column)RangeVerilen koordinatlarda sol üstteki hücreyi içeren aralığı döndürür.
getRange(row, column, numRows)RangeVerilen koordinatlarda sol üstteki hücreyi ve verilen sayıda hücreyi içeren aralığı döndürür satır.
getRange(row, column, numRows, numColumns)RangeVerilen koordinatlarda, verilen sayıda satırla sol üstteki hücreyi içeren aralığı döndürür yardımcı olur.
getRange(a1Notation)RangeA1 gösteriminde veya R1C1 notasyonunda belirtilen aralığı döndürür.
getRangeList(a1Notations)RangeListBelirtilen sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür boş olmayan bir A1 gösterimleriyle veya R1C1 gösterimleriyle ilişkilendirilmelidir.
getRowGroup(rowIndex, groupDepth)GroupVerilen dizin ve grup derinliğindeki satır grubunu döndürür.
getRowGroupControlPosition()GroupControlTogglePositionSayfadaki tüm satır grupları için GroupControlTogglePosition değerini döndürür.
getRowGroupDepth(rowIndex)IntegerVerilen dizindeki satırın grup derinliğini döndürür.
getRowHeight(rowPosition)IntegerVerilen satırın piksel cinsinden yüksekliğini alır.
getSelection()SelectionE-tablodaki geçerli Selection değerini döndürür.
getSheetId()IntegerBu nesnenin temsil ettiği sayfanın kimliğini döndürür.
getSheetName()StringSayfa adını döndürür.
getSheetValues(startRow, startColumn, numRows, numColumns)Object[][]Verilen koordinatlardan başlayarak bu aralık için değerlerin dikdörtgen ızgarasını döndürür.
getSlicers()Slicer[]Sayfada bir dilimleyici dizisi döndürür.
getTabColorObject()ColorSayfa sekmesi rengini veya sayfa sekmesinde renk yoksa null değerini alır.
getType()SheetTypeSayfanın türünü döndürür.
hasHiddenGridlines()BooleanSayfanın kılavuz çizgileri gizliyse true değerini döndürür; aksi takdirde false değerini döndürür.
hideColumn(column)voidVerilen aralıktaki sütunu veya sütunları gizler.
hideColumns(columnIndex)voidBelirtilen dizinde tek bir sütunu gizler.
hideColumns(columnIndex, numColumns)voidBelirtilen dizinden başlayarak bir veya daha fazla ardışık sütunu gizler.
hideRow(row)voidBelirtilen aralıktaki satırları gizler.
hideRows(rowIndex)voidBelirtilen dizindeki satırı gizler.
hideRows(rowIndex, numRows)voidBelirtilen dizinden başlayarak bir veya daha fazla ardışık satırı gizler.
hideSheet()SheetBu sayfayı gizler.
insertChart(chart)voidBu sayfaya yeni bir grafik ekler.
insertColumnAfter(afterPosition)SheetVerilen sütun konumundan sonra bir sütun ekler.
insertColumnBefore(beforePosition)SheetVerilen sütun konumundan önce bir sütun ekler.
insertColumns(columnIndex)voidBir sayfada belirtilen konuma boş bir sütun ekler.
insertColumns(columnIndex, numColumns)voidBelirtilen konumdan başlayarak sayfaya bir veya daha fazla ardışık boş sütun ekler.
insertColumnsAfter(afterPosition, howMany)SheetVerilen sütun konumundan sonra belirli sayıda sütun ekler.
insertColumnsBefore(beforePosition, howMany)SheetBelirtilen sütun konumundan önce bir sayıda sütun ekler.
insertImage(blobSource, column, row)OverGridImageBelirli bir satır ve sütundaki belgeye resim olarak BlobSource ekler.
insertImage(blobSource, column, row, offsetX, offsetY)OverGridImageBelirli bir satır ve sütundaki belgeye resim olarak BlobSource ekler. piksel uzaklığı.
insertImage(url, column, row)OverGridImageDokümana belirli bir satır ve sütundaki resim ekler.
insertImage(url, column, row, offsetX, offsetY)OverGridImageBelirli bir satır ve sütunda dokümana bir resim ekler. Bu resim belirli bir piksel uzaklığıyla gösterilir.
insertRowAfter(afterPosition)SheetVerilen satır konumundan sonra bir satır ekler.
insertRowBefore(beforePosition)SheetVerilen satır konumundan önce bir satır ekler.
insertRows(rowIndex)voidBir sayfada belirtilen konuma boş bir satır ekler.
insertRows(rowIndex, numRows)voidBelirtilen konumdan başlayarak sayfaya bir veya daha fazla ardışık boş satır ekler.
insertRowsAfter(afterPosition, howMany)SheetBelirtilen satır konumundan sonra birkaç satır ekler.
insertRowsBefore(beforePosition, howMany)SheetVerilen satır konumundan önce birkaç satır ekler.
insertSlicer(range, anchorRowPos, anchorColPos)SlicerBu sayfaya yeni bir dilimleyici ekler.
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)SlicerBu sayfaya yeni bir dilimleyici ekler.
isColumnHiddenByUser(columnPosition)BooleanBelirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.
isRightToLeft()BooleanBu sayfa düzeni sağdan sola ise true değerini döndürür.
isRowHiddenByFilter(rowPosition)BooleanBelirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür.
isRowHiddenByUser(rowPosition)BooleanBelirtilen satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.
isSheetHidden()BooleanSayfa şu anda gizliyse true değerini döndürür.
moveColumns(columnSpec, destinationIndex)voidBelirtilen aralık tarafından seçilen sütunları destinationIndex ile belirtilen konuma taşır.
moveRows(rowSpec, destinationIndex)voidBelirtilen aralık tarafından seçilen satırları destinationIndex ile belirtilen konuma taşır.
newChart()EmbeddedChartBuilderBu sayfa için yeni bir grafik oluşturmak üzere bir oluşturucu döndürür.
protect()ProtectionSayfayı düzenlenmeye karşı koruyabilecek, iznidir.
removeChart(chart)voidBir grafiği üst sayfadan kaldırır.
setActiveRange(range)RangeBelirtilen aralığı, etkin sayfada active range olarak ayarlar ve current cell olarak aralıkta sol üstteki hücre.
setActiveRangeList(rangeList)RangeListBelirtilen aralık listesini active ranges olarak etkin sayfada.
setActiveSelection(range)RangeBu sayfa için etkin seçim bölgesini ayarlar.
setActiveSelection(a1Notation)RangeA1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi etkin seçimi ayarlar.
setColumnGroupControlPosition(position)SheetSayfadaki sütun grubu denetimini açma/kapatma düğmesinin konumunu ayarlar.
setColumnWidth(columnPosition, width)SheetBelirli bir sütunun genişliğini piksel cinsinden ayarlar.
setColumnWidths(startColumn, numColumns, width)SheetBelirli sütunların genişliğini piksel cinsinden ayarlar.
setConditionalFormatRules(rules)voidSayfadaki mevcut tüm koşullu biçim kurallarını giriş kurallarıyla değiştirir.
setCurrentCell(cell)RangeBelirtilen hücreyi current cell olarak ayarlar.
setFrozenColumns(columns)voidBelirtilen sayıda sütunu dondurur.
setFrozenRows(rows)voidBelirtilen sayıda satırı dondurur.
setHiddenGridlines(hideGridlines)SheetSayfa kılavuz çizgilerini gizler veya ortaya çıkarır.
setName(name)SheetSayfa adını ayarlar.
setRightToLeft(rightToLeft)SheetSayfa düzenini sağdan sola olarak ayarlar veya ayarı kaldırır.
setRowGroupControlPosition(position)SheetSayfadaki satır grubu denetimi açma/kapatma düğmesinin konumunu ayarlar.
setRowHeight(rowPosition, height)SheetBelirli bir satırın satır yüksekliğini piksel cinsinden ayarlar.
setRowHeights(startRow, numRows, height)SheetBelirtilen satırların yüksekliğini piksel cinsinden ayarlar.
setRowHeightsForced(startRow, numRows, height)SheetBelirtilen satırların yüksekliğini piksel cinsinden ayarlar.
setTabColor(color)SheetSayfa sekmesi rengini ayarlar.
setTabColorObject(color)SheetSayfa sekmesi rengini ayarlar.
showColumns(columnIndex)voidSütunu belirtilen dizinde gösterir.
showColumns(columnIndex, numColumns)voidBelirtilen dizinden başlayarak bir veya daha fazla ardışık sütunu gösterir.
showRows(rowIndex)voidBelirtilen dizindeki satırı gösterir.
showRows(rowIndex, numRows)voidBelirtilen dizinden başlayarak bir veya daha fazla ardışık satırı gösterir.
showSheet()SheetSayfayı görünür hale getirir.
sort(columnPosition)SheetSayfayı sütuna göre artan düzende sıralar.
sort(columnPosition, ascending)SheetSayfayı sütuna göre sıralar.
unhideColumn(column)voidSütunu belirtilen aralıkta gösterir.
unhideRow(row)voidVerilen aralıktaki satırı gösterir.
updateChart(chart)voidBu sayfadaki grafiği günceller.

Ayrıntılı belgeler

activate()

Bu sayfayı etkinleştirir. Sayfanın kendisini değiştirmez, yalnızca üst öğenin etkin öğe kavramını değiştirir. sayfasına gitmelidir.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.activate();

Return

Sheet — Yeni etkinleştirilen e-tablo.


addDeveloperMetadata(key)

Belirtilen anahtarla geliştirici meta verilerini sayfaya 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'NAME' to the developer metadata for the sheet.
sheet.addDeveloperMetadata('NAME');

// Gets the updated metadata info and logs it to the console.
console.log(sheet.getDeveloperMetadata()[0].getKey());

Parametreler

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

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, 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 anahtar ve görünürlüğe sahip geliştirici meta verilerini sayfaya 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'NAME' and sets the developer metadata visibility to PROJECT
// for the sheet.
sheet.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

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

Parametreler

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

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, 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 sayfaya 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for the sheet.
sheet.addDeveloperMetadata('COMPANY', 'TECH');

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

Parametreler

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

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, 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 sayfaya 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and sets the
// visibility to DOCUMENT for the sheet.
sheet.addDeveloperMetadata(
  'COMPANY',
  'TECH',
  SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

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

Parametreler

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

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

appendRow(rowContents)

Sayfadaki geçerli veri bölgesinin altına bir satır ekler. Hücre içeriği = ile tekrar eklendiğinde formül olarak yorumlanır.

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

// Appends a new row with 3 columns to the bottom of the current
// data region in the sheet containing the values in the array.
sheet.appendRow(["a man", "a plan", "panama"]);

Parametreler

AdTürAçıklama
rowContentsObject[]Sayfadaki son satırdan sonra eklenecek değerler dizisi.

Return

Sheet — Yöntem zinciri oluşturmak için yararlı olan e-tablo.

Yetkilendirme

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

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

asDataSourceSheet()

Sayfa SheetType.DATASOURCE türündeyse sayfayı DataSourceSheet, aksi takdirde null olarak döndürür.

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the data source sheet value if the sheet is of type
// SpreadsheetApp.SheetType.DATASOURCE, otherwise this returns a null value.
const dataSourceSheet = sheet.asDataSourceSheet();

// Gets the data source sheet value and logs it to the console.
console.log(dataSourceSheet);
console.log(sheet.getType().toString());

Return

DataSourceSheet — Bir veri kaynağı sayfası.

Yetkilendirme

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

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

autoResizeColumn(columnPosition)

Belirli bir sütunun genişliğini, içeriğine uyacak şekilde ayarlar.

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

sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...');

// Sets the first column to a width which fits the text
sheet.autoResizeColumn(1);

Parametreler

AdTürAçıklama
columnPositionIntegerYeniden boyutlandırmak için belirtilen sütunun konumu.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

autoResizeColumns(startColumn, numColumns)

İçeriklerine sığması için belirtilen sütun konumundan başlayan tüm sütunların genişliğini ayarlar.

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

// Sets the first 15 columns to a width that fits their text.
sheet.autoResizeColumns(1, 15);

Parametreler

AdTürAçıklama
startColumnIntegerOtomatik olarak yeniden boyutlandırılacak başlangıç sütunu.
numColumnsIntegerOtomatik olarak yeniden boyutlandırılacak sütun sayısı.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

autoResizeRows(startRow, numRows)

Verilen satır konumundan başlayan tüm satırların yüksekliğini, içeriklerinin sığacağı şekilde ayarlar.

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

// Sets the first 15 rows to a height that fits their text.
sheet.autoResizeRows(1, 15);

Parametreler

AdTürAçıklama
startRowIntegerOtomatik olarak yeniden boyutlandırılacak başlangıç satırı.
numRowsIntegerOtomatik olarak yeniden boyutlandırılacak satır sayısı.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, 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 sayfasını ve biçimlendirme bilgilerini temizler.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clear();

Return

Sheet: Temizlenen 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

clear(options)

Verilen gelişmiş seçeneklerde belirtilen içerik sayfasını ve/veya biçimi temizler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.clear({ formatOnly: true, contentsOnly: true });

Parametreler

AdTürAçıklama
optionsObjectAşağıda listelenen gelişmiş seçenekler içeren bir JavaScript haritası.

Gelişmiş parametreler

AdTürAçıklama
contentsOnlyBooleanİçeriğin temizlenip temizlenmeyeceğini belirler.
formatOnlyBooleanBiçimin temizlenip temizlenmeyeceğini belirler.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

clearConditionalFormatRules()

Sayfadaki tüm koşullu biçimlendirme kurallarını kaldırır. Giriş olarak boş bir diziyle setConditionalFormatRules(rules) çağrısına eşdeğerdir.

var sheet = SpreadsheetApp.getActiveSheet();
sheet.clearConditionalFormatRules();

Yetkilendirme

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

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

clearContents()

Biçimlendirme bilgilerini korurken içindekiler sayfasını temizler.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clearContents();

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

clearFormats()

İçeriği korurken biçimlendirme sayfasını temizler.

Biçimlendirme, verilerin "Biçim" altında bulunan seçeneklerin izin verdiği şekilde biçimlendirilmesini ifade eder menü (ör: kalın, italik, koşullu biçimlendirme) kullanın ve hücre genişliği veya yüksekliği kullanmayın.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clearFormats();

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

clearNotes()

Tüm notların bulunduğu sayfayı temizler.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clearNotes();

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

collapseAllColumnGroups()

Sayfadaki tüm sütun gruplarını daraltır.

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

// All column groups on the sheet are collapsed.
sheet.collapseAllColumnGroups();

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

collapseAllRowGroups()

Sayfadaki tüm satır gruplarını daraltır.

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

// All row groups on the sheet are collapsed.
sheet.collapseAllRowGroups();

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, 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(spreadsheet)

Sayfayı, kaynakla aynı e-tablo olabilecek belirli bir e-tabloya kopyalar. İlgili içeriği oluşturmak için kullanılan kopyalanan sayfanın adı "[Orijinal ad] kopyası" olarak adlandırılır.

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

var destination = SpreadsheetApp.openById('ID_GOES HERE');
sheet.copyTo(destination);

Parametreler

AdTürAçıklama
spreadsheetSpreadsheetBu sayfanın kopyalanacağı e-tablo. Bu, gösterir.

Return

Sheet — Zincirleme için yeni 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

createDeveloperMetadataFinder()

Şu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür: bu sayfadaki bilgilere göz atın. Meta veriler, veya sayfadaki bir satır, sütun ya da aralıkla ilişkilendirilebilir.

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds developer metadata for testing.
sheet.addDeveloperMetadata('CITY', 'PARIS');

// Creates the developer metadata finder.
const metadatafinder = sheet.createDeveloperMetadataFinder();

// Finds the metadata with value 'PARIS' and displays its key in the console.
console.log(metadatafinder.withValue('PARIS').find()[0].getKey());

Return

DeveloperMetadataFinder: Bu sayfanın kapsamındaki meta verileri aramak için geliştirici meta veri bulucudur.


createTextFinder(findText)

Sayfa için bir metin bulucu oluşturur ve sayfadaki metni bulup değiştirebilir.

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

// Creates  a text finder.
var textFinder = sheet.createTextFinder('dog');

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

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

Parametreler

AdTürAçıklama
findTextStringAranacak metin.

Return

TextFinder — Sayfa için TextFinder.


deleteColumn(columnPosition)

Belirtilen sütun konumundaki sütunu siler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first column
sheet.deleteColumn(1);

Parametreler

AdTürAçıklama
columnPositionIntegerSütunun, ilk sütun için 1'den başlayan konumu.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

deleteColumns(columnPosition, howMany)

Belirtilen sütun konumundan başlayan bir dizi sütunu siler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first two columns
sheet.deleteColumns(1, 2);

Parametreler

AdTürAçıklama
columnPositionIntegerSilinecek ilk sütunun konumu.
howManyIntegerSilinecek 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

deleteRow(rowPosition)

Verilen satır konumundaki satırı siler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first row
sheet.deleteRow(1);

Parametreler

AdTürAçıklama
rowPositionIntegerSatırın, ilk satır için 1'den başlayan konumu.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

deleteRows(rowPosition, howMany)

Belirtilen satır konumundan başlayan satır sayısını siler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first two rows
sheet.deleteRows(1, 2);

Parametreler

AdTürAçıklama
rowPositionIntegerSilinecek ilk satırın konumu.
howManyIntegerSilinecek 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

expandAllColumnGroups()

Sayfadaki tüm sütun gruplarını genişletir. Bu yöntem için en az bir sütun grubu gerekir.

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

// All column groups on the sheet are expanded.
sheet.expandAllColumnGroups();

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

expandAllRowGroups()

Sayfadaki tüm satır gruplarını genişletir. Bu yöntem için en az bir satır grubu gerekir.

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

// All row groups on the sheet are expanded.
sheet.expandAllRowGroups();

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

expandColumnGroupsUpToDepth(groupDepth)

Tüm sütun gruplarını belirtilen derinliğe kadar genişletir ve diğer tüm sütun gruplarını daraltır.

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

// All column groups of depth 2 and lower are expanded, and groups with depth
// 3 and higher are collapsed.
sheet.expandColumnGroupsUpToDepth(2);

Parametreler

AdTürAçıklama
groupDepthIntegerSütun gruplarının genişletileceği grup derinliği.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

expandRowGroupsUpToDepth(groupDepth)

Tüm satır gruplarını belirtilen derinliğe kadar genişletir ve diğer tüm satır gruplarını daraltır.

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

// All row groups of depth 2 and lower are expanded, and groups with depth
// 3 and higher are collapsed.
sheet.expandRowGroupsUpToDepth(2);

Parametreler

AdTürAçıklama
groupDepthIntegerSatır gruplarının genişletileceği grup derinliği.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

getActiveCell()

Bu sayfadaki etkin hücreyi döndürür.

Not: Geçerli parametreyi döndüren getCurrentCell() kullanılması tercih edilir vurgulanan hücreyi tıklayın.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Returns the active cell
var cell = sheet.getActiveCell();

Return

Range - geçerli etkin 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

getActiveRange()

Etkin sayfada seçili aralığı veya etkin bir aralık yoksa null değerini döndürür. Eğer birden çok aralık seçilir. Bu yöntem yalnızca en son seçilen aralığı döndürür.

"Etkin aralık" terimi kullanıcının etkin sayfada seçtiği aralığı ifade eder. Ancak özel işlevde, hücrenin etkin bir şekilde yeniden hesaplandığını ifade eder.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var activeRange = sheet.getActiveRange();

Return

Range - etkin 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:


getActiveRangeList()

Etkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null'i döndürür. değerleridir.

Tek bir aralık seçildiyse bu bir getActiveRange() çağrısı gibi davranır.

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

Return

RangeList — etkin aralıkları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

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


getBandings()

Bu sayfadaki 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Gets info on the bandings' second row color and logs it to the console.
for (const banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Return

Banding[] — Bu sayfadaki 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

getCharts()

Bu sayfadaki bir grafik dizisi döndürür.

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

for (var i in charts) {
  var chart = charts[i];
  // Do something with the chart
}

Return

EmbeddedChart[]: Bir grafik 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

getColumnGroup(columnIndex, groupDepth)

Belirtilen dizin ve grup derinliğindeki sütun grubunu döndürür.

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

// Returns the group whose control index is at column 2 and has a depth of 1, or
// null if the group doesn’t exist.
var columnGroup = sheet.getColumnGroup(2, 1);

Parametreler

AdTürAçıklama
columnIndexIntegerGrup kontrolü açma/kapatma düğmesinin sütun dizini veya grup içindeki bir dizin.
groupDepthIntegerGrubun derinliği.

Return

Group — Kontrol dizinindeki ve derinlikteki sütun grubu veya grup mevcut değildir.

Yetkilendirme

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

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

getColumnGroupControlPosition()

Sayfadaki tüm sütun grupları için GroupControlTogglePosition değerini döndürür.

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

// GroupControlTogglePosition.AFTER if the column grouping control toggle is shown after the
// group.
var columnGroupControlPosition = sheet.getColumnGroupControlPosition();

Return

Sütun gruplandırma kontrolünü açma/kapatma düğmesi bu gruptaki gruptan sonra gösterilirse GroupControlTogglePositiontrue sayfa, 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

getColumnGroupDepth(columnIndex)

Verilen dizindeki sütunun grup derinliğini döndürür.

Grup derinliği, sütunla kaç grubun çakıştığını gösterir. Bu değer, sıfır ve sekiz.

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

// 1 if there is a group over columns 1 through 3
var groupDepth = sheet.getColumnGroupDepth(1);

Parametreler

AdTürAçıklama
columnIndexIntegerSütunun dizini.

Return

Integer — Belirtilen dizindeki sütunun grup derinliğ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

getColumnWidth(columnPosition)

Belirli bir sütunun piksel cinsinden genişliğini alır.

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

// Columns start at 1
Logger.log(sheet.getColumnWidth(1));

Parametreler

AdTürAçıklama
columnPositionIntegerİncelenecek sütunun konumu.

Return

Integer — Piksel cinsinden sütun genişliğ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

getConditionalFormatRules()

Bu sayfadaki tüm koşullu biçim kurallarını alın.

// Logs the conditional format rules in a sheet.
var rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules();
for (var i = 0; i < rules.length; i++) {
  var rule = rules[i];
  Logger.log(rule);
}

Return

ConditionalFormatRule[] — Sayfadaki tüm kuralları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

getCurrentCell()

Etkin sayfadaki geçerli hücreyi veya geçerli hücre yoksa null değerini döndürür. İlgili içeriği oluşturmak için kullanılan geçerli hücre, Google E-Tablolar kullanıcı arayüzünde odağın bulunduğu hücredir. Koyu renkle vurgulanmıştır kenarlık. Hiçbir zaman birden fazla geçerli hücre yoktur. Kullanıcı bir veya daha fazla hücre aralığı seçtiğinde seçimdeki hücrelerden biri geçerli hücredir.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// Returns the current highlighted cell in the one of the active ranges.
var currentCell = sheet.getCurrentCell();

Return

Range — geçerli 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

getDataRange()

Verilerin bulunduğu boyutlara karşılık gelen bir Range döndürür.

Bu, işlevsel olarak A1 ve A1 ile sınırlanan bir Aralık oluşturmaya eşdeğerdir. (Sheet.getLastColumn(), Sheet.getLastRow()).

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

// This represents ALL the data
var range = sheet.getDataRange();
var values = range.getValues();

// This logs the spreadsheet in CSV format with a trailing comma
for (var i = 0; i < values.length; i++) {
  var row = "";
  for (var j = 0; j < values[i].length; j++) {
    if (values[i][j]) {
      row = row + values[i][j];
    }
    row = row + ",";
  }
  Logger.log(row);
}

Return

Range - e-tablodaki tüm verileri içeren 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

getDataSourceFormulas()

Tüm veri kaynağı formüllerini alır.

// Opens the spreadsheet by its ID. If you created your script from within 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 an array of the data source formulas on Sheet1.
// To get an array of data source formulas for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceFormulas = sheet.getDataSourceFormulas();

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

Return

DataSourceFormula[]: Veri kaynağı formüllerinin 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

getDataSourcePivotTables()

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 an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.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()

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 an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].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

getDeveloperMetadata()

Bu sayfayla ilişkili tüm geliştirici meta verilerini alın.

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds developer metadata for testing.
sheet.addDeveloperMetadata('CITY', 'PARIS');

// Gets all the developer metadata for the sheet.
const developerMetaDataList = sheet.getDeveloperMetadata();

// Logs the developer metadata to the console.
for (const developerMetaData of developerMetaDataList) {
  console.log(developerMetaData.getKey());
}

Return

DeveloperMetadata[]: Bu sayfayla 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

getDrawings()

Sayfa üzerindeki bir çizim dizisini 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all the drawings from the sheet.
const allDrawings = sheet.getDrawings();

 // Logs the number of drawings present on the sheet.
console.log(allDrawings.length);

Return

Drawing[]: Bu sayfadaki çizimlerin 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

getFilter()

Bu sayfadaki filtreyi veya filtre yoksa null değerini döndürür.

// Gets the filter on the active sheet.
let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.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

getFormUrl()

Yanıtları bu sayfaya gönderen formun URL'sini veya bu URL'ye sahipse null döndürür. sayfasında ilişkili form yok.

var sheet = SpreadsheetApp.getActiveSheet();
var url = sheet.getFormUrl();

Return

String — Yanıtlarını bu sayfaya yerleştiren formun URL'si veya bu durumda null sayfasının ilişkili bir formu yok.

Yetkilendirme

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

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

getFrozenColumns()

Dondurulmuş sütunların sayısını döndürür.

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

Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());

Return

Integer - dondurulmuş sütunların 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

getFrozenRows()

Dondurulmuş satır sayısını döndürür.

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

Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());

Return

Integer: dondurulmuş satırların 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

getImages()

Sayfadaki tüm kılavuz üzeri resimleri döndürür.

// Opens the spreadsheet file 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 over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead.
const images = sheet.getImages();

// For each image, logs the anchor cell in A1 notation.
for (const image of images) {
 console.log(image.getAnchorCell().getA1Notation());
}

Return

OverGridImage[]: Kılavuz üzeri görüntüler 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

getIndex()

Sayfanın üst e-tablosundaki konumunu alır. Başlangıç: 1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
// Note that the JavaScript index is 0, but this logs 1
var sheet = ss.getSheets()[0];
// ... because spreadsheets are 1-indexed
Logger.log(sheet.getIndex());

Return

Integer: Sayfanın, üst e-tablosundaki 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

getLastColumn()

İçerik barındıran son sütunun konumunu döndürür.

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

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Return

Integer: Sayfanın içerik barındıran son sütunu

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, 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()

İçerik barındıran son satırın konumunu döndürür.

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

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Return

Integer: Sayfanın içerik barındıran son 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

getMaxColumns()

İçeriğinden bağımsız olarak, sayfadaki mevcut sütun sayısını döndürür.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
Logger.log(first.getMaxColumns());

Return

Integer: Sayfanın maksimum genişliğ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

getMaxRows()

İçeriğinden bağımsız olarak sayfadaki satırların geçerli sayısını döndürür.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
Logger.log(first.getMaxRows());

Return

Integer: Sayfanın maksimum 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

getName()

Sayfanın adını döndürür.

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

Return

String: Sayfanın adı.

Yetkilendirme

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

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

getNamedRanges()

Bu sayfadaki tüm adlandırılmış aralıkları alır.

// The code below logs the name of the first named range.
var namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges();
if (namedRanges.length > 1) {
  Logger.log(namedRanges[0].getName());
}

Return

NamedRange[]: Sayfadaki tüm adlandırılmış aralıkları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

getParent()

Bu sayfayı içeren Spreadsheet değerini döndürür.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// parent is identical to ss
var parent = sheet.getParent();

Return

Spreadsheet: Üst e-tablo.

Yetkilendirme

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

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

getPivotTables()

Bu sayfadaki tüm pivot tabloları 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all the pivot table info for the sheet.
const pivotTables = sheet.getPivotTables();

// Logs the pivot tables to the console.
for (const pivotTable of pivotTables) {
  console.log(pivotTable.getSourceDataRange().getValues());
}

Return

PivotTable[]: Bu sayfadaki pivot tablolar.

Yetkilendirme

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

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

getProtections(type)

Sayfadaki tüm korumalı aralıkları temsil eden bir nesne dizisini veya tek bir öğeyi alır diziyi temsil eder.

// Remove all range protections in the spreadsheet that the user has permission to edit.
var sheet = SpreadsheetApp.getActiveSheet();
var protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}
// Remove sheet protection from the active sheet, if the user has permission to edit it.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0];
if (protection && protection.canEdit()) {
  protection.remove();
}

Parametreler

AdTürAçıklama
typeProtectionTypeKorunan alanın türü, SpreadsheetApp.ProtectionType.RANGE veya SpreadsheetApp.ProtectionType.SHEET.

Return

Protection[]: Sayfadaki tüm korumalı aralıkları temsil eden bir nesne dizisi veya tek bir öğe diziyi temsil eder.

Yetkilendirme

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

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

getRange(row, column)

Verilen koordinatlarda sol üstteki hücreyi içeren aralığı döndürür.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Passing only two arguments returns a "range" with a single cell.
var range = sheet.getRange(1, 1);
var values = range.getValues();
Logger.log(values[0][0]);

Parametreler

AdTürAçıklama
rowIntegerDöndürülecek hücrenin satır dizini; satır dizine ekleme 1 ile başlar.
columnIntegerDöndürülecek hücrenin sütun dizini; sütun dizine ekleme 1 ile başlar.

Return

Range: Yalnızca bu hücreyi içeren bir aralıktı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

getRange(row, column, numRows)

Verilen koordinatlarda sol üstteki hücreyi ve verilen sayıda hücreyi içeren aralığı döndürür satır.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// When the "numRows" argument is used, only a single column of data is returned.
var range = sheet.getRange(1, 1, 3);
var values = range.getValues();

// Prints 3 values from the first column, starting from row 1.
for (var row in values) {
  for (var col in values[row]) {
    Logger.log(values[row][col]);
  }
}

Parametreler

AdTürAçıklama
rowIntegerAralığın başlangıç satırı dizini; satır dizine ekleme 1 ile başlar.
columnIntegerAralığın sütun dizini; sütun dizine ekleme 1 ile başlar.
numRowsIntegerDöndürülecek satır sayısı.

Return

Range: Belirtilen satır sayısına sahip tek bir veri sütunu 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

getRange(row, column, numRows, numColumns)

Verilen koordinatlarda, verilen sayıda satırla sol üstteki hücreyi içeren aralığı döndürür yardımcı olur.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 3, 3);
var values = range.getValues();

// Print values from a 3x3 box.
for (var row in values) {
  for (var col in values[row]) {
    Logger.log(values[row][col]);
  }
}

Parametreler

AdTürAçıklama
rowIntegerAralığın başlangıç satırı dizini; satır dizine ekleme 1 ile başlar.
columnIntegerAralığın başlangıç sütun dizini; sütun dizine ekleme 1 ile başlar.
numRowsIntegerDöndürülecek satır sayısı.
numColumnsIntegerDöndürülecek sütun sayısı.

Return

Range: Belirtilen alana karşılık gelen 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

getRange(a1Notation)

A1 gösteriminde veya R1C1 notasyonunda belirtilen aralığı döndürür.

// Get a range A1:D4 on sheet titled "Invoices"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var range = ss.getRange("Invoices!A1:D4");

// Get cell A1 on the first sheet
var sheet = ss.getSheets()[0];
var cell = sheet.getRange("A1");

Parametreler

AdTürAçıklama
a1NotationStringA1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi döndürülecek aralık.

Return

Range - belirlenen konumdaki 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

getRangeList(a1Notations)

Belirtilen sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür boş olmayan bir A1 gösterimleriyle veya R1C1 gösterimleriyle ilişkilendirilmelidir.

// Get a list of ranges A1:D4, F1:H4.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var rangeList  = sheet.getRangeList(['A1:D4', 'F1:H4']);

Parametreler

AdTürAçıklama
a1NotationsString[]A1 gösterimi veya R1C1 gösteriminde belirtildiği gibi, döndürülecek aralıkların listesi.

Return

RangeList: Belirlenen konumdaki aralık 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

getRowGroup(rowIndex, groupDepth)

Verilen dizin ve grup derinliğindeki satır grubunu döndürür.

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

// Returns the group whose control index is at row 2 and has a depth of 1, or
// null if the group doesn’t exist.
var rowGroup = sheet.getRowGroup(2, 1);

Parametreler

AdTürAçıklama
rowIndexIntegerGrup kontrolü açma/kapatma düğmesinin satır dizini veya grup içindeki bir dizin.
groupDepthIntegerGrubun derinliği.

Return

Group — Kontrol dizinindeki ve derinlikteki satır grubu veya grup mevcut değildir.

Yetkilendirme

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

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

getRowGroupControlPosition()

Sayfadaki tüm satır grupları için GroupControlTogglePosition değerini döndürür.

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

// GroupControlTogglePosition.AFTER if the row grouping control toggle is shown after the
// group.
var rowGroupControlPosition = sheet.getRowGroupControlPosition();

Return

Satır gruplandırma kontrolünü açma/kapatma düğmesi bu sayfada gruptan sonra gösteriliyorsa GroupControlTogglePositiontrue veya 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

getRowGroupDepth(rowIndex)

Verilen dizindeki satırın grup derinliğini döndürür.

Grup derinliği, satırla kaç grubun çakıştığını gösterir. Sıfır arasında olabilir ve sekiz.

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

// 1 if there is a group over rows 1 through 3
var groupDepth = sheet.getRowGroupDepth(1);

Parametreler

AdTürAçıklama
rowIndexIntegerSatırın dizini.

Return

Integer — Belirtilen dizindeki satırın grup derinliğ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

getRowHeight(rowPosition)

Verilen satırın piksel cinsinden yüksekliğini alır.

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

// Rows start at 1
Logger.log(sheet.getRowHeight(1));

Parametreler

AdTürAçıklama
rowPositionIntegerİncelenecek satırın konumu.

Return

Integer - piksel cinsinden satır 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

getSelection()

E-tablodaki geçerli Selection değerini döndürür.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var currentCell = selection.getCurrentCell();

Return

Selection - geçerli seçim

Yetkilendirme

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

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

getSheetId()

Bu nesnenin temsil ettiği sayfanın kimliğini döndürür.

Bu, e-tabloya özgü olan sayfanın kimliğidir. Kimlik, tek tip bir Sayfa konumundan bağımsız olarak sayfa oluşturma zamanında atanan, artan tam sayı. Bu değeri, Sheet örneği yerine gridId parametresi alan Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd) gibi yöntemlerle birlikte kullanışlıdır.

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

Logger.log(sheet.getSheetId());

Return

Integer - E-tabloya özgü sayfa 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

getSheetName()

Sayfa adını döndürür.

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

Logger.log(sheet.getSheetName());

Return

String — sayfanın adı

Yetkilendirme

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

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

getSheetValues(startRow, startColumn, numRows, numColumns)

Verilen koordinatlardan başlayarak bu aralık için değerlerin dikdörtgen ızgarasını döndürür. A -1 satır veya sütun konumu olarak verilen değer, en son satırı veya sütunu almaya eşdeğerdir yer alır.

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

// The two samples below produce the same output
var values = sheet.getSheetValues(1, 1, 3, 3);
Logger.log(values);

var range = sheet.getRange(1, 1, 3, 3);
values = range.getValues();
Logger.log(values);

Parametreler

AdTürAçıklama
startRowIntegerBaşlangıç satırının konumu.
startColumnIntegerBaşlangıç sütununun konumu.
numRowsIntegerDeğer döndürülecek satır sayısı.
numColumnsIntegerDeğer döndürülecek sütun sayısı.

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

getSlicers()

Sayfada bir dilimleyici dizisi 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all slicers in the spreadsheet.
const slicers = sheet.getSlicers();

// Logs the slicer titles to the console.
for (const slicer of slicers) {
  console.log(slicer.getTitle());
}

Return

Slicer[] — Bu sayfadaki dilimleyicilerin 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

getTabColorObject()

Sayfa sekmesi rengini veya sayfa sekmesinde renk yoksa null değerini alır.

// This example assumes there is a sheet named "Sheet1"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("Sheet1");
var color = first.getTabColorObject();

Return

Color: Sayfa sekmesi rengi veya sayfa sekmesinde renk yoksa null.

Yetkilendirme

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

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

getType()

Sayfanın türünü döndürür.

Varsayılan sayfa türü SheetType.GRID şeklindedir. Tek bir yerleştirilmiş öğe içeren bir sayfa EmbeddedChart gibi bir nesne SheetType.OBJECT sayfasıdır.

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

Return

SheetType — Sayfanın tü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

hasHiddenGridlines()

Sayfanın kılavuz çizgileri gizliyse true değerini döndürür; aksi takdirde false değerini döndürür. Kılavuz çizgileri varsayılan olarak görünür durumdadı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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Checks if the spreadsheet has hidden gridelines and logs the result to the console.
console.log(sheet.hasHiddenGridlines());

Return

Boolean — Kılavuz çizgileri gizliyse 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

hideColumn(column)

Verilen aralıktaki sütunu veya sütunları gizler.

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

// This hides the first column
let range = sheet.getRange("A1");
sheet.hideColumn(range);

// This hides the first 3 columns
let range = sheet.getRange("A:C");
sheet.hideColumn(range);

Parametreler

AdTürAçıklama
columnRangeGizlenecek sütun 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

hideColumns(columnIndex)

Belirtilen dizinde tek bir sütunu gizler. Bu yöntem için 1-dizin kullanın.

Dizin kullanarak birden fazla sütunu gizlemek için hideColumns(columnIndex, numColumns) işlevini kullanın.

Aralık kullanarak birden fazla sütunu gizlemek için hideColumn() işlevini kullanın.

let ss = SpreadsheetApp.getActiveSpreadsheet();
let sheet = ss.getSheets()[0];
// Hides the first column
sheet.hideColumns(1);

Parametreler

AdTürAçıklama
columnIndexIntegerGizlenecek sütunun dizini.

Yetkilendirme

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

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

hideColumns(columnIndex, numColumns)

Belirtilen dizinden başlayarak bir veya daha fazla ardışık sütunu gizler. Bu yöntem için 1-dizin kullanın.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Hides the first three columns
sheet.hideColumns(1, 3);

Parametreler

AdTürAçıklama
columnIndexIntegerGizlenecek sütunların başlangıç dizini.
numColumnsIntegerGizlenecek 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

hideRow(row)

Belirtilen aralıktaki satırları gizler.

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

// This hides the first row
var range = sheet.getRange("A1");
sheet.hideRow(range);

Parametreler

AdTürAçıklama
rowRangeGizlenecek satır 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

hideRows(rowIndex)

Belirtilen dizindeki satırı gizler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Hides the first row
sheet.hideRows(1);

Parametreler

AdTürAçıklama
rowIndexIntegerGizlenecek satırın dizini.

Yetkilendirme

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

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

hideRows(rowIndex, numRows)

Belirtilen dizinden başlayarak bir veya daha fazla ardışık satırı gizler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Hides the first three rows
sheet.hideRows(1, 3);

Parametreler

AdTürAçıklama
rowIndexIntegerGizlenecek satırların başlangıç dizini.
numRowsIntegerGizlenecek 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

hideSheet()

Bu sayfayı gizler. Sayfa zaten gizliyse herhangi bir etkisi olmaz. Bu yöntem bir istisna oluşturur.

var sheet = SpreadsheetApp.getActiveSheet();
sheet.hideSheet();

Return

Sheet — Geçerli 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

insertChart(chart)

Bu sayfaya yeni bir grafik ekler.

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

// This creates a simple bar chart from the first three rows
// of the first two columns of the spreadsheet
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B4"))
    .setPosition(5, 5, 0, 0)
    .setOption("title", "Dynamic Chart")
    .build();
sheet.insertChart(chart);

Parametreler

AdTürAçıklama
chartEmbeddedChartEklenecek grafik.

Yetkilendirme

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

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

insertColumnAfter(afterPosition)

Verilen sütun konumundan sonra bir sütun ekler.

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

// This inserts a column after the first column position
sheet.insertColumnAfter(1);

Parametreler

AdTürAçıklama
afterPositionIntegerKendisinden sonra yeni sütunun ekleneceği sütun.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

insertColumnBefore(beforePosition)

Belirtilen sütun konumundan önce bir sütun ekler.

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

// This inserts a column in the first column position
sheet.insertColumnBefore(1);

Parametreler

AdTürAçıklama
beforePositionIntegerKendisine yeni sütunun eklenmesi gereken sütun.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

insertColumns(columnIndex)

Bir sayfada belirtilen konuma boş bir sütun ekler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all columns by one
sheet.insertColumns(1);

Parametreler

AdTürAçıklama
columnIndexIntegerSütunun nereye ekleneceğini gösteren dizin.

Yetkilendirme

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

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

insertColumns(columnIndex, numColumns)

Belirtilen konumdan başlayarak sayfaya bir veya daha fazla ardışık boş sütun ekler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all columns by three
sheet.insertColumns(1, 3);

Parametreler

AdTürAçıklama
columnIndexIntegerSütunun nereye ekleneceğini gösteren dizin.
numColumnsIntegerEklenecek 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

insertColumnsAfter(afterPosition, howMany)

Verilen sütun konumundan sonra belirli sayıda sütun ekler.

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

// Inserts two columns after the first column on the first sheet of the spreadsheet.
sheet.insertColumnsAfter(1,2);

Parametreler

AdTürAçıklama
afterPositionIntegerKendisinden sonra yeni sütunun ekleneceği sütun.
howManyIntegerEklenecek sütun sayısı.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

insertColumnsBefore(beforePosition, howMany)

Belirtilen sütun konumundan önce bir sayıda sütun ekler.

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

// This inserts five columns before the first column
sheet.insertColumnsBefore(1, 5);

Parametreler

AdTürAçıklama
beforePositionIntegerKendisine yeni sütunun eklenmesi gereken sütun.
howManyIntegerEklenecek sütun sayısı.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

insertImage(blobSource, column, row)

Belirli bir satır ve sütundaki belgeye resim olarak BlobSource ekler. Resim boyutu blob içeriklerinden alınır. Desteklenen maksimum blob boyutu 2 MB'tır.

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

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

Parametreler

AdTürAçıklama
blobSourceBlobSourceResim içeriklerini, MIME türünü ve (isteğe bağlı olarak) adı içeren blob.
columnIntegerSütun konumu.
rowIntegerSatır konumu.

Return

OverGridImage — Eklenen resim.

Yetkilendirme

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

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

insertImage(blobSource, column, row, offsetX, offsetY)

Belirli bir satır ve sütundaki dokümana resim olarak BlobSource ekler. piksel uzaklığı. Resim boyutu blob içeriklerinden alınır. Desteklenen maksimum blob boyut 2 MB'tır.

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

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

Parametreler

AdTürAçıklama
blobSourceBlobSourceResim içeriklerini, MIME türünü ve (isteğe bağlı olarak) adı içeren blob.
columnIntegerSütun konumu.
rowIntegerSatır konumu.
offsetXIntegerHücre köşesinden yatay uzaklık (piksel cinsinden).
offsetYIntegerHücre köşesinden dikey uzaklık (piksel cinsinden).

Return

OverGridImage — Eklenen resim.

Yetkilendirme

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

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

insertImage(url, column, row)

Dokümana belirli bir satır ve sütundaki resim ekler.

Sağlanan URL herkesin erişimine açık olmalıdır.

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

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);

Parametreler

AdTürAçıklama
urlStringResmin URL'si.
columnIntegerIzgara sütunu konumu.
rowIntegerIzgara satırı konumu.

Return

OverGridImage — Eklenen resim.

Yetkilendirme

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

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

insertImage(url, column, row, offsetX, offsetY)

Belirli bir satır ve sütunda dokümana bir resim ekler. Bu resim belirli bir piksel uzaklığıyla gösterilir.

Sağlanan URL herkesin erişimine açık olmalıdır.

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

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);

Parametreler

AdTürAçıklama
urlStringResmin URL'si.
columnIntegerSütun konumu.
rowIntegerSatır konumu.
offsetXIntegerHücre köşesinden yatay uzaklık (piksel cinsinden).
offsetYIntegerHücre köşesinden dikey uzaklık (piksel cinsinden).

Return

OverGridImage — Eklenen resim.

Yetkilendirme

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

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

insertRowAfter(afterPosition)

Verilen satır konumundan sonra bir satır ekler.

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

// This inserts a row after the first row position
sheet.insertRowAfter(1);

Parametreler

AdTürAçıklama
afterPositionIntegerKendisinden sonra yeni satırın ekleneceği satır.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

insertRowBefore(beforePosition)

Verilen satır konumundan önce bir satır ekler.

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

// This inserts a row before the first row position
sheet.insertRowBefore(1);

Parametreler

AdTürAçıklama
beforePositionIntegerKendisine yeni satırın eklenmesi gereken satır.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

insertRows(rowIndex)

Bir sayfada belirtilen konuma boş bir satır ekler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all rows down by one
sheet.insertRows(1);

Parametreler

AdTürAçıklama
rowIndexIntegerSatırın nereye ekleneceğini gösteren dizin.

Yetkilendirme

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

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

insertRows(rowIndex, numRows)

Belirtilen konumdan başlayarak sayfaya bir veya daha fazla ardışık boş satır ekler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all rows down by three
sheet.insertRows(1, 3);

Parametreler

AdTürAçıklama
rowIndexIntegerSatırın nereye ekleneceğini gösteren dizin.
numRowsIntegerEklenecek 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

insertRowsAfter(afterPosition, howMany)

Belirtilen satır konumundan sonra birkaç satır ekler.

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

// This inserts five rows after the first row
sheet.insertRowsAfter(1, 5);

Parametreler

AdTürAçıklama
afterPositionIntegerYeni satırların ekleneceği satır.
howManyIntegerEklenecek satır sayısı.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

insertRowsBefore(beforePosition, howMany)

Verilen satır konumundan önce birkaç satır ekler.

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

// This inserts five rows before the first row
sheet.insertRowsBefore(1, 5);

Parametreler

AdTürAçıklama
beforePositionIntegerKendisine yeni satırların ekleneceği satır.
howManyIntegerEklenecek satır sayısı.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

insertSlicer(range, anchorRowPos, anchorColPos)

Bu sayfaya yeni bir dilimleyici 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Inserts the slicer with a random range into the sheet.
const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10);

// Logs the insert slicer result to the console.
console.log(insertSlicers);

Parametreler

AdTürAçıklama
rangeRangeDilimleyici dilimleyicinin oluşturulduğu aralık.
anchorRowPosIntegerDilimleyicinin üst tarafı bu satıra sabitlenir.
anchorColPosIntegerDilimleyicinin üst tarafı bu sütuna sabitlenir.

Return

Slicer — Yeni eklenen dilimleyici.

Yetkilendirme

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

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

insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)

Bu sayfaya yeni bir dilimleyici 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Inserts a slicer using the random range function.
const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0);

// Logs the insert slicer result to the console.
console.log(insertSlicers);

Parametreler

AdTürAçıklama
rangeRangeDilimleyici dilimleyicinin oluşturulduğu aralık.
anchorRowPosIntegerDilimleyicinin üst tarafı bu satıra sabitlenir.
anchorColPosIntegerDilimleyicinin üst tarafı bu sütuna sabitlenir.
offsetXIntegerHücre köşesinden yatay uzaklık (piksel cinsinden).
offsetYIntegerHücre köşesinden dikey uzaklık (piksel cinsinden).

Return

Slicer — Yeni eklenen dilimleyici.

Yetkilendirme

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

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

isColumnHiddenByUser(columnPosition)

Belirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.

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

// Columns start at 1
Logger.log(sheet.isColumnHiddenByUser(1));

Parametreler

AdTürAçıklama
columnPositionIntegerİncelenecek sütunun konumu.

Return

Boolean — Sütun gizliyse true, gizliyse 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

isRightToLeft()

Bu sayfa düzeni sağdan sola ise true değerini döndürür. Sayfa, false değerini döndürür varsayılan soldan sağa düzeni kullanı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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Checks if a spreadsheet is ordered from right to left and logs the result to the console.
console.log(sheet.isRightToLeft());

Return

Boolean — Sağdan solaysa 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

isRowHiddenByFilter(rowPosition)

Belirtilen satırın bir filtre (filtre görünümü değil) tarafından gizlenip gizlenmediğini döndürür.

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByFilter(1));

Parametreler

AdTürAçıklama
rowPositionIntegerİncelenecek satırın konumu.

Return

Boolean — Satır gizliyse true, gizliyse 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

isRowHiddenByUser(rowPosition)

Belirtilen satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByUser(1));

Parametreler

AdTürAçıklama
rowPositionIntegerİncelenecek satırın konumu.

Return

Boolean — Satır gizliyse true, gizliyse 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

isSheetHidden()

Sayfa şu anda gizliyse true değerini döndürür.

var sheet = SpreadsheetApp.getActiveSheet();
if (sheet.isSheetHidden()) {
  // do something...
}

Return

Boolean — Sayfa gizliyse true, gizliyse 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

moveColumns(columnSpec, destinationIndex)

Belirtilen aralık tarafından seçilen sütunları destinationIndex ile belirtilen konuma taşır. columnSpec öğesinin kendisinin, reklam öğesinin tamamını sütun veya taşınacak sütun grubudur; aralığın kapsadığı tüm sütunları seçer.

// The code below moves rows A-B to destination index 5.
// This results in those columns becoming columns C-D.
var sheet = SpreadsheetApp.getActiveSheet();
// Selects column A and column B to be moved.
var columnSpec = sheet.getRange("A1:B1");
sheet.moveColumns(columnSpec, 5);

Parametreler

AdTürAçıklama
columnSpecRangeTaşınması gereken sütunları kapsayan aralık.
destinationIndexIntegerSütunların taşınması gereken dizin. Bu dizinin koordinatlara göre belirlenebilir. Mevcut veriler sağdan kaynak sütunlar ızgaradan kaldırılırken taşınan sütunlara yer açın. Bu nedenle, veriler başlangıçta belirtilenden farklı bir dizine sahip olabilir.

Yetkilendirme

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

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

moveRows(rowSpec, destinationIndex)

Belirtilen aralık tarafından seçilen satırları destinationIndex ile belirtilen konuma taşır. rowSpec öğesinin kendisinin, tüm satırı tam olarak temsil etmesi gerekmez. veya taşınacak satır grubudur. Aralığın kapsadığı tüm satırları seçer.

// The code below moves rows 1-2 to destination index 5.
// This results in those rows becoming rows 3-4.
var sheet = SpreadsheetApp.getActiveSheet();
// Selects row 1 and row 2 to be moved.
var rowSpec = sheet.getRange("A1:A2");
sheet.moveRows(rowSpec, 5);

Parametreler

AdTürAçıklama
rowSpecRangeTaşınması gereken satırları kapsayan aralık.
destinationIndexIntegerSatırların taşınması gereken dizin. Bu dizinin koordinatlara göre otomatik olarak oluşturulur. Mevcut veriler aşağı kaydırılır ve kaynak satırlar ızgaradan kaldırılırken taşınan satırlar için yer açın. Dolayısıyla, veriler başlangıçta belirtilenden farklı bir dizine eklenebilir.

Yetkilendirme

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

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

newChart()

Bu sayfa için yeni bir grafik oluşturmak üzere bir oluşturucu döndürür.

Bu örnekte, yeni bir grafiğin nasıl oluşturulacağı gösterilmektedir:

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B8");
var chartBuilder = sheet.newChart();
chartBuilder.addRange(range)
    .setChartType(Charts.ChartType.LINE)
    .setPosition(2, 2, 0, 0)
    .setOption('title', 'My Line Chart!');
sheet.insertChart(chartBuilder.build());

Return

EmbeddedChartBuilder: Yeni grafik oluşturmak için kullanılan bir oluşturucu.


protect()

Sayfayı düzenlenmeye karşı koruyabilecek, iznidir. Komut dosyası, e-tablo 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, sayfanın korunmadığı anlamına gelir.) Sayfa zaten korunduğundan bu yöntem, mevcut koruma ayarlarını temsil eden bir nesne döndürür. Korunan sayfalar, korumasız bölgeler içerebilir.

// Protect the active sheet, then remove all other users from the list of editors.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.protect().setDescription('Sample protected sheet');

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

removeChart(chart)

Bir grafiği üst sayfadan kaldırır.

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

// This removes all the embedded charts from the spreadsheet
var charts = sheet.getCharts();
for (var i in charts) {
  sheet.removeChart(charts[i]);
}

Parametreler

AdTürAçıklama
chartEmbeddedChartKaldırılacak grafik.

Yetkilendirme

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

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

setActiveRange(range)

Belirtilen aralığı, etkin sayfada active range olarak ayarlar ve current cell olarak aralıkta sol üstteki hücre.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var range = sheet.getRange('A1:D4');
sheet.setActiveRange(range);

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

Parametreler

AdTürAçıklama
rangeRangeEtkin aralık olarak ayarlanacak aralık.

Return

Range - yeni etkin 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

setActiveRangeList(rangeList)

Belirtilen aralık listesini active ranges olarak etkin sayfada. Listedeki son aralık active range olarak ayarlandı.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
sheet.setActiveRangeList(rangeList);

var selection = sheet.getSelection();
// Current cell: B2
var currentCell = selection.getCurrentCell();
// Active range: B2:C4
var activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
var activeRangeList = selection.getActiveRangeList();

Parametreler

AdTürAçıklama
rangeListRangeListSeçilecek aralıkların listesi.

Return

RangeList: Yeni seçilen aralık 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

setActiveSelection(range)

Bu sayfa için etkin seçim bölgesini ayarlar.

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

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

Parametreler

AdTürAçıklama
rangeRangeEtkin seçim olarak ayarlanacak aralık.

Return

Range - yeni etkin 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

setActiveSelection(a1Notation)

A1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi etkin seçimi ayarlar.

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

sheet.setActiveSelection("A1:D4");

Parametreler

AdTürAçıklama
a1NotationStringA1 gösteriminde veya R1C1 notasyonunda belirtildiği şekilde etkin olarak ayarlanacak aralık.

Return

Range - yeni etkin 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

setColumnGroupControlPosition(position)

Sayfadaki sütun grubu denetimini açma/kapatma düğmesinin konumunu ayarlar.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setColumnGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);

Parametreler

AdTürAçıklama
positionGroupControlTogglePositionSütun grubu kontrolünü açma/kapatma düğmesinin konumu.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

setColumnWidth(columnPosition, width)

Belirli bir sütunun genişliğini piksel cinsinden ayarlar.

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

// Sets the first column to a width of 200 pixels
sheet.setColumnWidth(1, 200);

Parametreler

AdTürAçıklama
columnPositionIntegerAyarlanacak sütunun konumu.
widthIntegerPiksel cinsinden ayarlanacak genişlik.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

setColumnWidths(startColumn, numColumns, width)

Belirli sütunların genişliğini piksel cinsinden ayarlar.

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

// Sets the first three columns to a width of 200 pixels
sheet.setColumnWidths(1, 3, 200);

Parametreler

AdTürAçıklama
startColumnIntegerDeğiştirilecek başlangıç sütunu konumu.
numColumnsIntegerDeğiştirilecek sütun sayısı.
widthIntegerPiksel cinsinden ayarlanacak genişlik.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

setConditionalFormatRules(rules)

Sayfadaki mevcut tüm koşullu biçim kurallarını giriş kurallarıyla değiştirir. Kurallar giriş sırasına göre değerlendirilir.

// Remove one of the existing conditional format rules.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
rules.splice(1, 1); // Deletes the 2nd format rule.
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
rulesConditionalFormatRule[]Yeni koşullu biçim kuralları.

Yetkilendirme

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

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

setCurrentCell(cell)

Belirtilen hücreyi current cell olarak ayarlar.

Belirtilen hücre önceden seçilmiş bir aralıkta yer alıyorsa bu aralık hücrenin geçerli hücre olduğu etkin aralık.

Belirtilen hücre seçilen aralıklarda bulunmuyorsa mevcut seçimler şu şekildedir: 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.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var cell = sheet.getRange('B5');
sheet.setCurrentCell(cell);

var selection = sheet.getSelection();
// Current cell: B5
var currentCell = selection.getCurrentCell();

Parametreler

AdTürAçıklama
cellRangeGeçerli hücre olarak ayarlanacak hücre.

Return

Range: Yeni ayarlanan geçerli 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

setFrozenColumns(columns)

Belirtilen sayıda sütunu dondurur. Sıfır ise hiçbir sütun dondurulmaz.

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

// Freezes the first column
sheet.setFrozenColumns(1);

Parametreler

AdTürAçıklama
columnsIntegerDondurulacak 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

setFrozenRows(rows)

Belirtilen sayıda satırı dondurur. Sıfır ise hiçbir satır dondurulmaz.

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

// Freezes the first row
sheet.setFrozenRows(1);

Parametreler

AdTürAçıklama
rowsIntegerDondurulacak 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

setHiddenGridlines(hideGridlines)

Sayfa kılavuz çizgilerini gizler veya ortaya çıkarır.

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

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

// Hides the gridlines in the sheet.
sheet.setHiddenGridlines(true);

Parametreler

AdTürAçıklama
hideGridlinesBooleantrue ise bu sayfadaki kılavuz çizgilerini gizleyin; Aksi takdirde yardımcı olabilir.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

setName(name)

Sayfa adını ayarlar.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.setName("not first anymore");

Parametreler

AdTürAçıklama
nameStringSayfanın yeni adı.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

setRightToLeft(rightToLeft)

Sayfa düzenini sağdan sola olarak ayarlar veya ayarı kaldı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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets the sheet layout, so that the sheet is ordered from right to left.
sheet.setRightToLeft(true);

Parametreler

AdTürAçıklama
rightToLeftBooleantrue ise, sayfa düzeni sağdan sola olacak şekilde ayarlanır ve A1 hücresi en üstte olacak şekilde tıklayın. false ise sayfa düzeni varsayılana ayarlanır. soldan sağa, A1 hücresi sol üstte olacak şekilde.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

setRowGroupControlPosition(position)

Sayfadaki satır grubu denetimi açma/kapatma düğmesinin konumunu ayarlar.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);

Parametreler

AdTürAçıklama
positionGroupControlTogglePositionSatır grubu kontrolü açma/kapatma düğmesinin konumu.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

setRowHeight(rowPosition, height)

Belirli bir satırın satır yüksekliğini piksel cinsinden ayarlar. Varsayılan olarak, satırlar hücre içeriğine sığacak şekilde büyür. Eğer satırları belirli bir yüksekliğe zorlamak istiyorsanız setRowHeightsForced(startRow, numRows, height) değerini kullanın.

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

// Sets the first row to a height of 200 pixels
sheet.setRowHeight(1, 200);

Parametreler

AdTürAçıklama
rowPositionIntegerDeğiştirilecek satır konumu.
heightIntegerAyarlanacak yükseklik (piksel cinsinden).

Return

Sheet — Yöntem zinciri oluşturmak için yararlı olan e-tablo.

Yetkilendirme

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

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

setRowHeights(startRow, numRows, height)

Belirtilen satırların yüksekliğini piksel cinsinden ayarlar. Varsayılan olarak, satırlar hücre içeriğine sığacak şekilde büyür. Şu durumda: satırları belirli bir yüksekliğe zorlamak istiyorsanız setRowHeightsForced(startRow, numRows, height) değerini kullanın.

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

// Sets the first three rows to a height of 20 pixels
sheet.setRowHeights(1, 3, 20);

Parametreler

AdTürAçıklama
startRowIntegerDeğiştirilecek başlangıç satırı konumu.
numRowsIntegerDeğiştirilecek satır sayısı.
heightIntegerAyarlanacak yükseklik (piksel cinsinden).

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

setRowHeightsForced(startRow, numRows, height)

Belirtilen satırların yüksekliğini piksel cinsinden ayarlar. Varsayılan olarak, satırlar hücre içeriğine sığacak şekilde büyür. Zaman setRowHeightsForced kullandığınızda satır öğeleri, hücre içeriğinin satır yüksekliğinden uzun olduğunu düşünelim.

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

// Sets the first three rows to a height of 5 pixels.
sheet.setRowHeightsForced(1, 3, 5);

Parametreler

AdTürAçıklama
startRowIntegerDeğiştirilecek başlangıç satırı konumu.
numRowsIntegerDeğiştirilecek satır sayısı.
heightIntegerAyarlanacak yükseklik (piksel cinsinden).

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

setTabColor(color)

Sayfa sekmesi rengini ayarlar.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.setTabColor("ff0000"); // Set the color to red.
first.setTabColor(null); // Unset the color.

Parametreler

AdTürAçıklama
colorStringCSS gösteriminde bir renk kodu (ör. '#ffffff' veya 'white') veya Sekme rengini sıfırlamak için null.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

setTabColorObject(color)

Sayfa sekmesi rengini ayarlar.

// This example assumes there is a sheet named "Sheet1"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("Sheet1");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
first.setTabColorObject(color); // Set the color to theme accent 1.
first.setTabColorObject(null); // Unset the color.

Parametreler

AdTürAçıklama
colorColorAyarlanacak sayfa sekmesi rengi.

Return

Sheet — Bu sayfa, zincirleme işlemeyle ilgilidir.

Yetkilendirme

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

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

showColumns(columnIndex)

Sütunu belirtilen dizinde gösterir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first column
sheet.showColumns(1);

Parametreler

AdTürAçıklama
columnIndexIntegerGösterilecek sütunun dizini.

Yetkilendirme

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

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

showColumns(columnIndex, numColumns)

Belirtilen dizinden başlayarak bir veya daha fazla ardışık sütunu gösterir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first three columns
sheet.showColumns(1, 3);

Parametreler

AdTürAçıklama
columnIndexIntegerGösterilecek sütunların başlangıç dizini.
numColumnsIntegerGösterilecek 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

showRows(rowIndex)

Belirtilen dizindeki satırı gösterir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first row
sheet.showRows(1);

Parametreler

AdTürAçıklama
rowIndexIntegerGösterilecek satırın dizini.

Yetkilendirme

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

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

showRows(rowIndex, numRows)

Belirtilen dizinden başlayarak bir veya daha fazla ardışık satırı gösterir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first three rows
sheet.showRows(1, 3);

Parametreler

AdTürAçıklama
rowIndexIntegerGösterilecek satırların başlangıç dizini.
numRowsIntegerGösterilecek 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

showSheet()

Sayfayı görünür hale getirir. Sayfa zaten görünür durumdaysa herhangi bir etkisi olmaz.

var sheet = SpreadsheetApp.getActiveSheet();
sheet.showSheet();

Return

Sheet — Geçerli 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

sort(columnPosition)

Sayfayı sütuna göre artan düzende sıralar.

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

// Sorts the sheet by the first column, ascending
sheet.sort(1);

Parametreler

AdTürAçıklama
columnPositionIntegerSıralama ölçütü olarak kullanılacak sütun.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

sort(columnPosition, ascending)

Sayfayı sütuna göre sıralar. Artan veya azalan düzeni belirtmek için bir parametre alır.

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

// Sorts the sheet by the first column, descending
sheet.sort(1, false);

Parametreler

AdTürAçıklama
columnPositionIntegerSıralama ölçütü olarak kullanılacak sütun.
ascendingBooleanArtan sıralama için true, azalan sıralama için false.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlı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

unhideColumn(column)

Sütunu belirtilen aralıkta gösterir.

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

// This unhides the first column if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideColumn(range);

Parametreler

AdTürAçıklama
columnRangeGizliyse, gösterilecek 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

unhideRow(row)

Verilen aralıktaki satırı gösterir.

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

// This unhides the first row if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideRow(range);

Parametreler

AdTürAçıklama
rowRangeGizliyse, gösterilecek 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

updateChart(chart)

Bu sayfadaki grafiği günceller.

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

// This code is going to loop through all the charts and change them to
// column charts
var charts = sheet.getCharts();
for (var i in charts) {
  var chart = charts[i];
  var newChart = chart
      .modify()
      .setChartType(Charts.ChartType.COLUMN)
      .build();
  sheet.updateChart(newChart);
}

Parametreler

AdTürAçıklama
chartEmbeddedChartGüncellenecek grafik.

Yetkilendirme

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

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

Desteği sonlandırılan yöntemler