Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class Sheet

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öntem	Dönüş türü	Kısa açıklama
`activate()`	`Sheet`	Bu sayfayı etkinleştirir.
`addDeveloperMetadata(key)`	`Sheet`	Belirtilen anahtarla geliştirici meta verilerini sayfaya ekler.
`addDeveloperMetadata(key, visibility)`	`Sheet`	E-tabloya, belirtilen anahtar ve görünürlükle geliştirici meta verileri ekler.
`addDeveloperMetadata(key, value)`	`Sheet`	E-tabloya, belirtilen anahtar ve değere sahip geliştirici meta verilerini ekler.
`addDeveloperMetadata(key, value, visibility)`	`Sheet`	Belirtilen anahtar, değer ve görünürlükle geliştirici meta verilerini sayfaya ekler.
`appendRow(rowContents)`	`Sheet`	Sayfadaki geçerli veri bölgesinin altına bir satır ekler.
`asDataSourceSheet()`	`DataSourceSheet`	Sayfa `SheetType.DATASOURCE` türüne sahipse sayfayı `DataSourceSheet` olarak, aksi takdirde `null` olarak döndürür.
`autoResizeColumn(columnPosition)`	`Sheet`	Belirtilen sütunun genişliğini içeriğine sığacak şekilde ayarlar.
`autoResizeColumns(startColumn, numColumns)`	`Sheet`	Belirtilen sütun konumundan itibaren tüm sütunların genişliğini, içeriklerine sığacak şekilde ayarlar.
`autoResizeRows(startRow, numRows)`	`Sheet`	Belirtilen satır konumundan itibaren tüm satırların yüksekliğini, içeriklerine sığacak şekilde ayarlar.
`clear()`	`Sheet`	Sayfayı içerik ve biçimlendirme bilgilerinden temizler.
`clear(options)`	`Sheet`	Belirtilen gelişmiş seçeneklerle belirtildiği şekilde sayfayı içeriklerden ve/veya biçiminden temizler.
`clearConditionalFormatRules()`	`void`	E-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()`	`Sheet`	Sayfayı tüm notlardan temizler.
`collapseAllColumnGroups()`	`Sheet`	Sayfadaki tüm sütun gruplarını daraltır.
`collapseAllRowGroups()`	`Sheet`	Sayfadaki tüm satır gruplarını daraltır.
`copyTo(spreadsheet)`	`Sheet`	Sayfayı, kaynakla aynı e-tablo da dahil olmak üzere belirli bir e-tabloya kopyalar.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Bu sayfanın kapsamında geliştirici meta verilerini bulmak için bir `DeveloperMetadataFinder` döndürür.
`createTextFinder(findText)`	`TextFinder`	E-tablo için bir metin bulucu oluşturur. Bu metin bulucu, e-tablodaki metinleri bulup değiştirebilir.
`deleteColumn(columnPosition)`	`Sheet`	Belirtilen sütun konumundaki sütunu siler.
`deleteColumns(columnPosition, howMany)`	`void`	Belirtilen sütun konumundan itibaren belirli sayıda sütunu siler.
`deleteRow(rowPosition)`	`Sheet`	Belirtilen satır konumundaki satırı siler.
`deleteRows(rowPosition, howMany)`	`void`	Belirtilen satır konumundan itibaren belirli sayıda satırı siler.
`expandAllColumnGroups()`	`Sheet`	Sayfadaki tüm sütun gruplarını genişletir.
`expandAllRowGroups()`	`Sheet`	Sayfadaki tüm satır gruplarını genişletir.
`expandColumnGroupsUpToDepth(groupDepth)`	`Sheet`	Belirtilen derinliğe kadar tüm sütun gruplarını genişletir ve diğer tüm grupları daraltır.
`expandRowGroupsUpToDepth(groupDepth)`	`Sheet`	Belirtilen derinliğe kadar tüm satır gruplarını genişletir ve diğer tüm grupları daraltır.
`getActiveCell()`	`Range`	Bu sayfadaki etkin hücreyi döndürür.
`getActiveRange()`	`Range`	Etkin sayfadaki seçili aralığı veya etkin bir aralık yoksa `null` değerini döndürür.
`getActiveRangeList()`	`RangeList`	Etkin 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)`	`Group`	Belirtilen dizinde ve grup derinliğindeki sütun grubunu döndürür.
`getColumnGroupControlPosition()`	`GroupControlTogglePosition`	Sayfadaki tüm sütun grupları için `GroupControlTogglePosition` değerini döndürür.
`getColumnGroupDepth(columnIndex)`	`Integer`	Belirtilen dizindeki sütunun grup derinliğini döndürür.
`getColumnWidth(columnPosition)`	`Integer`	Belirtilen 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()`	`Range`	Etkin sayfadaki geçerli hücreyi veya geçerli hücre yoksa `null` değerini döndürür.
`getDataRange()`	`Range`	Verilerin 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()`	`Filter`	Bu sayfadaki filtreyi veya filtre yoksa `null` değerini döndürür.
`getFormUrl()`	`String`	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.
`getFrozenColumns()`	`Integer`	Dondurulmuş sütun sayısını döndürür.
`getFrozenRows()`	`Integer`	Dondurulmuş satır sayısını döndürür.
`getImages()`	`OverGridImage[]`	Sayfadaki tüm ızgara dışı resimleri döndürür.
`getIndex()`	`Integer`	Sayfanı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()`	`String`	E-tablonun adını döndürür.
`getNamedRanges()`	`NamedRange[]`	Bu sayfadaki tüm adlandırılmış aralıkları alır.
`getParent()`	`Spreadsheet`	Bu sayfayı içeren `Spreadsheet` değerini döndürür.
`getPivotTables()`	`PivotTable[]`	Bu sayfadaki tüm pivot tabloları döndürür.
`getProtections(type)`	`Protection[]`	Sayfadaki tüm korumalı aralıkları temsil eden bir nesne dizisi veya sayfadaki korumayı temsil eden tek öğeli bir dizi alır.
`getRange(row, column)`	`Range`	Belirtilen koordinatlarda sol üst hücreyi içeren aralığı döndürür.
`getRange(row, column, numRows)`	`Range`	Belirtilen koordinatlarda sol üst hücreyi ve belirtilen satır sayısını içeren aralığı döndürür.
`getRange(row, column, numRows, numColumns)`	`Range`	Belirli satır ve sütun sayısına sahip, belirli koordinatlarda sol üst hücreyi içeren aralığı döndürür.
`getRange(a1Notation)`	`Range`	A1 notasyonunda veya R1C1 notasyonunda belirtilen aralığı döndürür.
`getRangeList(a1Notations)`	`RangeList`	Boş olmayan bir A1 veya R1C1 gösterimi listesi tarafından belirtilen aynı sayfadaki aralıkları temsil eden `RangeList` koleksiyonunu döndürür.
`getRowGroup(rowIndex, groupDepth)`	`Group`	Belirtilen dizinde ve grup derinliğindeki satır grubunu döndürür.
`getRowGroupControlPosition()`	`GroupControlTogglePosition`	Sayfadaki tüm satır grupları için `GroupControlTogglePosition` değerini döndürür.
`getRowGroupDepth(rowIndex)`	`Integer`	Belirtilen dizindeki satırın grup derinliğini döndürür.
`getRowHeight(rowPosition)`	`Integer`	Belirtilen satırın piksel cinsinden yüksekliğini alır.
`getSelection()`	`Selection`	E-tablodaki geçerli `Selection` değerini döndürür.
`getSheetId()`	`Integer`	Bu nesne tarafından temsil edilen sayfanın kimliğini döndürür.
`getSheetName()`	`String`	E-tablo adını döndürür.
`getSheetValues(startRow, startColumn, numRows, numColumns)`	`Object[][]`	Belirtilen koordinatlardan başlayarak bu aralık için dikdörtgen değer ızgamasını döndürür.
`getSlicers()`	`Slicer[]`	Sayfadaki bir dilimleyici dizisi döndürür.
`getTabColorObject()`	`Color`	Sayfa sekmesi rengini veya sayfa sekmesinde renk yoksa `null` değerini alır.
`getType()`	`SheetType`	Sayfanın türünü döndürür.
`hasHiddenGridlines()`	`Boolean`	Sayfanın ızgara çizgileri gizliyse `true`, aksi takdirde `false` döndürülür.
`hideColumn(column)`	`void`	Belirli aralıktaki sütunu veya sütunları gizler.
`hideColumns(columnIndex)`	`void`	Belirtilen dizindeki tek bir sütunu gizler.
`hideColumns(columnIndex, numColumns)`	`void`	Belirtilen dizinden itibaren bir veya daha fazla sütunu gizler.
`hideRow(row)`	`void`	Belirtilen aralıktaki satırları gizler.
`hideRows(rowIndex)`	`void`	Belirtilen dizindeki satırı gizler.
`hideRows(rowIndex, numRows)`	`void`	Belirtilen dizinden itibaren bir veya daha fazla art arda gelen satırı gizler.
`hideSheet()`	`Sheet`	Bu sayfayı gizler.
`insertChart(chart)`	`void`	Bu sayfaya yeni bir grafik ekler.
`insertColumnAfter(afterPosition)`	`Sheet`	Belirtilen sütun konumundan sonra bir sütun ekler.
`insertColumnBefore(beforePosition)`	`Sheet`	Belirtilen sütun konumundan önce bir sütun ekler.
`insertColumns(columnIndex)`	`void`	Sayfada belirtilen konuma boş bir sütun ekler.
`insertColumns(columnIndex, numColumns)`	`void`	Belirtilen konumdan itibaren bir sayfada bir veya daha fazla art arda boş sütun ekler.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	Belirtilen sütun konumundan sonra belirli sayıda sütun ekler.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	Belirtilen sütun konumundan önce bir dizi sütun ekler.
`insertImage(blobSource, column, row)`	`OverGridImage`	Dokümana belirli bir satır ve sütunda resim olarak `BlobSource` ekler.
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	Belirli bir satır ve sütuna, piksel kaydırması ile dokümana resim olarak bir `BlobSource` ekler.
`insertImage(url, column, row)`	`OverGridImage`	Dokümana belirli bir satır ve sütuna resim ekler.
`insertImage(url, column, row, offsetX, offsetY)`	`OverGridImage`	Dokümana, belirli bir satır ve sütunda piksel kaydırmayla bir resim ekler.
`insertRowAfter(afterPosition)`	`Sheet`	Belirtilen satır konumundan sonra bir satır ekler.
`insertRowBefore(beforePosition)`	`Sheet`	Belirtilen satır konumundan önce bir satır ekler.
`insertRows(rowIndex)`	`void`	Belirtilen konumda bir sayfaya boş bir satır ekler.
`insertRows(rowIndex, numRows)`	`void`	Belirtilen konumdan itibaren bir sayfaya art arda bir veya daha fazla boş satır ekler.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	Belirtilen satır konumundan sonra bir dizi satır ekler.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	Belirtilen satır konumundan önce bir dizi satır ekler.
`insertSlicer(range, anchorRowPos, anchorColPos)`	`Slicer`	Bu sayfaya yeni bir dilimleyici ekler.
`insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)`	`Slicer`	Bu sayfaya yeni bir dilimleyici ekler.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Belirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.
`isRightToLeft()`	`Boolean`	Bu sayfa düzeni sağdan sola ise `true` değerini döndürür.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	Belirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür.
`isRowHiddenByUser(rowPosition)`	`Boolean`	Belirtilen satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.
`isSheetHidden()`	`Boolean`	Sayfa şu anda gizliyse `true` değerini döndürür.
`moveColumns(columnSpec, destinationIndex)`	`void`	Belirtilen aralık tarafından seçilen sütunları `destinationIndex` ile belirtilen konuma taşır.
`moveRows(rowSpec, destinationIndex)`	`void`	Belirtilen aralık tarafından seçilen satırları `destinationIndex` ile belirtilen konuma taşır.
`newChart()`	`EmbeddedChartBuilder`	Bu 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)`	`void`	Bir grafiği ana sayfadan kaldırır.
`setActiveRange(range)`	`Range`	Belirtilen aralığı etkin sayfada `active range` olarak ayarlar. Bu aralığın sol üst hücresi `current cell` olur.
`setActiveRangeList(rangeList)`	`RangeList`	Belirtilen aralık listesini etkin sayfada `active ranges` olarak ayarlar.
`setActiveSelection(range)`	`Range`	Bu sayfa için etkin seçim bölgesini ayarlar.
`setActiveSelection(a1Notation)`	`Range`	Etkin seçimi A1 veya R1C1 notasyonunda belirtildiği şekilde ayarlar.
`setColumnGroupControlPosition(position)`	`Sheet`	Sayfadaki sütun grubu denetimi açma/kapatma düğmesinin konumunu ayarlar.
`setColumnWidth(columnPosition, width)`	`Sheet`	Belirtilen sütunun genişliğini piksel cinsinden ayarlar.
`setColumnWidths(startColumn, numColumns, width)`	`Sheet`	Belirtilen sütunların genişliğini piksel cinsinden ayarlar.
`setConditionalFormatRules(rules)`	`void`	Sayfada şu anda mevcut olan tüm koşullu biçimlendirme kurallarını giriş kurallarıyla değiştirir.
`setCurrentCell(cell)`	`Range`	Belirtilen hücreyi `current cell` olarak ayarlar.
`setFrozenColumns(columns)`	`void`	Belirli sayıda sütunu dondurur.
`setFrozenRows(rows)`	`void`	Belirtilen sayıda satırı dondurur.
`setHiddenGridlines(hideGridlines)`	`Sheet`	Sayfa kılavuz çizgilerini gizler veya gösterir.
`setName(name)`	`Sheet`	E-tablo adını belirler.
`setRightToLeft(rightToLeft)`	`Sheet`	Sayfa düzenini sağdan sola olarak ayarlar veya ayarı kaldırır.
`setRowGroupControlPosition(position)`	`Sheet`	Satır grubu denetimi açma/kapatma düğmesinin sayfadaki konumunu ayarlar.
`setRowHeight(rowPosition, height)`	`Sheet`	Belirtilen satırın piksel cinsinden satır yüksekliğini ayarlar.
`setRowHeights(startRow, numRows, height)`	`Sheet`	Belirtilen satırların piksel cinsinden yüksekliğini ayarlar.
`setRowHeightsForced(startRow, numRows, height)`	`Sheet`	Belirtilen satırların piksel cinsinden yüksekliğini ayarlar.
`setTabColor(color)`	`Sheet`	E-tablo sekmesi rengini ayarlar.
`setTabColorObject(color)`	`Sheet`	E-tablo sekmesi rengini ayarlar.
`showColumns(columnIndex)`	`void`	Belirtilen dizindeki sütunu görünür hale getirir.
`showColumns(columnIndex, numColumns)`	`void`	Belirtilen dizinden itibaren bir veya daha fazla sütunu görünür yapar.
`showRows(rowIndex)`	`void`	Belirtilen dizindeki satırı görünür hale getirir.
`showRows(rowIndex, numRows)`	`void`	Belirtilen dizinden itibaren bir veya daha fazla art arda gelen satırı gizler.
`showSheet()`	`Sheet`	E-tabloyu görünür yapar.
`sort(columnPosition)`	`Sheet`	Bir sayfayı sütuna göre artan düzende sıralar.
`sort(columnPosition, ascending)`	`Sheet`	Bir sayfayı sütuna göre sıralar.
`unhideColumn(column)`	`void`	Belirtilen aralıktaki sütunu gösterir.
`unhideRow(row)`	`void`	Belirtilen aralıktaki satırı gösterir.
`updateChart(chart)`	`void`	Bu sayfadaki grafiği günceller.

Kullanımdan kaldırılan yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`getSheetProtection()`	`PageProtection`	Geçerli sayfanın izinlerini açıklayan bir `PageProtection` örneği döndürür.
`getTabColor()`	`String`	Sayfa sekmesi rengini veya sayfa sekmesinde renk yoksa `null` değerini alır.
`setSheetProtection(permissions)`	`void`	Geçerli sayfanın izinlerini ayarlar.

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

Ad	Tür	Açıklama
`key`	`String`	Yeni 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 verisi 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

Ad	Tür	Açıklama
`key`	`String`	Yeni geliştirici meta verilerinin anahtarı.
`visibility`	`DeveloperMetadataVisibility`	Yeni 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

Ad	Tür	Açıklama
`key`	`String`	Yeni geliştirici meta verilerinin anahtarı.
`value`	`String`	Yeni 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

Ad	Tür	Açıklama
`key`	`String`	Yeni geliştirici meta verilerinin anahtarı.
`value`	`String`	Yeni geliştirici meta verisinin değeri.
`visibility`	`DeveloperMetadataVisibility`	Yeni 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

Ad	Tür	Açıklama
`rowContents`	`Object[]`	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

Ad	Tür	Açıklama
`columnPosition`	`Integer`	Yeniden 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

Ad	Tür	Açıklama
`startColumn`	`Integer`	Otomatik olarak yeniden boyutlandırılacak başlangıç sütunu.
`numColumns`	`Integer`	Otomatik 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

Ad	Tür	Açıklama
`startRow`	`Integer`	Otomatik olarak yeniden boyutlandırılacak başlangıç satırı.
`numRows`	`Integer`	Otomatik 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

Ad	Tür	Açıklama
`options`	`Object`	Aşağıda listelenen gelişmiş seçenekleri içeren bir JavaScript haritası.

Gelişmiş parametreler

Ad	Tür	Açıklama
`contentsOnly`	`Boolean`	İçeriğin temizlenip temizlenmeyeceği.
`formatOnly`	`Boolean`	Biç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

Ad	Tür	Açıklama
`spreadsheet`	`Spreadsheet`	Bu 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

Ad	Tür	Açıklama
`findText`	`String`	Aranacak 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

Ad	Tür	Açıklama
`columnPosition`	`Integer`	Sütunun konumu (ilk sütun 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

`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

Ad	Tür	Açıklama
`columnPosition`	`Integer`	Silecek ilk sütunun konumu.
`howMany`	`Integer`	Sililecek 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

`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

Ad	Tür	Açıklama
`rowPosition`	`Integer`	Satı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

Ad	Tür	Açıklama
`rowPosition`	`Integer`	Silecek ilk satırın konumu.
`howMany`	`Integer`	Silinecek 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

Ad	Tür	Açıklama
`groupDepth`	`Integer`	Sü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

Ad	Tür	Açıklama
`groupDepth`	`Integer`	Satı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:

setActiveRange(range)

`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:

setActiveRangeList(rangeList)

`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

Ad	Tür	Açıklama
`columnIndex`	`Integer`	Grup denetimi açma/kapatma düğmesinin sütun dizini veya grup içindeki bir dizin.
`groupDepth`	`Integer`	Grubun 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

Ad	Tür	Açıklama
`columnIndex`	`Integer`	Sü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

Ad	Tür	Açıklama
`columnPosition`	`Integer`	İ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

Ad	Tür	Açıklama
`type`	`ProtectionType`	Korunan 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ücreyi içeren 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

Ad	Tür	Açıklama
`row`	`Integer`	Döndürülecek hücrenin satır dizini. Satır dizine ekleme 1 ile başlar.
`column`	`Integer`	Dö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

Ad	Tür	Açıklama
`row`	`Integer`	Aralığın başlangıç satır dizini; satır dizine ekleme 1'den başlar.
`column`	`Integer`	Aralığın sütun dizini. Sütun dizini 1 ile başlar.
`numRows`	`Integer`	Dö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

Ad	Tür	Açıklama
`row`	`Integer`	Aralığın başlangıç satır dizini; satır dizine ekleme 1 ile başlar.
`column`	`Integer`	Aralığın başlangıç sütun dizini. Sütun dizine ekleme 1 ile başlar.
`numRows`	`Integer`	Döndürülecek satır sayısı.
`numColumns`	`Integer`	Dö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

Ad	Tür	Açıklama
`a1Notation`	`String`	A1 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 gösterimi 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

Ad	Tür	Açıklama
`a1Notations`	`String[]`	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

Ad	Tür	Açıklama
`rowIndex`	`Integer`	Grup denetimi açma/kapatma düğmesinin satır dizini veya grup içindeki bir dizin.
`groupDepth`	`Integer`	Grubun 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

Ad	Tür	Açıklama
`rowIndex`	`Integer`	Satı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

Ad	Tür	Açıklama
`rowPosition`	`Integer`	İ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 ızgamasını 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

Ad	Tür	Açıklama
`startRow`	`Integer`	Başlangıç satırının konumu.
`startColumn`	`Integer`	Başlangıç sütununun konumu.
`numRows`	`Integer`	Değerlerinin döndürüleceği satır sayısı.
`numColumns`	`Integer`	Değ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 sayfada bulunan 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

Ad	Tür	Açıklama
`column`	`Range`	Gizlenecek 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

Ad	Tür	Açıklama
`columnIndex`	`Integer`	Gizlenecek 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

Ad	Tür	Açıklama
`columnIndex`	`Integer`	Gizlenecek sütunların başlangıç dizini.
`numColumns`	`Integer`	Gizlenecek 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

Ad	Tür	Açıklama
`row`	`Range`	Gizlenecek 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

Ad	Tür	Açıklama
`rowIndex`	`Integer`	Gizlenecek 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

Ad	Tür	Açıklama
`rowIndex`	`Integer`	Gizlenecek satırların başlangıç dizini.
`numRows`	`Integer`	Gizlenecek 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 atar.

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

Ad	Tür	Açıklama
`chart`	`EmbeddedChart`	Eklenecek 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

Ad	Tür	Açıklama
`afterPosition`	`Integer`	Yeni 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

Ad	Tür	Açıklama
`beforePosition`	`Integer`	Yeni sütunun ekleneceği sütun.

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

`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

Ad	Tür	Açıklama
`columnIndex`	`Integer`	Sü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

Ad	Tür	Açıklama
`columnIndex`	`Integer`	Sütunun nereye ekleneceğini belirten dizin.
`numColumns`	`Integer`	Eklenecek 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

Ad	Tür	Açıklama
`afterPosition`	`Integer`	Yeni sütunun ekleneceği sütun.
`howMany`	`Integer`	Eklenecek 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

Ad	Tür	Açıklama
`beforePosition`	`Integer`	Yeni sütunun ekleneceği sütun.
`howMany`	`Integer`	Eklenecek 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

Ad	Tür	Açıklama
`blobSource`	`BlobSource`	Resim içeriğini, MIME türünü ve (isteğe bağlı olarak) adı içeren blob.
`column`	`Integer`	Sütun konumu.
`row`	`Integer`	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(blobSource, column, row, offsetX, offsetY)`

Belirli bir satır ve sütuna, piksel kaydırması ile 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

Ad	Tür	Açıklama
`blobSource`	`BlobSource`	Resim içeriğini, MIME türünü ve (isteğe bağlı olarak) adı içeren blob.
`column`	`Integer`	Sütun konumu.
`row`	`Integer`	Satır konumu.
`offsetX`	`Integer`	Hücre köşesine göre yatay ofset (piksel cinsinden).
`offsetY`	`Integer`	Hü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

Ad	Tür	Açıklama
`url`	`String`	Resmin URL'si.
`column`	`Integer`	Izgara sütunu konumu.
`row`	`Integer`	Izgara 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

Ad	Tür	Açıklama
`url`	`String`	Resmin URL'si.
`column`	`Integer`	Sütun konumu.
`row`	`Integer`	Satır konumu.
`offsetX`	`Integer`	Hücre köşesine göre yatay ofset (piksel cinsinden).
`offsetY`	`Integer`	Hü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

Ad	Tür	Açıklama
`afterPosition`	`Integer`	Yeni 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

Ad	Tür	Açıklama
`beforePosition`	`Integer`	Yeni 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

Ad	Tür	Açıklama
`rowIndex`	`Integer`	Satı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 e-tabloya 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

Ad	Tür	Açıklama
`rowIndex`	`Integer`	Satırın nereye ekleneceğini gösteren dizin.
`numRows`	`Integer`	Eklenecek 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

Ad	Tür	Açıklama
`afterPosition`	`Integer`	Yeni satırların ekleneceği satır.
`howMany`	`Integer`	Eklenecek 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

Ad	Tür	Açıklama
`beforePosition`	`Integer`	Yeni satırların ekleneceği satır.
`howMany`	`Integer`	Eklenecek 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

Ad	Tür	Açıklama
`range`	`Range`	Dilimleyicinin oluşturulduğu aralık.
`anchorRowPos`	`Integer`	Dilimleyicinin üst tarafı bu satıra sabitlenir.
`anchorColPos`	`Integer`	Dilimleyicinin ü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

Ad	Tür	Açıklama
`range`	`Range`	Dilimleyicinin oluşturulduğu aralık.
`anchorRowPos`	`Integer`	Dilimleyicinin üst tarafı bu satıra sabitlenir.
`anchorColPos`	`Integer`	Dilimleyicinin üst tarafı bu sütuna sabitlenmiştir.
`offsetX`	`Integer`	Hücre köşesine göre yatay ofset (piksel cinsinden).
`offsetY`	`Integer`	Hü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

Ad	Tür	Açıklama
`columnPosition`	`Integer`	İ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

Ad	Tür	Açıklama
`rowPosition`	`Integer`	İ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

Ad	Tür	Açıklama
`rowPosition`	`Integer`	İ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

Ad	Tür	Açıklama
`columnSpec`	`Range`	Taşınması gereken sütunları kapsayan bir aralık.
`destinationIndex`	`Integer`	Sü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

Ad	Tür	Açıklama
`rowSpec`	`Range`	Taşınması gereken satırları kapsayan bir aralık.
`destinationIndex`	`Integer`	Satı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üzenleyiciler listesini gerçekten değiştirene (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) kadar 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

Ad	Tür	Açıklama
`chart`	`EmbeddedChart`	Kaldı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

Ad	Tür	Açıklama
`range`	`Range`	Etkin 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

Ad	Tür	Açıklama
`rangeList`	`RangeList`	Seç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

Ad	Tür	Açıklama
`range`	`Range`	Etkin 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

Ad	Tür	Açıklama
`a1Notation`	`String`	A1 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

Ad	Tür	Açıklama
`position`	`GroupControlTogglePosition`	Sü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

Ad	Tür	Açıklama
`columnPosition`	`Integer`	Ayarlanacak belirli sütunun konumu.
`width`	`Integer`	Ayarlanacak 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

Ad	Tür	Açıklama
`startColumn`	`Integer`	Değiştirilecek başlangıç sütunu konumu.
`numColumns`	`Integer`	Değiştirilecek sütun sayısı.
`width`	`Integer`	Ayarlanacak 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

Ad	Tür	Açıklama
`rules`	`ConditionalFormatRule[]`	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

Ad	Tür	Açıklama
`cell`	`Range`	Geç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

Ad	Tür	Açıklama
`columns`	`Integer`	Dondurulacak 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

Ad	Tür	Açıklama
`rows`	`Integer`	Dondurulacak 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

Ad	Tür	Açıklama
`hideGridlines`	`Boolean`	`true` 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

Ad	Tür	Açıklama
`name`	`String`	E-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

Ad	Tür	Açıklama
`rightToLeft`	`Boolean`	`true` 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)`

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

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

Parametreler

Ad	Tür	Açıklama
`position`	`GroupControlTogglePosition`	Satır 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

`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

Ad	Tür	Açıklama
`rowPosition`	`Integer`	Değiştirilecek satır konumu.
`height`	`Integer`	Ayarlanacak 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

Ad	Tür	Açıklama
`startRow`	`Integer`	Değiştirilecek başlangıç satırı konumu.
`numRows`	`Integer`	Değiştirilecek satır sayısı.
`height`	`Integer`	Ayarlanacak 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

Ad	Tür	Açıklama
`startRow`	`Integer`	Değiştirilecek başlangıç satırı konumu.
`numRows`	`Integer`	Değiştirilecek satır sayısı.
`height`	`Integer`	Ayarlanacak 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

Ad	Tür	Açıklama
`color`	`String`	CSS 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

Ad	Tür	Açıklama
`color`	`Color`	Ayarlanacak 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 hale getirir.

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

Parametreler

Ad	Tür	Açıklama
`columnIndex`	`Integer`	Gösterilecek 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 yapar.

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

Parametreler

Ad	Tür	Açıklama
`columnIndex`	`Integer`	Gösterilecek sütunların başlangıç dizini.
`numColumns`	`Integer`	Gizliliğ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

Ad	Tür	Açıklama
`rowIndex`	`Integer`	Gö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

Ad	Tür	Açıklama
`rowIndex`	`Integer`	Gizliliği kaldırılacak satırların başlangıç dizini.
`numRows`	`Integer`	Gizliliğ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

Ad	Tür	Açıklama
`columnPosition`	`Integer`	Sı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

Ad	Tür	Açıklama
`columnPosition`	`Integer`	Sıralama ölçütü olarak kullanılacak sütun.
`ascending`	`Boolean`	Artan 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

Ad	Tür	Açıklama
`column`	`Range`	Gizliyse 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

Ad	Tür	Açıklama
`row`	`Range`	Gizliyse 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

Ad	Tür	Açıklama
`chart`	`EmbeddedChart`	Gü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

`getSheetProtection()`

Kullanımdan kaldırıldı. Google E-Tablolar'ın daha yeni sürümünde oluşturulan e-tablolar için daha güçlü Protection sınıfını döndüren getProtections(type) işlevini kullanın. Bu yöntemin desteği sonlandırılmış olsa da Sayfalar'ın eski sürümüyle uyumluluk için kullanılabilir.

Geçerli sayfanın izinlerini açıklayan bir PageProtection örneği döndürür.

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

const permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser('user@example.com');

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
const users = permissions.getUsers();
Logger.log(users);

Return

PageProtection: E-tablo erişim izinlerini açıklayan 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

`getTabColor()`

Kullanımdan kaldırıldı. getTabColorObject() ile değiştirildi

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

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

Return

String: CSS notasyonundaki renk kodu ('#ffffff' gibi).

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

`setSheetProtection(permissions)`

Kullanımdan kaldırıldı. Google E-Tablolar'ın daha yeni sürümünde oluşturulan e-tablolar için daha güçlü Protection sınıfını döndüren protect() işlevini kullanın. Bu yöntemin desteği sonlandırılmış olsa da Sayfalar'ın eski sürümüyle uyumluluk için kullanılabilir.

Geçerli sayfanın izinlerini ayarlar.

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

const permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
const sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

Parametreler

Ad	Tür	Açıklama
`permissions`	`PageProtection`	Bu sayfada ayarlanacak erişim izinleri nesnesi.

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