Class Sheet

Sayfa

E-tablo sayfalarına erişme ve bunları değiştirme. Yaygın işlemler, bir sayfayı yeniden adlandırmak ve sayfadan aralık nesnelerine erişmektir.

Yöntemler

YöntemDönüş türüKısa açıklama
activate()SheetBu sayfayı etkinleştirir.
addDeveloperMetadata(key)SheetBelirtilen anahtarla birlikte geliştirici meta verilerini sayfaya ekler.
addDeveloperMetadata(key, visibility)SheetBelirtilen anahtar ve görünürlükle birlikte geliştirici meta verilerini sayfaya ekler.
addDeveloperMetadata(key, value)SheetBelirtilen anahtar ve değerle birlikte geliştirici meta verilerini sayfaya ekler.
addDeveloperMetadata(key, value, visibility)SheetBelirtilen anahtar, değer ve görünürlükle birlikte geliştirici meta verilerini sayfaya ekler.
appendRow(rowContents)SheetSayfadaki geçerli veri bölgesinin en altına bir satır ekler.
asDataSourceSheet()DataSourceSheetSayfa türü SheetType.DATASOURCE ise DataSourceSheet, değilse null olarak döndürür.
autoResizeColumn(columnPosition)SheetBelirli bir sütunun genişliğini, içeriğine sığacak şekilde ayarlar.
autoResizeColumns(startColumn, numColumns)SheetBelirtilen sütun konumundan başlayan tüm sütunların genişliğini, içeriğine uyacak şekilde ayarlar.
autoResizeRows(startRow, numRows)SheetBelirli bir satır konumundan başlayarak tüm satırların yüksekliğini içeriklerini sığacak şekilde ayarlar.
clear()Sheetİçerik sayfasını ve biçimlendirme bilgilerini temizler.
clear(options)SheetVerilen gelişmiş seçeneklerle belirtilen içindekiler sayfasını ve/veya biçimi temizler.
clearConditionalFormatRules()voidTüm koşullu biçimlendirme kurallarını sayfadan kaldırır.
clearContents()SheetBiçimlendirme bilgilerini korurken içindekiler sayfasını temizler.
clearFormats()Sheetİçerikleri 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ı belirli bir e-tabloya kopyalar. Bu tablo, kaynakla aynı e-tablo olabilir.
createDeveloperMetadataFinder()DeveloperMetadataFinderBu sayfanın kapsamında geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür.
createTextFinder(findText)TextFinderSayfa için bir metin bulucu oluşturur. Bu metin bulucu, sayfadaki metinleri bulup değiştirebilir.
deleteColumn(columnPosition)SheetBelirtilen sütun konumundaki sütunu siler.
deleteColumns(columnPosition, howMany)voidBelirtilen sütun konumundan başlayarak belirli bir sayıda sütunu siler.
deleteRow(rowPosition)SheetBelirtilen satır konumundaki satırı siler.
deleteRows(rowPosition, howMany)voidBelirtilen satır konumundan başlayan sayıda satırı 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ğerlerini daraltır.
expandRowGroupsUpToDepth(groupDepth)SheetTüm satır gruplarını belirtilen derinliğe kadar genişletir ve diğerlerini daraltır.
getActiveCell()RangeBu sayfadaki etkin hücreyi döndürür.
getActiveRange()RangeEtkin sayfada seçilen aralığı veya etkin aralık yoksa null değerini döndürür.
getActiveRangeList()RangeListEtkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null değerini döndürür.
getBandings()Banding[]Bu sayfadaki tüm bantları döndürür.
getCharts()EmbeddedChart[]Bu sayfadaki bir grafik dizisini 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)IntegerBelirtilen dizindeki sütunun grup derinliğini döndürür.
getColumnWidth(columnPosition)IntegerBelirli bir sütunun genişliğini piksel olarak 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[]Sayfadaki bir dizi çizimi döndürür.
getFilter()FilterBu sayfadaki filtreyi veya filtre yoksa null değerini döndürür.
getFormUrl()StringYanıtlarını bu sayfaya gönderen formun URL'sini veya bu sayfanın ilişkilendirilmiş bir formu yoksa null değerini döndürür.
getFrozenColumns()IntegerDondurulmuş sütunların sayısını döndürür.
getFrozenRows()IntegerDondurulmuş satırların sayısını döndürür.
getImages()OverGridImage[]Sayfadaki tüm ızgara içi resimleri döndürür.
getIndex()IntegerSayfanın üst e-tablosundaki konumunu alır.
getLastColumn()Integerİçeriği olan son sütunun konumunu döndürür.
getLastRow()Integerİçeriği olan son satırın konumunu döndürür.
getMaxColumns()Integerİçerikten bağımsız olarak sayfadaki mevcut sütun sayısını döndürür.
getMaxRows()Integerİçerikten bağımsız olarak sayfadaki mevcut satır 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 korunan aralıkları temsil eden bir nesne dizisi veya sayfanın kendisindeki korumayı temsil eden tek öğeli bir dizi alır.
getRange(row, column)RangeVerilen koordinatlarda sol üstteki hücreyle aralığı döndürür.
getRange(row, column, numRows)RangeVerilen koordinatlarda sol üstteki hücreyle ve verilen satır sayısına sahip aralığı döndürür.
getRange(row, column, numRows, numColumns)RangeVerilen koordinatlarda, verilen satır ve sütun sayısı ile sol üstteki hücrenin bulunduğu aralığı döndürür.
getRange(a1Notation)RangeAralığı A1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi döndürür.
getRangeList(a1Notations)RangeListAynı sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür.
getRowGroup(rowIndex, groupDepth)GroupBelirtilen dizinde 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)IntegerBelirtilen dizindeki satırın grup derinliğini döndürür.
getRowHeight(rowPosition)IntegerBelirli bir 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[]Sayfadaki bir dilimleyici dizisini döndürür.
getTabColorObject()ColorSayfa sekme rengini alır. Sayfa sekmesinin rengi 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, aksi takdirde false değerini döndürür.
hideColumn(column)voidBelirli bir aralıktaki sütunu veya sütunları gizler.
hideColumns(columnIndex)voidBelirli bir dizindeki tek bir sütunu gizler.
hideColumns(columnIndex, numColumns)voidVerilen dizinden başlayan bir veya daha fazla ardışık sütunu gizler.
hideRow(row)voidVerilen aralıktaki satırları gizler.
hideRows(rowIndex)voidBelirtilen dizindeki satırı gizler.
hideRows(rowIndex, numRows)voidVerilen dizinden başlayan bir veya daha fazla ardışık satırı gizler.
hideSheet()SheetBu sayfayı gizler.
insertChart(chart)voidBu sayfaya yeni bir grafik ekler.
insertColumnAfter(afterPosition)SheetBelirtilen sütun konumundan sonra bir sütun ekler.
insertColumnBefore(beforePosition)SheetBelirtilen sütun konumundan önce bir sütun ekler.
insertColumns(columnIndex)voidBir sayfaya belirtilen konuma boş bir sütun ekler.
insertColumns(columnIndex, numColumns)voidBir sayfaya belirtilen konumdan başlayan bir veya daha fazla boş sütun ekler.
insertColumnsAfter(afterPosition, howMany)SheetBelirtilen sütun konumundan sonra belirtilen sayıda sütun ekler.
insertColumnsBefore(beforePosition, howMany)SheetBelirtilen sütun konumundan önce belirli sayıda sütun ekler.
insertImage(blobSource, column, row)OverGridImageDokümanda belirli bir satır ve sütunda resim olarak bir BlobSource ekler.
insertImage(blobSource, column, row, offsetX, offsetY)OverGridImageDokümanda belirli bir satır ve sütunda, piksel ofseti ile resim olarak BlobSource ekler.
insertImage(url, column, row)OverGridImageDokümana belirli bir satıra ve sütuna resim ekler.
insertImage(url, column, row, offsetX, offsetY)OverGridImageDokümanda belirli bir satır ve sütunda, piksel ofsetiyle bir resim ekler.
insertRowAfter(afterPosition)SheetBelirtilen satır konumundan sonra bir satır ekler.
insertRowBefore(beforePosition)SheetBelirtilen satır konumundan önce bir satır ekler.
insertRows(rowIndex)voidBir sayfaya belirtilen konumda boş bir satır ekler.
insertRows(rowIndex, numRows)voidBir sayfaya belirtilen konumdan başlayan bir veya daha fazla boş satır ekler.
insertRowsAfter(afterPosition, howMany)SheetBelirtilen satır konumundan sonraya belirli sayıda satır ekler.
insertRowsBefore(beforePosition, howMany)SheetBelirtilen satır konumundan önceye belirli sayıda 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 solaysa true değerini döndürür.
isRowHiddenByFilter(rowPosition)BooleanBelirli bir satırın bir filtre tarafından gizlenip gizlenmediğini döndürür (filtre görünümü değil).
isRowHiddenByUser(rowPosition)BooleanBelirli bir satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.
isSheetHidden()BooleanSayfa gizli durumdaysa true değerini döndürür.
moveColumns(columnSpec, destinationIndex)voidBelirli bir aralık tarafından seçilen sütunları, destinationIndex ile belirtilen konuma taşır.
moveRows(rowSpec, destinationIndex)voidBelirli bir 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 derleyici döndürür.
protect()ProtectionSayfayı izne sahip kullanıcılar dışında düzenlemeye karşı koruyabilecek bir nesne oluşturur.
removeChart(chart)voidÜst sayfadan bir grafiği kaldırır.
setActiveRange(range)RangeBelirtilen aralığı etkin sayfada active range olarak ayarlar ve aralıktaki sol üstteki hücre current cell olarak ayarlanır.
setActiveRangeList(rangeList)RangeListBelirtilen aralık listesini, etkin sayfada active ranges olarak ayarlar.
setActiveSelection(range)RangeBu sayfa için etkin seçim bölgesini ayarlar.
setActiveSelection(a1Notation)RangeEtkin seçimi, A1 gösteriminde veya R1C1 gösteriminde belirtildiği şekilde ayarlar.
setColumnGroupControlPosition(position)SheetSayfadaki sütun grubu denetimi açma/kapatma düğmesinin konumunu ayarlar.
setColumnWidth(columnPosition, width)SheetBelirli bir sütunun genişliğini piksel cinsinden ayarlar.
setColumnWidths(startColumn, numColumns, width)SheetBelirtilen 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)voidBelirli sayıda sütunu dondurur.
setFrozenRows(rows)voidBelirli sayıda satırı dondurur.
setHiddenGridlines(hideGridlines)SheetSayfa kılavuz çizgilerini gizler veya gösterir.
setName(name)SheetSayfa adını ayarlar.
setRightToLeft(rightToLeft)SheetSayfa düzenini sağdan sola olarak ayarlar veya ayarı iptal eder.
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)SheetVerilen satırların yüksekliğini piksel cinsinden ayarlar.
setRowHeightsForced(startRow, numRows, height)SheetVerilen satırların yüksekliğini piksel cinsinden ayarlar.
setTabColor(color)SheetSayfa sekme rengini ayarlar.
setTabColorObject(color)SheetSayfa sekme rengini ayarlar.
showColumns(columnIndex)voidBelirtilen dizindeki sütunu gösterir.
showColumns(columnIndex, numColumns)voidBelirtilen dizinden başlayarak ardışık bir veya daha fazla sütunu gösterir.
showRows(rowIndex)voidBelirtilen dizindeki satırı gösterir.
showRows(rowIndex, numRows)voidBelirtilen dizinden başlayarak ardışık bir veya daha fazla satırı gösterir.
showSheet()SheetSayfayı görünür yapar.
sort(columnPosition)SheetSayfayı sütuna göre artan düzende sıralar.
sort(columnPosition, ascending)SheetSayfayı sütuna göre sıralar.
unhideColumn(column)voidBelirtilen aralıktaki sütunu 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 sayfa kavramını değiştirir.

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


addDeveloperMetadata(key)

Belirtilen anahtarla birlikte 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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ükle birlikte 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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ğerle birlikte 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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ükle birlikte 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 en altına bir satır ekler. Bir hücrenin içeriği = ile başlıyorsa 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 açısından yararlı olan sayfa.

Yetkilendirme

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

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

asDataSourceSheet()

Sayfa türü SheetType.DATASOURCE ise DataSourceSheet, değilse 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: Veri kaynağı sayfası.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 sığacak ş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ırılacak sütunun konumu.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

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

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

autoResizeColumns(startColumn, numColumns)

Belirtilen sütun konumundan başlayan tüm sütunların genişliğini, içeriğine uyacak şekilde 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: Zincirleme için bu sayfa.

Yetkilendirme

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

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

autoResizeRows(startRow, numRows)

Belirli bir satır konumundan başlayarak tüm satırların yüksekliğini içeriklerini sığacak ş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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri 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çeneklerle belirtilen içindekiler 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
optionsObjectGelişmiş seçenekleri içeren ve aşağıda listelenen bir JavaScript haritası.

Gelişmiş parametreler

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

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

clearConditionalFormatRules()

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

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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: Zincirleme için bu sayfa.

Yetkilendirme

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

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

clearFormats()

İçerikleri korurken biçimlendirme sayfasını temizler.

Biçimlendirme, verilerin "Biçim" menüsündeki seçenekler tarafından izin verildiği şekilde (ör. kalın, italik, koşullu biçimlendirme) izin verilen şekilde biçimlendirilmesini ifade eder.

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

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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: Zincirleme için bu sayfa.

Yetkilendirme

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

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

copyTo(spreadsheet)

Sayfayı belirli bir e-tabloya kopyalar. Bu tablo, kaynakla aynı e-tablo olabilir. Kopyalanan sayfaya "[Orijinal ad] kopyası" adı verilir.

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, kaynakla aynı e-tablo olabilir).

Return

Sheet: Zincirleme için yeni sayfa.

Yetkilendirme

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

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

createDeveloperMetadataFinder()

Bu sayfanın kapsamında geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür. Meta veri, sayfanın kendisiyle ilişkilendirilmiş olması veya buradaki bir satır, sütun ya da aralıkla ilişkilendirilmesi durumunda belirli bir sayfanın kapsamındadır.

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

// Gets 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 kullanılan geliştirici meta veri bulucudur.


createTextFinder(findText)

Sayfa için bir metin bulucu oluşturur. Bu metin bulucu, sayfadaki metinleri 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
columnPositionIntegerİlk sütun için 1'den başlayarak sütunun konumu.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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şlayarak belirli bir sayıda 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

deleteRow(rowPosition)

Belirtilen 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
rowPositionIntegerİlk satır için 1'den başlayan satır konumu.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 sayıda satırı 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 kapsamların biri 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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ğerlerini 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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ğerlerini 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 olarak vurgulanmış hücreyi döndüren getCurrentCell() işlevinin kullanılması tercih edilir.

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

Return

Range - şu anki etkin hücre

Yetkilendirme

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

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

getActiveRange()

Etkin sayfada seçilen aralığı veya etkin aralık yoksa null değerini döndürür. Birden fazla aralık seçilirse bu yöntem yalnızca son seçilen aralığı döndürür.

"Etkin aralık" terimi kullanıcının etkin sayfada seçtiği aralığı, ancak özel bir işlevde etkin olarak yeniden hesaplanan hücreyi 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 kapsamların biri 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 değerini döndürür.

Tek bir aralık seçiliyse bu bir getActiveRange() çağrısı olarak 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 kapsamların biri 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 bantları döndürür.

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

// Gets 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getCharts()

Bu sayfadaki bir grafik dizisini 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[]: Grafikler dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 denetimi açma/kapatma anahtarının veya grup içindeki bir dizinin sütun dizini.
groupDepthIntegerGrubun derinliği.

Return

Group: Kontrol dizinindeki ve derinliğindeki sütun grubu ya da grup yoksa bir istisna atar.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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

GroupControlTogglePosition: Sütun gruplandırma kontrolü açma/kapatma düğmesi bu sayfadaki gruptan sonra gösteriliyorsa true, aksi halde false gösterilir.

Yetkilendirme

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

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

getColumnGroupDepth(columnIndex)

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

Grup derinliği, sütunla çakışan grup sayısını gösterir. Bu değer, sıfır ile sekiz arasında değişebilir.

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: Sütunun belirtilen dizindeki grup derinliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 genişliğini piksel olarak 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 kapsamların biri 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 kapsamların biri 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. Mevcut hücre, Google E-Tablolar kullanıcı arayüzünde odağı olan ve koyu bir kenarlıkla vurgulanmış hücredir. Hiçbir zaman birden fazla geçerli hücre olmaz. Kullanıcı bir veya daha fazla hücre aralığı seçtiğinde, seçimdeki hücrelerden biri geçerli hücre olur.

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 kapsamların biri 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 (Sheet.getLastColumn(), Sheet.getLastRow()) ile sınırlı bir Aralık oluşturmaya eşdeğerdir.

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 kapsamların biri 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 kapsamların biri 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 kapsamların biri 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 listesidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getDrawings()

Sayfadaki bir dizi çizimi 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 kapsamların biri 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getFormUrl()

Yanıtlarını bu sayfaya gönderen formun URL'sini veya bu sayfanın ilişkilendirilmiş bir formu yoksa null değerini döndürür.

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

Return

String: Yanıtlarını bu sayfaya yerleştiren formun URL'si veya bu sayfanın ilişkilendirilmiş bir formu yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getFrozenRows()

Dondurulmuş satırların 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getImages()

Sayfadaki tüm ızgara içi 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[]: Izgaradan bir dizi resim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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. 1'den başlıyor.

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-tablodaki konumudur.

Yetkilendirme

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

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

getLastColumn()

İçeriği olan 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getLastRow()

İçeriği olan 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getMaxColumns()

İçerikten 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getMaxRows()

İçerikten bağımsız olarak sayfadaki mevcut satır 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 kapsamların biri 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 kapsamların biri 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 adlandırılmış tüm aralıkların bir dizisi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getProtections(type)

Sayfadaki tüm korunan aralıkları temsil eden bir nesne dizisi veya sayfanın kendisindeki korumayı temsil eden tek öğeli bir dizi alır.

// 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 korunan aralıkları temsil eden bir nesne dizisi veya sayfanın kendisindeki korumayı temsil eden tek öğeli bir dizidir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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ücreyle 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 işlemi 1 ile başlar.
columnIntegerDöndürülecek hücrenin sütun dizini; sütun dizine ekleme işlemi 1 ile başlar.

Return

Range: Yalnızca bu hücreyi içeren aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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ücreyle ve verilen satır sayısına sahip aralığı döndürü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 dizinidir. Sütun dizine ekleme değeri 1 ile başlar.
numRowsIntegerDöndürülecek satır sayısı.

Return

Range: Belirtilen sayıda satır içeren tek bir veri sütunu içeren aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 satır ve sütun sayısı ile sol üstteki hücrenin bulunduğu aralığı döndürür.

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 dizinidir. Sütun dizine ekleme değeri 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getRange(a1Notation)

Aralığı A1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi 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 gösteriminde 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getRangeList(a1Notations)

Aynı sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür.

// 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österiminde veya R1C1 gösteriminde belirtildiği şekilde 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getRowGroup(rowIndex, groupDepth)

Belirtilen dizinde 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 denetimi açma/kapatma anahtarının satır dizini veya grup içindeki bir dizin.
groupDepthIntegerGrubun derinliği.

Return

Group: Kontrol dizinindeki ve derinliğindeki satır grubu veya grup yoksa bir istisna gönderir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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

GroupControlTogglePosition - Satır gruplandırma kontrolü açma/kapatma düğmesi bu sayfadaki gruptan sonra gösteriliyorsa true, aksi halde false gösteriliyorsa.

Yetkilendirme

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

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

getRowGroupDepth(rowIndex)

Belirtilen 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 ile sekiz arasında değişebilir.

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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getRowHeight(rowPosition)

Belirli bir 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 kapsamların biri 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 — mevcut seçim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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, sayfa oluşturma zamanında atanan, sayfa konumundan bağımsız olan monoton olarak artan bir tam sayıdır. Bu, Sheet örneği yerine gridId parametresini alan Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd) gibi yöntemlerle birlikte yararlıdır.

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

Logger.log(sheet.getSheetId());

Return

Integer: E-tabloya özgü sayfanın kimliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri 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. Satır veya sütun konumu olarak verilen -1 değeri, sayfada veri bulunan en son satırı veya sütunu almaya eş değerdir.

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 değerler dizisi

Yetkilendirme

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

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

getSlicers()

Sayfadaki bir dilimleyici 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 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getTabColorObject()

Sayfa sekme rengini alır. Sayfa sekmesinin rengi 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 sekme rengi veya sayfa sekmesinin rengi yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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. EmbeddedChart gibi tek bir yerleştirilmiş nesne içeren sayfa, 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 kapsamların biri 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, aksi takdirde false değerini döndürür. Kılavuz çizgileri varsayılan olarak görünürdü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 halde false.

Yetkilendirme

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

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

hideColumn(column)

Belirli bir 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

hideColumns(columnIndex)

Belirli bir dizindeki tek bir sütunu gizler. Bu yöntem için 1 dizini kullanın.

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

Bir 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

hideColumns(columnIndex, numColumns)

Verilen dizinden başlayan bir veya daha fazla ardışık sütunu gizler. Bu yöntem için 1 dizini 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

hideRow(row)

Verilen 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 kapsamların biri 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

hideRows(rowIndex, numRows)

Verilen dizinden başlayan 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 kapsamların biri 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 gizlenmişse herhangi bir etkisi yoktur. Bu yöntem görünür tek sayfada çağrılırsa bir istisnaya neden olur.

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

Return

Sheet: Geçerli sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

insertColumnAfter(afterPosition)

Belirtilen 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
afterPositionIntegerYeni sütunun ekleneceği sütundur.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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
beforePositionIntegerÖnüne yeni sütunun ekleneceği sütun.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

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

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

insertColumns(columnIndex)

Bir sayfaya 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

insertColumns(columnIndex, numColumns)

Bir sayfaya belirtilen konumdan başlayan bir veya daha fazla 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

insertColumnsAfter(afterPosition, howMany)

Belirtilen sütun konumundan sonra belirtilen 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
afterPositionIntegerYeni sütunun ekleneceği sütundur.
howManyIntegerEklenecek sütun sayısı.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 belirli 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
beforePositionIntegerÖnüne yeni sütunun ekleneceği sütun.
howManyIntegerEklenecek sütun sayısı.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

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

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

insertImage(blobSource, column, row)

Dokümanda belirli bir satır ve sütunda resim olarak bir 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 kapsamların biri 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)

Dokümanda belirli bir satır ve sütunda, piksel ofseti ile 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, 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.
offsetYIntegerHücre köşesinden dikey ofsetin piksel cinsinden değeri.

Return

OverGridImage: Eklenen resim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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ıra ve sütuna 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 kapsamların biri 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)

Dokümanda belirli bir satır ve sütunda, piksel ofsetiyle bir 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, 10, 10);

Parametreler

AdTürAçıklama
urlStringGörselin URL'si.
columnIntegerSütun konumu.
rowIntegerSatır konumu.
offsetXIntegerHücre köşesinden yatay uzaklık.
offsetYIntegerHücre köşesinden dikey ofsetin piksel cinsinden değeri.

Return

OverGridImage — Eklenen resim.

Yetkilendirme

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

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

insertRowAfter(afterPosition)

Belirtilen 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
afterPositionIntegerYeni satırın ekleneceği satır.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

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

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

insertRowBefore(beforePosition)

Belirtilen 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
beforePositionIntegerÖnüne yeni satırın eklenmesi gereken satır.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

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

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

insertRows(rowIndex)

Bir sayfaya belirtilen konumda 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

insertRows(rowIndex, numRows)

Bir sayfaya belirtilen konumdan başlayan bir veya daha fazla 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 kapsamların biri 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 sonraya belirli sayıda 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: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

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

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

insertRowsBefore(beforePosition, howMany)

Belirtilen satır konumundan önceye belirli sayıda 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
beforePositionIntegerÖnüne yeni satır eklenmesi gereken satır.
howManyIntegerEklenecek satır sayısı.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 sabitlenmiştir.
anchorColPosIntegerDilimleyicinin üst tarafı bu sütuna sabitlenmiştir.

Return

Slicer: Yeni eklenen dilimleyici.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 sabitlenmiştir.
anchorColPosIntegerDilimleyicinin üst tarafı bu sütuna sabitlenmiştir.
offsetXIntegerHücre köşesinden yatay uzaklık.
offsetYIntegerHücre köşesinden dikey ofsetin piksel cinsinden değeri.

Return

Slicer: Yeni eklenen dilimleyici.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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, aksi takdirde false değerini alır.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 solaysa true değerini döndürür. Sayfa varsayılan soldan sağa düzeni kullanıyorsa false değerini döndürür.

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

// Gets 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 halde false.

Yetkilendirme

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

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

isRowHiddenByFilter(rowPosition)

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

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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

isRowHiddenByUser(rowPosition)

Belirli bir 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

isSheetHidden()

Sayfa gizli durumdaysa true değerini döndürür.

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

Return

Boolean — Sayfa gizliyse true, değilse false.

Yetkilendirme

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

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

moveColumns(columnSpec, destinationIndex)

Belirli bir aralık tarafından seçilen sütunları, destinationIndex ile belirtilen konuma taşır. columnSpec öğesinin, taşınacak bir sütunun veya sütun grubunun tamamını tam olarak temsil etmesi gerekmez. 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 bir aralık.
destinationIndexIntegerSütunların taşınması gereken dizin. Bu dizinin, sütunlar taşınmadan önceki koordinatları temel aldığını unutmayın. Kaynak sütunlar tablodan kaldırılırken, taşınan sütunlara yer açmak için mevcut veriler sağa kaydırılır. Bu nedenle, veriler başlangıçta belirtilenden farklı bir dizine eklenmiş olabilir.

Yetkilendirme

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

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

moveRows(rowSpec, destinationIndex)

Belirli bir aralık tarafından seçilen satırları, destinationIndex ile belirtilen konuma taşır. rowSpec öğesinin, taşınacak bir satırın tamamını veya satır grubunu tam olarak temsil etmesi gerekmez. 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 bir aralık.
destinationIndexIntegerSatırların taşınması gereken dizin. Bu dizinin, satırlar taşınmadan önceki koordinatları temel aldığını unutmayın. Kaynak satırlar tablodan kaldırılırken, taşınan satırlara yer açmak için mevcut veriler aşağı kaydırılır. Bu nedenle, veriler başlangıçta belirtilenden farklı bir dizine eklenmiş olabilir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 derleyici 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 oluşturucu.


protect()

Sayfayı izne sahip kullanıcılar dışında düzenlemeye karşı koruyabilecek bir nesne oluşturur. Komut dosyası 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) yöntemini çağırarak ya da Protection.setDomainEdit(editable) için yeni bir değer belirleyerek) izinler, e-tablonun kendisini yansıtır. Bu, sayfanın etkin şekilde korunmadığı anlamına gelir. Sayfa zaten korunuyorsa bu yöntem mevcut koruma ayarlarını temsil eden bir nesne döndürür. Korunan bir sayfa, 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

removeChart(chart)

Üst sayfadan bir grafiği 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 kapsamların biri 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 aralıktaki sol üstteki hücre current cell olarak ayarlanır.

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 etkinleştirilen aralık

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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, etkin sayfada active ranges olarak ayarlar. Listedeki son aralık active range olarak ayarlanmıştır.

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 kapsamların biri 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 etkinleştirilen aralık

Yetkilendirme

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

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

setActiveSelection(a1Notation)

Etkin seçimi, A1 gösteriminde veya R1C1 gösteriminde belirtildiği şekilde ayarlar.

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

sheet.setActiveSelection("A1:D4");

Parametreler

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

Return

Range — yeni etkinleştirilen aralık

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 denetimi 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 denetimi açma/kapatma düğmesinin konumu.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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.
widthIntegerAyarlanacak genişlik (piksel cinsinden).

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

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

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

setColumnWidths(startColumn, numColumns, width)

Belirtilen 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ı.
widthIntegerAyarlanacak genişlik (piksel cinsinden).

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri 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 zaten seçili olan bir aralıkta bulunuyorsa bu aralık, geçerli hücre olarak hücreyle etkin aralık haline gelir.

Belirtilen hücre seçilen herhangi bir aralıkta yer almıyorsa mevcut seçim kaldırılır ve hücre, geçerli hücre ve etkin aralık olur.

Not: Belirtilen Range bir hücreden oluşmalıdır, aksi takdirde bir istisnaya neden olur.

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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setFrozenColumns(columns)

Belirli sayıda sütunu dondurur. Sıfırsa 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setFrozenRows(rows)

Belirli sayıda satırı dondurur. Sıfırsa 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 kapsamların biri 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 gösterir.

// 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 kılavuz çizgilerini gösterin.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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ı iptal eder.

// 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 değeri için sayfa düzeni sağdan sola doğru ayarlanır ve A1 hücresi sağ üst köşede yer alır. false değeri ayarlanırsa sayfa düzeni, A1 hücresi sol üstte olacak şekilde varsayılan soldan sağa ayarlanır.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 denetimi açma/kapatma düğmesinin konumu.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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. 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 piksel cinsinden yükseklik.

Return

Sheet: Yöntem zinciri açısından yararlı olan sayfa.

Yetkilendirme

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

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

setRowHeights(startRow, numRows, height)

Verilen 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. 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 piksel cinsinden yükseklik.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

setRowHeightsForced(startRow, numRows, height)

Verilen 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. setRowHeightsForced kullandığınızda, hücre içerikleri satır yüksekliğinden daha uzun olsa bile satırlar belirtilen yüksekliğe zorlanır.

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 piksel cinsinden yükseklik.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

setTabColor(color)

Sayfa sekme 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 ('#ffffff' veya 'white' gibi) ya da sekme rengini sıfırlamak için null.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

setTabColorObject(color)

Sayfa sekme 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: Zincirleme için bu sayfa.

Yetkilendirme

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

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

showColumns(columnIndex)

Belirtilen dizindeki sütunu 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 kapsamların biri 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 ardışık bir veya daha fazla 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 kapsamların biri 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 kapsamların biri 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 ardışık bir veya daha fazla 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 kapsamların biri 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 yapar. Sayfa zaten görünür durumdaysa herhangi bir etkisi yoktur.

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

Return

Sheet: Geçerli sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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üzende belirtilecek 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: Yöntem zinciri açısından yararlı olan sayfa

Yetkilendirme

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

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

unhideColumn(column)

Belirtilen aralıktaki sütunu 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
columnRangeGizlenmişse gösterilecek aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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
rowRangeGizlenmişse gösterilecek aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

Kullanımdan kaldırılan yöntemler