Class Sheet

Sayfa

E-tablo sayfalarına erişebilir ve bu sayfaları değiştirebilirsiniz. Sık kullanılan işlemler arasında bir e-tablonun adını değiştirme ve e-tablodaki aralık nesnelerine erişme yer alır.

Yöntemler

YöntemDönüş türüKısa açıklama
activate()SheetBu sayfayı etkinleştirir.
addDeveloperMetadata(key)SheetBelirtilen anahtarla geliştirici meta verilerini sayfaya ekler.
addDeveloperMetadata(key, visibility)SheetE-tabloya, belirtilen anahtar ve görünürlükle geliştirici meta verileri ekler.
addDeveloperMetadata(key, value)SheetE-tabloya, belirtilen anahtar ve değere sahip geliştirici meta verilerini ekler.
addDeveloperMetadata(key, value, visibility)SheetBelirtilen anahtar, değer ve görünürlükle geliştirici meta verilerini sayfaya ekler.
appendRow(rowContents)SheetSayfadaki geçerli veri bölgesinin altına bir satır ekler.
asDataSourceSheet()DataSourceSheetSayfa SheetType.DATASOURCE türüne sahipse sayfayı DataSourceSheet olarak, aksi takdirde null olarak döndürür.
autoResizeColumn(columnPosition)SheetBelirtilen sütunun genişliğini içeriğine sığacak şekilde ayarlar.
autoResizeColumns(startColumn, numColumns)SheetBelirtilen sütun konumundan itibaren tüm sütunların genişliğini, içeriklerine sığacak şekilde ayarlar.
autoResizeRows(startRow, numRows)SheetBelirtilen satır konumundan itibaren tüm satırların yüksekliğini, içeriklerine sığacak şekilde ayarlar.
clear()SheetSayfayı içerik ve biçimlendirme bilgilerinden temizler.
clear(options)SheetBelirtilen gelişmiş seçeneklerle belirtildiği şekilde sayfayı içeriklerden ve/veya biçiminden temizler.
clearConditionalFormatRules()voidE-tablodaki tüm koşullu biçimlendirme kurallarını kaldırır.
clearContents()Sheetİçerik sayfasını temizler ancak biçimlendirme bilgilerini korur.
clearFormats()Sheetİçeriği koruyarak sayfayı biçimlendirmeden temizler.
clearNotes()SheetSayfayı tüm notlardan temizler.
collapseAllColumnGroups()SheetSayfadaki tüm sütun gruplarını daraltır.
collapseAllRowGroups()SheetSayfadaki tüm satır gruplarını daraltır.
copyTo(spreadsheet)SheetSayfayı, kaynakla aynı e-tablo da dahil olmak üzere belirli bir e-tabloya kopyalar.
createDeveloperMetadataFinder()DeveloperMetadataFinderBu sayfanın kapsamında geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür.
createTextFinder(findText)TextFinderE-tablo için bir metin bulucu oluşturur. Bu metin bulucu, e-tablodaki metinleri bulup değiştirebilir.
deleteColumn(columnPosition)SheetBelirtilen sütun konumundaki sütunu siler.
deleteColumns(columnPosition, howMany)voidBelirtilen sütun konumundan itibaren belirli sayıda sütunu siler.
deleteRow(rowPosition)SheetBelirtilen satır konumundaki satırı siler.
deleteRows(rowPosition, howMany)voidBelirtilen satır konumundan itibaren belirli 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)SheetBelirtilen derinliğe kadar tüm sütun gruplarını genişletir ve diğer tüm grupları daraltır.
expandRowGroupsUpToDepth(groupDepth)SheetBelirtilen derinliğe kadar tüm satır gruplarını genişletir ve diğer tüm grupları daraltır.
getActiveCell()RangeBu sayfadaki etkin hücreyi döndürür.
getActiveRange()RangeEtkin sayfadaki seçili aralığı veya etkin bir aralık yoksa null değerini döndürür.
getActiveRangeList()RangeListEtkin e-tablodaki 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 grafik dizisini döndürür.
getColumnGroup(columnIndex, groupDepth)GroupBelirtilen dizinde 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)IntegerBelirtilen sütunun piksel cinsinden genişliğini alır.
getConditionalFormatRules()ConditionalFormatRule[]Bu e-tablodaki tüm koşullu biçimlendirme 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 çizimler dizisini 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 döndürür veya bu sayfayla ilişkili bir form yoksa null değerini döndürür.
getFrozenColumns()IntegerDondurulmuş sütun sayısını döndürür.
getFrozenRows()IntegerDondurulmuş satır sayısını döndürür.
getImages()OverGridImage[]Sayfadaki tüm ızgara dışı 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İçeriğe bakılmaksızın sayfadaki mevcut sütun sayısını döndürür.
getMaxRows()Integerİçeriğe bakılmaksızın sayfadaki mevcut satır sayısını döndürür.
getName()StringE-tablonun 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 öğesini döndürür.
getPivotTables()PivotTable[]Bu sayfadaki tüm pivot tabloları döndürür.
getProtections(type)Protection[]Sayfadaki tüm korumalı aralıkları temsil eden bir nesne dizisi veya sayfadaki korumayı temsil eden tek öğeli bir dizi alır.
getRange(row, column)RangeBelirtilen koordinatlarda sol üst hücreyi içeren aralığı döndürür.
getRange(row, column, numRows)RangeBelirtilen koordinatlarda sol üst hücreyi ve belirtilen satır sayısını içeren aralığı döndürür.
getRange(row, column, numRows, numColumns)RangeBelirli satır ve sütun sayısına sahip, belirli koordinatlarda sol üst hücreyi içeren aralığı döndürür.
getRange(a1Notation)RangeA1 notasyonunda veya R1C1 notasyonunda belirtilen aralığı döndürür.
getRangeList(a1Notations)RangeListBoş olmayan bir A1 veya R1C1 notasyonu listesi tarafından belirtilen aynı 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()GroupControlTogglePositionE-tablodaki 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)IntegerBelirtilen satırın piksel cinsinden yüksekliğini alır.
getSelection()SelectionE-tablodaki geçerli Selection değerini döndürür.
getSheetId()IntegerBu nesne tarafından temsil edilen sayfanın kimliğini döndürür.
getSheetName()StringE-tablo adını döndürür.
getSheetValues(startRow, startColumn, numRows, numColumns)Object[][]Belirtilen koordinatlardan başlayarak bu aralık için dikdörtgen bir değer ızgarası döndürür.
getSlicers()Slicer[]Sayfadaki bir dilimleyici dizisi döndürür.
getTabColorObject()ColorSayfa sekmesi rengini veya sayfa sekmesinde renk yoksa null değerini alır.
getType()SheetTypeE-tablonun türünü döndürür.
hasHiddenGridlines()BooleanSayfanın ızgara çizgileri gizliyse true, aksi takdirde false döndürülür.
hideColumn(column)voidBelirli aralıktaki sütunu veya sütunları gizler.
hideColumns(columnIndex)voidBelirtilen dizindeki tek bir sütunu gizler.
hideColumns(columnIndex, numColumns)voidBelirtilen dizinden itibaren bir veya daha fazla sütunu gizler.
hideRow(row)voidBelirtilen aralıktaki satırları gizler.
hideRows(rowIndex)voidBelirtilen dizindeki satırı gizler.
hideRows(rowIndex, numRows)voidBelirtilen dizinden itibaren bir veya daha fazla art arda gelen 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)voidSayfada belirtilen konuma boş bir sütun ekler.
insertColumns(columnIndex, numColumns)voidBelirtilen konumdan itibaren bir sayfada bir veya daha fazla art arda boş sütun ekler.
insertColumnsAfter(afterPosition, howMany)SheetBelirtilen sütun konumundan sonra belirli sayıda sütun ekler.
insertColumnsBefore(beforePosition, howMany)SheetBelirtilen sütun konumundan önce bir dizi sütun ekler.
insertImage(blobSource, column, row)OverGridImageDokümana belirli bir satır ve sütunda resim olarak BlobSource ekler.
insertImage(blobSource, column, row, offsetX, offsetY)OverGridImageBelirli bir satır ve sütuna, piksel kaydırması ile dokümana resim olarak bir BlobSource ekler.
insertImage(url, column, row)OverGridImageDokümana belirli bir satır ve sütuna resim ekler.
insertImage(url, column, row, offsetX, offsetY)OverGridImageDokümana, belirli bir satır ve sütunda piksel kaydırmayla 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)voidBelirtilen konumda bir sayfaya boş bir satır ekler.
insertRows(rowIndex, numRows)voidBelirtilen konumdan itibaren bir sayfaya art arda bir veya daha fazla boş satır ekler.
insertRowsAfter(afterPosition, howMany)SheetBelirtilen satır konumundan sonra bir dizi satır ekler.
insertRowsBefore(beforePosition, howMany)SheetBelirtilen satır konumundan önce bir dizi satır ekler.
insertSlicer(range, anchorRowPos, anchorColPos)SlicerBu sayfaya yeni bir dilimleyici ekler.
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)SlicerBu sayfaya yeni bir dilimleyici ekler.
isColumnHiddenByUser(columnPosition)BooleanBelirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.
isRightToLeft()BooleanBu sayfa düzeni sağdan sola ise true değerini döndürür.
isRowHiddenByFilter(rowPosition)BooleanBelirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür.
isRowHiddenByUser(rowPosition)BooleanBelirtilen satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.
isSheetHidden()BooleanSayfa şu anda gizliyse true değerini döndürür.
moveColumns(columnSpec, destinationIndex)voidBelirtilen aralık tarafından seçilen sütunları destinationIndex ile belirtilen konuma taşır.
moveRows(rowSpec, destinationIndex)voidBelirtilen aralık tarafından seçilen satırları destinationIndex ile belirtilen konuma taşır.
newChart()EmbeddedChartBuilderBu e-tablo için yeni bir grafik oluşturmak üzere bir oluşturucu döndürür.
protect()Protectionİzin sahibi kullanıcılar dışındaki kullanıcıların sayfayı düzenlemesini engelleyebilecek bir nesne oluşturur.
removeChart(chart)voidGrafiği ana sayfadan kaldırır.
setActiveRange(range)RangeBelirtilen aralığı etkin sayfada active range olarak ayarlar. Bu aralığın sol üst hücresi current cell olur.
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 notasyonunda veya R1C1 notasyonunda belirtildiği şekilde ayarlar.
setColumnGroupControlPosition(position)SheetSayfadaki sütun grubu denetimi açma/kapatma düğmesinin konumunu ayarlar.
setColumnWidth(columnPosition, width)SheetBelirtilen sütunun genişliğini piksel cinsinden ayarlar.
setColumnWidths(startColumn, numColumns, width)SheetBelirtilen sütunların genişliğini piksel cinsinden ayarlar.
setConditionalFormatRules(rules)voidSayfada şu anda mevcut olan tüm koşullu biçimlendirme 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)voidBelirtilen sayıda satırı dondurur.
setHiddenGridlines(hideGridlines)SheetSayfa kılavuz çizgilerini gizler veya gösterir.
setName(name)SheetE-tablo adını belirler.
setRightToLeft(rightToLeft)SheetSayfa düzenini sağdan sola olarak ayarlar veya ayarı kaldırır.
setRowGroupControlPosition(position)SheetSatır grubu denetimi açma/kapatma düğmesinin sayfadaki konumunu ayarlar.
setRowHeight(rowPosition, height)SheetBelirtilen satırın piksel cinsinden satır yüksekliğini ayarlar.
setRowHeights(startRow, numRows, height)SheetBelirtilen satırların piksel cinsinden yüksekliğini ayarlar.
setRowHeightsForced(startRow, numRows, height)SheetBelirtilen satırların piksel cinsinden yüksekliğini ayarlar.
setTabColor(color)SheetE-tablo sekmesi rengini ayarlar.
setTabColorObject(color)SheetE-tablo sekmesi rengini ayarlar.
showColumns(columnIndex)voidBelirtilen dizindeki sütunu görünür hale getirir.
showColumns(columnIndex, numColumns)voidBelirtilen dizinden itibaren bir veya daha fazla sütunu görünür hale getirir.
showRows(rowIndex)voidBelirtilen dizindeki satırı görünür hale getirir.
showRows(rowIndex, numRows)voidBelirtilen dizinden itibaren bir veya daha fazla art arda gelen satırı gizler.
showSheet()SheetE-tabloyu görünür yapar.
sort(columnPosition)SheetBir sayfayı sütuna göre artan düzende sıralar.
sort(columnPosition, ascending)SheetBir sayfayı sütuna göre sıralar.
unhideColumn(column)voidBelirtilen aralıktaki sütunu gösterir.
unhideRow(row)voidBelirtilen aralıktaki satırı gösterir.
updateChart(chart)voidBu sayfadaki grafiği günceller.

Ayrıntılı dokümanlar

activate()

Bu sayfayı etkinleştirir. E-tablonun kendisini değil, yalnızca üst öğenin etkin e-tabloyla ilgili fikrini değiştirir.

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

Return

Sheet: Yeni etkin sayfa.


addDeveloperMetadata(key)

Belirtilen anahtarla geliştirici meta verilerini sayfaya ekler.

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

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

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

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

Parametreler

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

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

addDeveloperMetadata(key, visibility)

E-tabloya, belirtilen anahtar ve görünürlükle geliştirici meta verileri 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 verisinin görünürlüğü.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

addDeveloperMetadata(key, value)

E-tabloya, belirtilen anahtar ve değere sahip geliştirici meta verilerini 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 verisinin değeri.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

addDeveloperMetadata(key, value, visibility)

Belirtilen anahtar, değer ve görünürlükle 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 verisinin değeri.
visibilityDeveloperMetadataVisibilityYeni geliştirici meta verisinin görünürlüğü.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

appendRow(rowContents)

Sayfadaki geçerli veri bölgesinin altına bir satır ekler. Bir hücrenin içeriği = ile başlıyorsa formül olarak yorumlanır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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[]E-tablodaki son satırdan sonra eklenecek bir değer dizisi.

Return

Sheet: Yöntem zincirleme için yararlı olan sayfa.

Yetkilendirme

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

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

asDataSourceSheet()

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

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

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

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

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

Return

DataSourceSheet: Veri kaynağı sayfası.

Yetkilendirme

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

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

autoResizeColumn(columnPosition)

Belirtilen sütunun genişliğini içeriğine sığacak şekilde ayarlar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

autoResizeColumns(startColumn, numColumns)

Belirtilen sütun konumundan itibaren tüm sütunların genişliğini, içeriklerine sığacak şekilde ayarlar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

autoResizeRows(startRow, numRows)

Belirtilen satır konumundan itibaren tüm satırların yüksekliğini içeriklerine sığacak şekilde ayarlar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

clear()

Sayfayı içerik ve biçimlendirme bilgilerinden temizler.

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

Return

Sheet: Temizlenmiş sayfa.

Yetkilendirme

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

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

clear(options)

Belirtilen gelişmiş seçeneklerle belirtildiği şekilde sayfayı içeriklerden ve/veya biçiminden temizler.

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

Parametreler

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

Gelişmiş parametreler

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

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

clearConditionalFormatRules()

E-tablodaki tüm koşullu biçimlendirme kurallarını kaldırır. Giriş olarak boş bir dizi ile setConditionalFormatRules(rules) işlevini çağırmaya eşdeğerdir.

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

Yetkilendirme

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

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

clearContents()

İçerik sayfasını temizler ancak biçimlendirme bilgilerini korur.

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

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

clearFormats()

İçeriği koruyarak sayfayı biçimlendirmeden temizler.

Biçimlendirme, hücrelerin genişliği veya yüksekliği değil, verilerin "Biçim" menüsündeki seçeneklere göre nasıl biçimlendirildiğini ifade eder (ör. kalın, italik, koşullu biçimlendirme).

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

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

clearNotes()

Sayfayı tüm notlardan temizler.

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

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

collapseAllColumnGroups()

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

const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

collapseAllRowGroups()

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

const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

copyTo(spreadsheet)

Sayfayı, kaynakla aynı e-tablo da dahil olmak üzere belirli bir e-tabloya kopyalar. Kopyalanan sayfanın adı "[orijinal ad] kopyası" olur.

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

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

Parametreler

AdTürAçıklama
spreadsheetSpreadsheetBu sayfanın kopyalanacağı e-tablo. Kaynakla aynı e-tablo olabilir.

Return

Sheet: Zincirleme için yeni e-tablo.

Yetkilendirme

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

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

createDeveloperMetadataFinder()

Bu sayfanın kapsamında geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür. Meta veriler, sayfanın kendisiyle veya sayfadaki bir satır, sütun ya da aralıkla ilişkilendirilmişse 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 arayan bir geliştirici meta veri bulucusu.


createTextFinder(findText)

E-tablo için bir metin bulucu oluşturur. Bu metin bulucu, e-tablodaki metinleri bulup değiştirebilir.

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

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

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

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

Parametreler

AdTürAçıklama
findTextStringAranacak metin.

Return

TextFinder: E-tablonun TextFinder değeri.


deleteColumn(columnPosition)

Belirtilen sütun konumundaki sütunu siler.

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

Parametreler

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

Return

Sheet: yöntem zincirleme için yararlı olan sayfa

Yetkilendirme

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

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

deleteColumns(columnPosition, howMany)

Belirtilen sütun konumundan itibaren belirli sayıda sütunu siler.

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

Parametreler

AdTürAçıklama
columnPositionIntegerSilecek ilk sütunun konumu.
howManyIntegerSililecek sütunların sayısı.

Yetkilendirme

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

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

deleteRow(rowPosition)

Belirtilen satır konumundaki satırı siler.

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

Parametreler

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

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

deleteRows(rowPosition, howMany)

Belirtilen satır konumundan itibaren belirli sayıda satırı siler.

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

Parametreler

AdTürAçıklama
rowPositionIntegerSilecek ilk satırın konumu.
howManyIntegerSilinecek satır sayısı.

Yetkilendirme

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

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

expandAllColumnGroups()

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

const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

expandAllRowGroups()

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

const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

expandColumnGroupsUpToDepth(groupDepth)

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

const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

expandRowGroupsUpToDepth(groupDepth)

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

const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getActiveCell()

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

Not: Vurgulanan mevcut hücreyi döndüren getCurrentCell() işlevinin kullanılması tercih edilir.

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

Return

Range: Geçerli etkin hücre

Yetkilendirme

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

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

getActiveRange()

Etkin sayfadaki seçili aralığı veya etkin bir 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ığı ifade eder ancak özel işlevlerde etkin olarak yeniden hesaplanan hücreyi ifade eder.

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

Return

Range: Etkin aralık

Yetkilendirme

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

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

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


getActiveRangeList()

Etkin e-tablodaki etkin aralıkların listesini veya etkin aralık yoksa null değerini döndürür.

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

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

Return

RangeList: Etkin aralıkların listesi

Yetkilendirme

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

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

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 e-tablodaki tüm bantlar.

Yetkilendirme

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

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

getCharts()

Bu sayfadaki grafik dizisini döndürür.

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

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

Return

EmbeddedChart[]: Grafik dizisi.

Yetkilendirme

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

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

getColumnGroup(columnIndex, groupDepth)

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

const 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.
const columnGroup = sheet.getColumnGroup(2, 1);

Parametreler

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

Return

Group: Kontrol dizini ve derinliğindeki sütun grubudur veya grup mevcut değilse istisna atar.

Yetkilendirme

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

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

getColumnGroupControlPosition()

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

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

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

Return

GroupControlTogglePosition: Sütun gruplandırma kontrol düğmesi bu sayfadaki grubun ardından gösteriliyorsa true, aksi takdirde false değerini alır.

Yetkilendirme

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

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

getColumnGroupDepth(columnIndex)

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

Grup derinliği, sütunla kaç grubun örtüştüğünü gösterir. Bu değer sıfır ile sekiz arasında olabilir.

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

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

Parametreler

AdTürAçıklama
columnIndexIntegerSütunun dizini.

Return

Integer: Belirtilen dizindeki sütunun grup derinliği.

Yetkilendirme

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

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

getColumnWidth(columnPosition)

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

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

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

Parametreler

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

Return

Integer: sütun genişliği (piksel cinsinden)

Yetkilendirme

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

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

getConditionalFormatRules()

Bu e-tablodaki tüm koşullu biçimlendirme kurallarını alın.

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

Return

ConditionalFormatRule[]: Sayfadaki tüm kuralların dizisi.

Yetkilendirme

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

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

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 odak noktasında olan ve koyu kenarlıkla vurgulanan hücredir. Hiçbir zaman birden fazla geçerli hücre yoktur. Kullanıcı bir veya daha fazla hücre aralığı seçtiğinde, seçimdeki hücrelerden biri geçerli hücre olur.

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

Return

Range: Geçerli hücre

Yetkilendirme

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

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

getDataRange()

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

Bu, işlevsel olarak A1 ile (Sayfa.SonSütunu(), Sayfa.SonSatırı()) arasında sınırlanmış bir aralık oluşturmaya eşdeğerdir.

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

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

// This logs the spreadsheet in CSV format with a trailing comma
for (let i = 0; i < values.length; i++) {
  let row = '';
  for (let 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 verilerden oluşan bir aralık

Yetkilendirme

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

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

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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataSourcePivotTables()

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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDataSourceTables()

Tüm veri kaynağı tablolarını alır.

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

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

// Gets an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].getStatus().getLastExecutionTime());

Return

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

Yetkilendirme

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

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

getDeveloperMetadata()

Bu 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getDrawings()

Sayfadaki çizimler dizisini döndürür.

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

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

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

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

Return

Drawing[]: Bu sayfadaki çizimlerin listesi.

Yetkilendirme

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

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

getFilter()

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

// Gets the filter on the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();

Return

Filter: Filtre.

Yetkilendirme

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

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

getFormUrl()

Yanıtlarını bu sayfaya gönderen formun URL'sini döndürür veya bu sayfayla ilişkili bir form yoksa null değerini döndürür. Kullanıcının e-tabloyu düzenleme izni yoksa istisna oluşturur.

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

Return

String: Yanıtlarını bu sayfaya yerleştiren formun URL'si veya bu sayfayla ilişkili bir form yoksa null.

Yetkilendirme

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

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

getFrozenColumns()

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFrozenRows()

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

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

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

Return

Integer: Dondurulmuş satır sayısı

Yetkilendirme

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

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

getImages()

Sayfadaki tüm ızgara dışı resimleri döndürür.

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

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

// Gets the over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use
// ss.getImages() instead.
const images = sheet.getImages();

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

Return

OverGridImage[]: Kılavuz üzeri resim dizisi.

Yetkilendirme

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

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

getIndex()

Sayfanın, üst e-tablosundaki konumunu alır. 1'den başlar.

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

Return

Integer: Sayfanın, üst e-tablosundaki konumu.

Yetkilendirme

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

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

getLastColumn()

İçeriği olan son sütunun konumunu döndürür.

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

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

Return

Integer: E-tablonun içerik içeren son sütunu

Yetkilendirme

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

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

getLastRow()

İçeriği olan son satırın konumunu döndürür.

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

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

Return

Integer: E-tablonun içerik içeren son satırı

Yetkilendirme

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

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

getMaxColumns()

İçeriğe bakılmaksızın sayfadaki mevcut sütun sayısını döndürür.

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

Return

Integer: E-tablonun maksimum genişliği.

Yetkilendirme

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

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

getMaxRows()

İçeriğe bakılmaksızın sayfadaki mevcut satır sayısını döndürür.

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

Return

Integer: E-tablonun maksimum yüksekliği.

Yetkilendirme

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

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

getName()

E-tablonun adını döndürür.

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

Return

String: E-tablonun adı.

Yetkilendirme

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

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

getNamedRanges()

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

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

Return

NamedRange[]: Sayfadaki tüm adlandırılmış aralıkların dizisi.

Yetkilendirme

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

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

getParent()

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

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

Return

Spreadsheet: Ana e-tablo.

Yetkilendirme

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

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

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 sayfada bulunan pivot tablolar.

Yetkilendirme

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

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

getProtections(type)

Sayfadaki tüm korumalı aralıkları temsil eden bir nesne dizisi veya sayfadaki korumayı temsil eden tek öğeli bir dizi alır.

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

Parametreler

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

Return

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

Yetkilendirme

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

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

getRange(row, column)

Belirtilen koordinatlarda sol üst hücrenin bulunduğu aralığı döndürür.

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

Parametreler

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

Return

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

Yetkilendirme

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

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

getRange(row, column, numRows)

Belirtilen koordinatlarda sol üst hücreyi ve belirtilen satır sayısını içeren aralığı döndürür.

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

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

Parametreler

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

Return

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

Yetkilendirme

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

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

getRange(row, column, numRows, numColumns)

Belirli satır ve sütun sayısına sahip, belirli koordinatlarda sol üst hücreyi içeren aralığı döndürür.

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

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

Parametreler

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

Return

Range: Belirtilen alana karşılık gelen bir aralık.

Yetkilendirme

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

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

getRange(a1Notation)

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

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

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

Parametreler

AdTürAçıklama
a1NotationStringA1 veya R1C1 gösterimiyle belirtilen, döndürülecek aralık.

Return

Range: Belirtilen konumdaki aralık

Yetkilendirme

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

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

getRangeList(a1Notations)

Boş olmayan bir A1 veya R1C1 notasyonu listesi tarafından belirtilen aynı sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür.

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

Parametreler

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

Return

RangeList: Belirtilen konumdaki aralık listesi

Yetkilendirme

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

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

getRowGroup(rowIndex, groupDepth)

Belirtilen dizinde ve grup derinliğindeki satır grubunu döndürür.

const 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.
const rowGroup = sheet.getRowGroup(2, 1);

Parametreler

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

Return

Group: Kontrol dizini ve derinliğindeki satır grubudur veya grup mevcut değilse istisna atar.

Yetkilendirme

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

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

getRowGroupControlPosition()

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

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

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

Return

GroupControlTogglePosition: Satır gruplandırma kontrol düğmesi bu sayfadaki grubun ardından gösteriliyorsa true, aksi takdirde false.

Yetkilendirme

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

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

getRowGroupDepth(rowIndex)

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

Grup derinliği, satırla kaç grubun örtüştüğünü gösterir. Bu değer sıfır ile sekiz arasında olabilir.

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

// 1 if there is a group over rows 1 through 3
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getRowHeight(rowPosition)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getSelection()

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

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

Return

Selection: Geçerli seçim

Yetkilendirme

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

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

getSheetId()

Bu nesne tarafından temsil edilen sayfanın kimliğini döndürür.

Bu, e-tabloya özgü olan sayfanın kimliğidir. Kimlik, e-tablo oluşturulurken atanan ve e-tablo konumundan bağımsız olan monoton olarak artan bir tam sayıdır. Bu, Sheet örneği yerine gridId parametresi alan Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd) gibi yöntemlerle birlikte kullanıldığında faydalıdır.

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

Logger.log(sheet.getSheetId());

Return

Integer: E-tabloya özgü sayfa kimliği

Yetkilendirme

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

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

getSheetName()

E-tablo adını döndürür.

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

Logger.log(sheet.getSheetName());

Return

String: Sayfanın adı

Yetkilendirme

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

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

getSheetValues(startRow, startColumn, numRows, numColumns)

Belirtilen koordinatlardan başlayarak bu aralık için dikdörtgen değer ızgarasına döndürür. Satır veya sütun konumu olarak -1 değeri verildiğinde, sayfadaki verileri içeren en son satır veya sütun elde edilir.

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

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

const 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ğerlerinin döndürüleceği satır sayısı.
numColumnsIntegerDeğerlerinin döndürüleceği sütun sayısı.

Return

Object[][]: iki boyutlu bir değer dizisi

Yetkilendirme

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

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

getSlicers()

Sayfadaki bir dilimleyici dizisi döndürür.

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

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

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

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

Return

Slicer[]: Bu sayfadaki dilimleyicilerin listesi.

Yetkilendirme

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

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

getTabColorObject()

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

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

Return

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

Yetkilendirme

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

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

getType()

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

E-tablonun varsayılan türü SheetType.GRID'tir. EmbeddedChart gibi tek bir yerleştirilmiş nesne içeren bir sayfa SheetType.OBJECT sayfasıdır.

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

Return

SheetType: E-tablonun türü.

Yetkilendirme

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

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

hasHiddenGridlines()

Sayfanın ızgara çizgileri gizliyse true, aksi takdirde false döndürülür. Kılavuz çizgileri varsayılan olarak görünür.

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

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

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

Return

Boolean: Kılavuz çizgileri gizliyse true, aksi takdirde false değerini alır.

Yetkilendirme

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

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

hideColumn(column)

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

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

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

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

Parametreler

AdTürAçıklama
columnRangeGizlenecek sütun aralığı.

Yetkilendirme

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

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

hideColumns(columnIndex)

Belirtilen 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) simgesini kullanın.

Bir aralığı kullanarak birden fazla sütunu gizlemek için hideColumn() simgesini kullanın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

hideColumns(columnIndex, numColumns)

Belirtilen dizinden itibaren bir veya daha fazla sütunu gizler. Bu yöntem için 1 dizini kullanın.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

hideRow(row)

Belirtilen aralıktaki satırları gizler.

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

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

Parametreler

AdTürAçıklama
rowRangeGizlenecek satır aralığı.

Yetkilendirme

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

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

hideRows(rowIndex)

Belirtilen dizindeki satırı gizler.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

hideRows(rowIndex, numRows)

Belirtilen dizinden itibaren bir veya daha fazla art arda gelen satırı gizler.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

hideSheet()

Bu sayfayı gizler. E-tablo zaten gizliyse hiçbir etkisi olmaz. Bu yöntem, yalnızca görünen sayfada çağrılırsa istisna oluşturur.

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

Return

Sheet: Geçerli sayfa.

Yetkilendirme

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

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

insertChart(chart)

Bu sayfaya yeni bir grafik ekler.

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

// This creates a simple bar chart from the first three rows
// of the first two columns of the spreadsheet
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

insertColumnAfter(afterPosition)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ütun.

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

insertColumnBefore(beforePosition)

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

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

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

Parametreler

AdTürAçıklama
beforePositionIntegerYeni sütunun ekleneceği sütun.

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

insertColumns(columnIndex)

Sayfada belirtilen konuma boş bir sütun ekler.

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

Parametreler

AdTürAçıklama
columnIndexIntegerSütunun nereye ekleneceğini belirten dizin.

Yetkilendirme

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

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

insertColumns(columnIndex, numColumns)

Belirtilen konumdan itibaren bir sayfada bir veya daha fazla art arda boş sütun ekler.

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

Parametreler

AdTürAçıklama
columnIndexIntegerSütunun nereye ekleneceğini belirten dizin.
numColumnsIntegerEklenecek sütun sayısı.

Yetkilendirme

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

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

insertColumnsAfter(afterPosition, howMany)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ütun.
howManyIntegerEklenecek sütun sayısı.

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

insertColumnsBefore(beforePosition, howMany)

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

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

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

Parametreler

AdTürAçıklama
beforePositionIntegerYeni sütunun ekleneceği sütun.
howManyIntegerEklenecek sütun sayısı.

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

insertImage(blobSource, column, row)

Dokümana belirli bir satır ve sütunda resim olarak BlobSource ekler. Resim boyutu, blob içeriklerinden alınır. Desteklenen maksimum blob boyutu 2 MB'tır.

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

const binaryData = [];  // TODO(developer): Replace with your binary data.
const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

Parametreler

AdTürAçıklama
blobSourceBlobSourceResim içeriğini, 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

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

Belirli bir satır ve sütuna, piksel kaydırmayla birlikte dokümana resim olarak bir BlobSource ekler. Resim boyutu, blob içeriklerinden alınır. Desteklenen maksimum blob boyutu 2 MB'tır.

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

const binaryData = [];  // TODO(developer): Replace with your binary data.
const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

Parametreler

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

Return

OverGridImage: Eklenen resim.

Yetkilendirme

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

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

insertImage(url, column, row)

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

Sağlanan URL'ye herkes erişebilmelidir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

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

Dokümana, belirli bir satır ve sütunda piksel kaydırmayla bir resim ekler.

Sağlanan URL'ye herkes erişebilmelidir.

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

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

Parametreler

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

Return

OverGridImage: Eklenen resim.

Yetkilendirme

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

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

insertRowAfter(afterPosition)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

insertRowBefore(beforePosition)

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

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

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

Parametreler

AdTürAçıklama
beforePositionIntegerYeni satırın ekleneceği satır.

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

insertRows(rowIndex)

Belirtilen konumda bir sayfaya boş bir satır ekler.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

insertRows(rowIndex, numRows)

Belirtilen konumdan itibaren bir sayfaya art arda bir veya daha fazla boş satır ekler.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

insertRowsAfter(afterPosition, howMany)

Belirtilen satır konumundan sonra bir dizi satır ekler.

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

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

Parametreler

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

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

insertRowsBefore(beforePosition, howMany)

Belirtilen satır konumundan önce bir dizi satır ekler.

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

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

Parametreler

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

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

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
rangeRangeDilimleyicinin oluşturulduğu aralık.
anchorRowPosIntegerDilimleyicinin üst tarafı bu satıra sabitlenir.
anchorColPosIntegerDilimleyicinin üst tarafı bu sütuna sabitlenmiştir.

Return

Slicer: Yeni eklenen dilimleyici.

Yetkilendirme

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

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

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
rangeRangeDilimleyicinin oluşturulduğu aralık.
anchorRowPosIntegerDilimleyicinin üst tarafı bu satıra sabitlenir.
anchorColPosIntegerDilimleyicinin üst tarafı bu sütuna sabitlenmiştir.
offsetXIntegerHücre köşesine göre yatay ofset (piksel cinsinden).
offsetYIntegerHücre köşesine göre dikey kayma (piksel cinsinden).

Return

Slicer: Yeni eklenen dilimleyici.

Yetkilendirme

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

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

isColumnHiddenByUser(columnPosition)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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, gizli değilse false değerini alır.

Yetkilendirme

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

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

isRightToLeft()

Bu sayfa düzeni sağdan sola ise true değerini döndürür. E-tabloda varsayılan soldan sağa düzen kullanılı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 sola ise true, aksi takdirde false.

Yetkilendirme

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

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

isRowHiddenByFilter(rowPosition)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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, aksi takdirde false değerini alır.

Yetkilendirme

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

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

isRowHiddenByUser(rowPosition)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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, aksi takdirde false değerini alır.

Yetkilendirme

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

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

isSheetHidden()

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

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

Return

Boolean: Sayfa gizliyse true, gizli değilse false değerini alır.

Yetkilendirme

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

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

moveColumns(columnSpec, destinationIndex)

Belirtilen aralık tarafından seçilen sütunları destinationIndex ile belirtilen konuma taşır. columnSpec'nin, taşınacak sütunun veya sütun grubunun tamamını tam olarak temsil etmesi gerekmez. columnSpec, 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.
const sheet = SpreadsheetApp.getActiveSheet();
// Selects column A and column B to be moved.
const 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 koordinatlara göre belirlendiğini unutmayın. Mevcut veriler, taşınan sütunlara yer açmak için sağa kaydırılırken kaynak sütunlar grid'den kaldırılır. Bu nedenle, veriler başlangıçta belirtilenden farklı bir dizinde bulunabilir.

Yetkilendirme

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

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

moveRows(rowSpec, destinationIndex)

Belirtilen aralık tarafından seçilen satırları destinationIndex ile belirtilen konuma taşır. rowSpec'nin, taşınacak bir satırın veya satır grubunun tamamını tam olarak temsil etmesi gerekmez. rowSpec, 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.
const sheet = SpreadsheetApp.getActiveSheet();
// Selects row 1 and row 2 to be moved.
const 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 koordinatlara dayalı olduğunu unutmayın. Mevcut veriler, taşınan satırlara yer açmak için aşağı kaydırılır. Bu sırada kaynak satırlar ızgaradan kaldırılır. Bu nedenle, veriler başlangıçta belirtilenden farklı bir dizinde bulunabilir.

Yetkilendirme

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

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

newChart()

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

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B8');
const 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 bir grafik oluşturmak için bir oluşturucu.


protect()

İzin sahibi kullanıcılar dışındaki kullanıcıların sayfayı düzenlemesini engelleyebilecek bir nesne oluşturur. Komut dosyası, sayfanın düzenleyici 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) çağrısı yaparak veya Protection.setDomainEdit(editable) için yeni bir değer ayarlayarak) izinler e-tablonun izinlerini yansıtır. Bu da sayfanın korumasız kalması anlamına gelir. E-tablo zaten korunuyorsa bu yöntem, mevcut koruma ayarlarını temsil eden bir nesne döndürür. Korumalı bir sayfa, korumasız bölgeler içerebilir.

// Protect the active sheet, then remove all other users from the list of
// editors.
const sheet = SpreadsheetApp.getActiveSheet();
const 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.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Return

Protection: Koruma ayarlarını temsil eden bir nesne.

Yetkilendirme

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

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

removeChart(chart)

Bir grafiği ana sayfadan kaldırır.

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

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

Parametreler

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

Yetkilendirme

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

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

setActiveRange(range)

Belirtilen aralığı etkin sayfada active range olarak ayarlar. Bu aralığın sol üst hücresi current cell olur.

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

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

Parametreler

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

Return

Range: Yeni etkin aralık

Yetkilendirme

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

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

setActiveRangeList(rangeList)

Belirtilen aralık listesini etkin sayfada active ranges olarak ayarlar. Listedeki son aralık active range olarak ayarlanır.

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

const selection = sheet.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setActiveSelection(range)

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

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

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

Parametreler

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

Return

Range: Yeni etkin aralık

Yetkilendirme

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

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

setActiveSelection(a1Notation)

Etkin seçimi A1 notasyonunda veya R1C1 notasyonunda belirtildiği şekilde ayarlar.

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

sheet.setActiveSelection('A1:D4');

Parametreler

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

Return

Range: Yeni etkin aralık

Yetkilendirme

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

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

setColumnGroupControlPosition(position)

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

const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setColumnWidth(columnPosition, width)

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

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

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

Parametreler

AdTürAçıklama
columnPositionIntegerAyarlanacak belirli sütunun konumu.
widthIntegerAyarlanacak piksel cinsinden genişlik.

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

setColumnWidths(startColumn, numColumns, width)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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 piksel cinsinden genişlik.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

setConditionalFormatRules(rules)

Sayfada şu anda mevcut olan tüm koşullu biçimlendirme kurallarını giriş kurallarıyla değiştirir. Kurallar, girilen sırayla değerlendirilir.

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

Parametreler

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

Yetkilendirme

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

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

setCurrentCell(cell)

Belirtilen hücreyi current cell olarak ayarlar.

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

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

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

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

const selection = sheet.getSelection();
// Current cell: B5
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFrozenColumns(columns)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setFrozenRows(rows)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setName(name)

E-tablo adını belirler.

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

Parametreler

AdTürAçıklama
nameStringE-tablonun yeni adı.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

setRightToLeft(rightToLeft)

Sayfa düzenini sağdan sola olarak ayarlar veya ayarı kaldırır.

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

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

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

Parametreler

AdTürAçıklama
rightToLeftBooleantrue ise sayfa düzeni sağdan sola olacak şekilde ayarlanır ve A1 hücresi sağ üst köşede olur. false ise sayfa düzeni, sol üstte A1 hücresi olacak şekilde varsayılan soldan sağa ayarlanır.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

setRowGroupControlPosition(position)

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

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

Parametreler

AdTürAçıklama
positionGroupControlTogglePositionSatır grubu kontrol düğmesinin konumu.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

setRowHeight(rowPosition, height)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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 zincirleme için yararlı olan sayfa.

Yetkilendirme

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

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

setRowHeights(startRow, numRows, height)

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setRowHeightsForced(startRow, numRows, height)

Belirtilen satırların piksel cinsinden yüksekliğini ayarlar. Varsayılan olarak satırlar, hücre içeriklerine sığacak şekilde büyür. setRowHeightsForced kullanıldığında, hücre içerikleri satır yüksekliğinden uzun olsa bile satırlar belirtilen yüksekliğe zorlanacaktır.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTabColor(color)

E-tablo sekmesi rengini ayarlar.

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

Parametreler

AdTürAçıklama
colorStringCSS notasyonunda bir renk kodu ('#ffffff' veya 'white' gibi) veya sekme rengini sıfırlamak için null.

Return

Sheet: Zincirleme için bu sayfa.

Yetkilendirme

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

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

setTabColorObject(color)

E-tablo sekmesi rengini ayarlar.

// This example assumes there is a sheet named "Sheet1"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('Sheet1');
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

showColumns(columnIndex)

Belirtilen dizindeki sütunu görünür yapar.

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

Parametreler

AdTürAçıklama
columnIndexIntegerGizliliği kaldırılacak sütunun dizini.

Yetkilendirme

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

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

showColumns(columnIndex, numColumns)

Belirtilen dizinden itibaren bir veya daha fazla sütunu görünür hale getirir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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.
numColumnsIntegerGizliliği kaldırılacak sütunların sayısı.

Yetkilendirme

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

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

showRows(rowIndex)

Belirtilen dizindeki satırı görünür hale getirir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

showRows(rowIndex, numRows)

Belirtilen dizinden itibaren bir veya daha fazla art arda gelen satırı gösterir.

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

Parametreler

AdTürAçıklama
rowIndexIntegerGizliliği kaldırılacak satırların başlangıç dizini.
numRowsIntegerGizliliğinin kaldırılacağı satır sayısı.

Yetkilendirme

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

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

showSheet()

E-tabloyu görünür yapar. E-tablo zaten görünür durumdaysa hiçbir etkisi olmaz.

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

Return

Sheet: Geçerli sayfa.

Yetkilendirme

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

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

sort(columnPosition)

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

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

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

Parametreler

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

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

sort(columnPosition, ascending)

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

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

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

Parametreler

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

Return

Sheet: E-tablo. Yöntem zincirleme için kullanışlıdır.

Yetkilendirme

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

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

unhideColumn(column)

Belirtilen aralıktaki sütunu gösterir.

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

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

Parametreler

AdTürAçıklama
columnRangeGizliyse gizliliğini kaldırılacak aralık.

Yetkilendirme

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

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

unhideRow(row)

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

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

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

Parametreler

AdTürAçıklama
rowRangeGizliyse gizliliğini kaldırılacak aralık.

Yetkilendirme

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

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

updateChart(chart)

Bu sayfadaki grafiği günceller.

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

// This code is going to loop through all the charts and change them to
// column charts
const charts = sheet.getCharts();
for (const i in charts) {
  const chart = charts[i];
  const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Kullanımdan kaldırılan yöntemler