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 verisi 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 e-tabloya 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 notasyonunda 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ı gösterir. |
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. |
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:
getActiveRangeList()
Etkin e-tablodaki etkin aralıkların listesini veya etkin aralık yoksa null
değerini döndürür.
Tek bir aralık seçiliyse bu, getActiveRange()
çağrısı gibi davranır.
const sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. const activeRangeList = sheet.getActiveRangeList();
Return
RangeList
: Etkin aralıkların listesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Aşağıdaki kaynakları da incelemenizi öneririz:
getBandings()
Bu sayfadaki tüm bantları döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the banding info for the sheet. const bandings = sheet.getBandings(); // Gets info on the bandings' second row color and logs it to the console. for (const banding of bandings) { console.log(banding.getSecondRowColor()); }
Return
Banding[]
: Bu e-tablodaki tüm bantlar.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCharts()
Bu sayfadaki grafik dizisini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const charts = sheet.getCharts(); for (const i in charts) { const chart = charts[i]; // Do something with the chart }
Return
EmbeddedChart[]
: Grafik dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroup(columnIndex, groupDepth)
Belirtilen dizinde ve grup derinliğindeki sütun grubunu döndürür.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at column 2 and has a depth of 1, or // null if the group doesn’t exist. const columnGroup = sheet.getColumnGroup(2, 1);
Parametreler
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'den 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
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex)
Sayfada belirtilen konuma boş bir sütun ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Shifts all columns by one sheet.insertColumns(1);
Parametreler
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