E-tablo sayfalarına erişme ve bunları değiştirme Sık kullanılan işlemler, bir sayfayı yeniden adlandırma ve aralığa erişmedir kaldırabilirsiniz.
Yöntemler
Yö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 | Belirtilen anahtar ve görünürlüğe sahip geliştirici meta verilerini sayfaya ekler. |
addDeveloperMetadata(key, value) | Sheet | Belirtilen anahtar ve değere sahip geliştirici meta verilerini sayfaya ekler. |
addDeveloperMetadata(key, value, visibility) | Sheet | Belirtilen anahtar, değer ve görünürlüğe sahip 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ündeyse sayfayı DataSourceSheet , aksi takdirde null olarak döndürür. |
autoResizeColumn(columnPosition) | Sheet | Belirli bir sütunun genişliğini, içeriğine uyacak şekilde ayarlar. |
autoResizeColumns(startColumn, numColumns) | Sheet | İçeriklerine sığması için belirtilen sütun konumundan başlayan tüm sütunların genişliğini ayarlar. |
autoResizeRows(startRow, numRows) | Sheet | Verilen satır konumundan başlayan tüm satırların yüksekliğini, içeriklerinin sığacağı şekilde ayarlar. |
clear() | Sheet | İçerik sayfasını ve biçimlendirme bilgilerini temizler. |
clear(options) | Sheet | Verilen gelişmiş seçeneklerde belirtilen içerik sayfasını ve/veya biçimi temizler. |
clearConditionalFormatRules() | void | Sayfadaki tüm koşullu biçimlendirme kurallarını kaldırır. |
clearContents() | Sheet | Biçimlendirme bilgilerini korurken içindekiler sayfasını temizler. |
clearFormats() | Sheet | İçeriği korurken biçimlendirme sayfasını temizler. |
clearNotes() | Sheet | Tüm notların bulunduğu sayfayı 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 olabilecek belirli bir e-tabloya kopyalar. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Şu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür:
bu sayfadaki bilgilere göz atın. |
createTextFinder(findText) | TextFinder | Sayfa için bir metin bulucu oluşturur ve sayfadaki metni bulup değiştirebilir. |
deleteColumn(columnPosition) | Sheet | Belirtilen sütun konumundaki sütunu siler. |
deleteColumns(columnPosition, howMany) | void | Belirli bir sütun konumundan başlayan bir dizi sütunu siler. |
deleteRow(rowPosition) | Sheet | Verilen satır konumundaki satırı siler. |
deleteRows(rowPosition, howMany) | void | Belirtilen satır konumundan başlayan satır sayısını 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 | Tüm sütun gruplarını belirtilen derinliğe kadar genişletir ve diğer tüm sütun gruplarını daraltır. |
expandRowGroupsUpToDepth(groupDepth) | Sheet | Tüm satır gruplarını belirtilen derinliğe kadar genişletir ve diğer tüm satır gruplarını daraltır. |
getActiveCell() | Range | Bu sayfadaki etkin hücreyi döndürür. |
getActiveRange() | Range | Etkin sayfada seçili aralığı veya etkin bir aralık yoksa null değerini döndürür. |
getActiveRangeList() | RangeList | Etkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null 'i döndürür.
değerleridir. |
getBandings() | Banding[] | Bu sayfadaki tüm şeritleri döndürür. |
getCharts() | EmbeddedChart[] | Bu sayfadaki bir grafik dizisi döndürür. |
getColumnGroup(columnIndex, groupDepth) | Group | Belirtilen dizin 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 | Verilen dizindeki sütunun grup derinliğini döndürür. |
getColumnWidth(columnPosition) | Integer | Belirli bir sütunun piksel cinsinden genişliğini alır. |
getConditionalFormatRules() | ConditionalFormatRule[] | Bu sayfadaki tüm koşullu biçim kurallarını alın. |
getCurrentCell() | 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[] | Sayfa üzerindeki bir çizim dizisini döndürür. |
getFilter() | Filter | Bu sayfadaki filtreyi veya filtre yoksa null değerini döndürür. |
getFormUrl() | String | Yanıtları bu sayfaya gönderen formun URL'sini veya bu URL'ye sahipse null döndürür.
sayfasında ilişkili form yok. |
getFrozenColumns() | Integer | Dondurulmuş sütunların sayısını döndürür. |
getFrozenRows() | Integer | Dondurulmuş satır sayısını döndürür. |
getImages() | OverGridImage[] | Sayfadaki tüm kılavuz üzeri resimleri döndürür. |
getIndex() | Integer | Sayfanın üst e-tablosundaki konumunu alır. |
getLastColumn() | Integer | İçerik barındıran son sütunun konumunu döndürür. |
getLastRow() | Integer | İçerik barındıran son satırın konumunu döndürür. |
getMaxColumns() | Integer | İçeriğinden bağımsız olarak, sayfadaki mevcut sütun sayısını döndürür. |
getMaxRows() | Integer | İçeriğinden bağımsız olarak sayfadaki satırların geçerli sayısını döndürür. |
getName() | String | Sayfanın 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 dizisini veya tek bir öğeyi alır diziyi temsil eder. |
getRange(row, column) | Range | Verilen koordinatlarda sol üstteki hücreyi içeren aralığı döndürür. |
getRange(row, column, numRows) | Range | Verilen koordinatlarda sol üstteki hücreyi ve verilen sayıda hücreyi içeren aralığı döndürür satır. |
getRange(row, column, numRows, numColumns) | Range | Verilen koordinatlarda, verilen sayıda satırla sol üstteki hücreyi içeren aralığı döndürür yardımcı olur. |
getRange(a1Notation) | Range | A1 gösteriminde veya R1C1 notasyonunda belirtilen aralığı döndürür. |
getRangeList(a1Notations) | RangeList | Belirtilen sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür
boş olmayan bir A1 gösterimleriyle veya R1C1 gösterimleriyle ilişkilendirilmelidir. |
getRowGroup(rowIndex, groupDepth) | Group | Verilen dizin 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 | Verilen dizindeki satırın grup derinliğini döndürür. |
getRowHeight(rowPosition) | Integer | Verilen 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 nesnenin temsil ettiği sayfanın kimliğini döndürür. |
getSheetName() | String | Sayfa adını döndürür. |
getSheetValues(startRow, startColumn, numRows, numColumns) | Object[][] | Verilen koordinatlardan başlayarak bu aralık için değerlerin dikdörtgen ızgarasını döndürür. |
getSlicers() | Slicer[] | Sayfada bir dilimleyici dizisi döndürür. |
getTabColorObject() | 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 kılavuz çizgileri gizliyse true değerini döndürür; aksi takdirde false değerini döndürür. |
hideColumn(column) | void | Verilen aralıktaki sütunu veya sütunları gizler. |
hideColumns(columnIndex) | void | Belirtilen dizinde tek bir sütunu gizler. |
hideColumns(columnIndex, numColumns) | void | Belirtilen dizinden başlayarak bir veya daha fazla ardışık 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 başlayarak bir veya daha fazla ardışık satırı gizler. |
hideSheet() | Sheet | Bu sayfayı gizler. |
insertChart(chart) | void | Bu sayfaya yeni bir grafik ekler. |
insertColumnAfter(afterPosition) | Sheet | Verilen sütun konumundan sonra bir sütun ekler. |
insertColumnBefore(beforePosition) | Sheet | Verilen sütun konumundan önce bir sütun ekler. |
insertColumns(columnIndex) | void | Bir sayfada belirtilen konuma boş bir sütun ekler. |
insertColumns(columnIndex, numColumns) | void | Belirtilen konumdan başlayarak sayfaya bir veya daha fazla ardışık boş sütun ekler. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Verilen sütun konumundan sonra belirli sayıda sütun ekler. |
insertColumnsBefore(beforePosition, howMany) | Sheet | Belirtilen sütun konumundan önce bir sayıda sütun ekler. |
insertImage(blobSource, column, row) | OverGridImage | Belirli bir satır ve sütundaki belgeye resim olarak BlobSource ekler. |
insertImage(blobSource, column, row, offsetX, offsetY) | OverGridImage | Belirli bir satır ve sütundaki belgeye resim olarak BlobSource ekler.
piksel uzaklığı. |
insertImage(url, column, row) | OverGridImage | Dokümana belirli bir satır ve sütundaki resim ekler. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Belirli bir satır ve sütunda dokümana bir resim ekler. Bu resim belirli bir piksel uzaklığıyla gösterilir. |
insertRowAfter(afterPosition) | Sheet | Verilen satır konumundan sonra bir satır ekler. |
insertRowBefore(beforePosition) | Sheet | Verilen satır konumundan önce bir satır ekler. |
insertRows(rowIndex) | void | Bir sayfada belirtilen konuma boş bir satır ekler. |
insertRows(rowIndex, numRows) | void | Belirtilen konumdan başlayarak sayfaya bir veya daha fazla ardışık boş satır ekler. |
insertRowsAfter(afterPosition, howMany) | Sheet | Belirtilen satır konumundan sonra birkaç satır ekler. |
insertRowsBefore(beforePosition, howMany) | Sheet | Verilen satır konumundan önce birkaç 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 sayfa için yeni bir grafik oluşturmak üzere bir oluşturucu döndürür. |
protect() | Protection | Sayfayı düzenlemeye karşı koruma sağlayan bir nesne oluşturur: izni gerekir. |
removeChart(chart) | void | Bir grafiği üst sayfadan kaldırır. |
setActiveRange(range) | Range | Belirtilen aralığı, etkin sayfada active range olarak ayarlar ve
current cell olarak aralıkta sol üstteki hücre. |
setActiveRangeList(rangeList) | RangeList | Belirtilen aralık listesini active ranges olarak
etkin sayfada. |
setActiveSelection(range) | Range | Bu sayfa için etkin seçim bölgesini ayarlar. |
setActiveSelection(a1Notation) | Range | A1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi etkin seçimi ayarlar. |
setColumnGroupControlPosition(position) | Sheet | Sayfadaki sütun grubu denetimini açma/kapatma düğmesinin konumunu ayarlar. |
setColumnWidth(columnPosition, width) | Sheet | Belirli bir sütunun genişliğini piksel cinsinden ayarlar. |
setColumnWidths(startColumn, numColumns, width) | Sheet | Belirli sütunların genişliğini piksel cinsinden ayarlar. |
setConditionalFormatRules(rules) | void | Sayfadaki mevcut tüm koşullu biçim kurallarını giriş kurallarıyla değiştirir. |
setCurrentCell(cell) | Range | Belirtilen hücreyi current cell olarak ayarlar. |
setFrozenColumns(columns) | void | Belirtilen sayıda sütunu dondurur. |
setFrozenRows(rows) | void | Belirtilen sayıda satırı dondurur. |
setHiddenGridlines(hideGridlines) | Sheet | Sayfa kılavuz çizgilerini gizler veya ortaya çıkarır. |
setName(name) | Sheet | Sayfa adını ayarlar. |
setRightToLeft(rightToLeft) | Sheet | Sayfa düzenini sağdan sola olarak ayarlar veya ayarı kaldırır. |
setRowGroupControlPosition(position) | Sheet | Sayfadaki satır grubu denetimi açma/kapatma düğmesinin konumunu ayarlar. |
setRowHeight(rowPosition, height) | Sheet | Belirli bir satırın satır yüksekliğini piksel cinsinden ayarlar. |
setRowHeights(startRow, numRows, height) | Sheet | Belirtilen satırların yüksekliğini piksel cinsinden ayarlar. |
setRowHeightsForced(startRow, numRows, height) | Sheet | Belirtilen satırların yüksekliğini piksel cinsinden ayarlar. |
setTabColor(color) | Sheet | Sayfa sekmesi rengini ayarlar. |
setTabColorObject(color) | Sheet | Sayfa sekmesi rengini ayarlar. |
showColumns(columnIndex) | void | Sütunu belirtilen dizinde gösterir. |
showColumns(columnIndex, numColumns) | void | Belirtilen dizinden başlayarak bir veya daha fazla ardışık sütunu gösterir. |
showRows(rowIndex) | void | Belirtilen dizindeki satırı gösterir. |
showRows(rowIndex, numRows) | void | Belirtilen dizinden başlayarak bir veya daha fazla ardışık satırı gösterir. |
showSheet() | Sheet | Sayfayı görünür hale getirir. |
sort(columnPosition) | Sheet | Sayfayı sütuna göre artan düzende sıralar. |
sort(columnPosition, ascending) | Sheet | Sayfayı sütuna göre sıralar. |
unhideColumn(column) | void | Sütunu belirtilen aralıkta gösterir. |
unhideRow(row) | void | Verilen aralıktaki satırı gösterir. |
updateChart(chart) | void | Bu sayfadaki grafiği günceller. |
Ayrıntılı belgeler
activate()
Bu sayfayı etkinleştirir. Sayfanın kendisini değiştirmez, yalnızca üst öğenin etkin öğe kavramını değiştirir. sayfasına gitmelidir.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.activate();
Return
Sheet
— Yeni etkinleştirilen e-tablo.
addDeveloperMetadata(key)
Belirtilen anahtarla geliştirici meta verilerini sayfaya ekler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' to the developer metadata for the sheet. sheet.addDeveloperMetadata('NAME'); // Gets the updated metadata info and logs it to the console. console.log(sheet.getDeveloperMetadata()[0].getKey());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Belirtilen anahtara ve görünürlüğe sahip geliştirici meta verilerini sayfaya ekler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' and sets the developer metadata visibility to PROJECT // for the sheet. sheet.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
visibility | DeveloperMetadataVisibility | Yeni geliştirici meta verilerinin görünürlüğü. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Belirtilen anahtar ve değere sahip geliştirici meta verilerini sayfaya ekler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for the sheet. sheet.addDeveloperMetadata('COMPANY', 'TECH'); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verilerinin değeri. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Belirtilen anahtar, değer ve görünürlüğe sahip geliştirici meta verilerini sayfaya ekler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and sets the // visibility to DOCUMENT for the sheet. sheet.addDeveloperMetadata( 'COMPANY', 'TECH', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verilerinin değeri. |
visibility | DeveloperMetadataVisibility | Yeni geliştirici meta verilerinin görünürlüğü. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
appendRow(rowContents)
Sayfadaki geçerli veri bölgesinin altına bir satır ekler. Hücre içeriği
=
ile tekrar eklendiğinde formül olarak yorumlanır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Appends a new row with 3 columns to the bottom of the current // data region in the sheet containing the values in the array. sheet.appendRow(["a man", "a plan", "panama"]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowContents | Object[] | Sayfadaki son satırdan sonra eklenecek değerler dizisi. |
Return
Sheet
— Yöntem zinciri oluşturmak için yararlı olan e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asDataSourceSheet()
Sayfa SheetType.DATASOURCE
türündeyse sayfayı DataSourceSheet
, aksi takdirde null
olarak döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the data source sheet value if the sheet is of type // SpreadsheetApp.SheetType.DATASOURCE, otherwise this returns a null value. const dataSourceSheet = sheet.asDataSourceSheet(); // Gets the data source sheet value and logs it to the console. console.log(dataSourceSheet); console.log(sheet.getType().toString());
Return
DataSourceSheet
— Bir veri kaynağı sayfası.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
Belirli bir sütunun genişliğini, içeriğine uyacak şekilde ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | Yeniden boyutlandırmak için belirtilen sütunun konumu. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumns(startColumn, numColumns)
İçeriklerine sığması için belirtilen sütun konumundan başlayan tüm sütunların genişliğini ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 columns to a width that fits their text. sheet.autoResizeColumns(1, 15);
Parametreler
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
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeRows(startRow, numRows)
Verilen satır konumundan başlayan tüm satırların yüksekliğini, içeriklerinin sığacağı şekilde ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 rows to a height that fits their text. sheet.autoResizeRows(1, 15);
Parametreler
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
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
İçerik sayfasını ve biçimlendirme bilgilerini temizler.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clear();
Return
Sheet
: Temizlenen sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Verilen gelişmiş seçeneklerde belirtilen içerik sayfasını ve/veya biçimi temizler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.clear({ formatOnly: true, contentsOnly: true });
Parametreler
Ad | Tür | Açıklama |
---|---|---|
options | Object | Aşağıda listelenen gelişmiş seçenekler içeren bir JavaScript haritası. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
contentsOnly | Boolean | İçeriğin temizlenip temizlenmeyeceğini belirler. |
formatOnly | Boolean | Biçimin temizlenip temizlenmeyeceğini belirler. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearConditionalFormatRules()
Sayfadaki tüm koşullu biçimlendirme kurallarını kaldırır. Giriş olarak boş bir diziyle setConditionalFormatRules(rules)
çağrısına eşdeğerdir.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.clearConditionalFormatRules();
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContents()
Biçimlendirme bilgilerini korurken içindekiler sayfasını temizler.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearContents();
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormats()
İçeriği korurken biçimlendirme sayfasını temizler.
Biçimlendirme, verilerin "Biçim" altında bulunan seçeneklerin izin verdiği şekilde biçimlendirilmesini ifade eder menü (ör: kalın, italik, koşullu biçimlendirme) kullanın ve hücre genişliği veya yüksekliği kullanmayın.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearFormats();
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNotes()
Tüm notların bulunduğu sayfayı temizler.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearNotes();
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllColumnGroups()
Sayfadaki tüm sütun gruplarını daraltır.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are collapsed. sheet.collapseAllColumnGroups();
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllRowGroups()
Sayfadaki tüm satır gruplarını daraltır.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are collapsed. sheet.collapseAllRowGroups();
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(spreadsheet)
Sayfayı, kaynakla aynı e-tablo olabilecek belirli bir e-tabloya kopyalar. İlgili içeriği oluşturmak için kullanılan kopyalanan sayfanın adı "[Orijinal ad] kopyası" olarak adlandırılır.
var source = SpreadsheetApp.getActiveSpreadsheet(); var sheet = source.getSheets()[0]; var destination = SpreadsheetApp.openById('ID_GOES HERE'); sheet.copyTo(destination);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
spreadsheet | Spreadsheet | Bu sayfanın kopyalanacağı e-tablo. Bu, gösterir. |
Return
Sheet
— Zincirleme için yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Şu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder
döndürür:
bu sayfadaki bilgilere göz atın. Meta veriler,
veya sayfadaki bir satır, sütun ya da aralıkla ilişkilendirilebilir.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Creates the developer metadata finder. const metadatafinder = sheet.createDeveloperMetadataFinder(); // Finds the metadata with value 'PARIS' and displays its key in the console. console.log(metadatafinder.withValue('PARIS').find()[0].getKey());
Return
DeveloperMetadataFinder
: Bu sayfanın kapsamındaki meta verileri aramak için geliştirici meta veri bulucudur.
createTextFinder(findText)
Sayfa için bir metin bulucu oluşturur ve sayfadaki metni bulup değiştirebilir.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Creates a text finder. var textFinder = sheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the sheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
findText | String | Aranacak metin. |
Return
TextFinder
— Sayfa için TextFinder
.
deleteColumn(columnPosition)
Belirtilen sütun konumundaki sütunu siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | Sütunun, ilk sütun için 1'den başlayan konumu. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Belirli bir sütun konumundan başlayan bir dizi sütunu siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | Silinecek ilk sütunun konumu. |
howMany | Integer | Silinecek sütun sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRow(rowPosition)
Verilen satır konumundaki satırı siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | Satırın, ilk satır için 1'den başlayan konumu. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Belirtilen satır konumundan başlayan satır sayısını siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | Silinecek ilk satırın konumu. |
howMany | Integer | Silinecek satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllColumnGroups()
Sayfadaki tüm sütun gruplarını genişletir. Bu yöntem için en az bir sütun grubu gerekir.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are expanded. sheet.expandAllColumnGroups();
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllRowGroups()
Sayfadaki tüm satır gruplarını genişletir. Bu yöntem için en az bir satır grubu gerekir.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are expanded. sheet.expandAllRowGroups();
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandColumnGroupsUpToDepth(groupDepth)
Tüm sütun gruplarını belirtilen derinliğe kadar genişletir ve diğer tüm sütun gruplarını daraltır.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandColumnGroupsUpToDepth(2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
groupDepth | Integer | Sütun gruplarının genişletileceği grup derinliği. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandRowGroupsUpToDepth(groupDepth)
Tüm satır gruplarını belirtilen derinliğe kadar genişletir ve diğer tüm satır gruplarını daraltır.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandRowGroupsUpToDepth(2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
groupDepth | Integer | Satır gruplarının genişletileceği grup derinliği. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
Bu sayfadaki etkin hücreyi döndürür.
Not: Geçerli parametreyi döndüren getCurrentCell()
kullanılması tercih edilir
vurgulanan hücreyi tıklayın.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Return
Range
- geçerli etkin hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRange()
Etkin sayfada seçili aralığı veya etkin bir aralık yoksa null
değerini döndürür. Eğer
birden çok aralık seçilir. Bu yöntem yalnızca en son seçilen aralığı döndürür.
"Etkin aralık" terimi kullanıcının etkin sayfada seçtiği aralığı ifade eder. Ancak özel işlevde, hücrenin etkin bir şekilde yeniden hesaplandığını ifade eder.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Return
Range
- etkin aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Aşağıdaki kaynakları da incelemenizi öneririz:
getActiveRangeList()
Etkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null
'i döndürür.
değerleridir.
Tek bir aralık seçildiyse bu bir getActiveRange()
çağrısı gibi davranır.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Return
RangeList
— etkin aralıkların listesi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Aşağıdaki kaynakları da incelemenizi öneririz:
getBandings()
Bu sayfadaki tüm şeritleri döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the banding info for the sheet. const bandings = sheet.getBandings(); // Gets info on the bandings' second row color and logs it to the console. for (const banding of bandings) { console.log(banding.getSecondRowColor()); }
Return
Banding[]
— Bu sayfadaki tüm şeritler.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCharts()
Bu sayfadaki bir grafik dizisi döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; // Do something with the chart }
Return
EmbeddedChart[]
: Bir grafik dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroup(columnIndex, groupDepth)
Belirtilen dizin ve grup derinliğindeki sütun grubunu döndürür.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at column 2 and has a depth of 1, or // null if the group doesn’t exist. var columnGroup = sheet.getColumnGroup(2, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnIndex | Integer | Grup kontrolü açma/kapatma düğmesinin sütun dizini veya grup içindeki bir dizin. |
groupDepth | Integer | Grubun derinliği. |
Return
Group
— Kontrol dizinindeki ve derinlikteki sütun grubu veya grup
mevcut değildir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupControlPosition()
Sayfadaki tüm sütun grupları için GroupControlTogglePosition
değerini döndürür.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the column grouping control toggle is shown after the // group. var columnGroupControlPosition = sheet.getColumnGroupControlPosition();
Return
Sütun gruplandırma kontrolünü açma/kapatma düğmesi bu gruptaki gruptan sonra gösterilirse GroupControlTogglePosition
— true
sayfa, aksi takdirde false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupDepth(columnIndex)
Verilen dizindeki sütunun grup derinliğini döndürür.
Grup derinliği, sütunla kaç grubun çakıştığını gösterir. Bu değer, sıfır ve sekiz.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over columns 1 through 3 var groupDepth = sheet.getColumnGroupDepth(1);
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnWidth(columnPosition)
Belirli bir sütunun piksel cinsinden genişliğini alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | İncelenecek sütunun konumu. |
Return
Integer
— Piksel cinsinden sütun genişliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getConditionalFormatRules()
Bu sayfadaki tüm koşullu biçim kurallarını alın.
// Logs the conditional format rules in a sheet. var rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules(); for (var i = 0; i < rules.length; i++) { var rule = rules[i]; Logger.log(rule); }
Return
ConditionalFormatRule[]
— Sayfadaki tüm kuralların dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
Etkin sayfadaki geçerli hücreyi veya geçerli hücre yoksa null
değerini döndürür. İlgili içeriği oluşturmak için kullanılan
geçerli hücre, Google E-Tablolar kullanıcı arayüzünde odağın bulunduğu hücredir. Koyu renkle vurgulanmıştır
kenarlık. Hiçbir zaman birden fazla geçerli hücre yoktur. Kullanıcı bir veya daha fazla hücre aralığı seçtiğinde
seçimdeki hücrelerden biri geçerli hücredir.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Return
Range
— geçerli hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
Verilerin bulunduğu boyutlara karşılık gelen bir Range
döndürür.
Bu, işlevsel olarak A1 ve A1 ile sınırlanan bir Aralık oluşturmaya eşdeğerdir. (Sheet.getLastColumn(), Sheet.getLastRow()).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
Return
Range
- e-tablodaki tüm verileri içeren bir aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Tüm veri kaynağı formüllerini alır.
// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets // file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source formulas on Sheet1. // To get an array of data source formulas for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceFormulas = sheet.getDataSourceFormulas(); // Logs the first data source formula in the array. console.log(dataSourceFormulas[0].getFormula());
Return
DataSourceFormula[]
: Veri kaynağı formüllerinin listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Tüm veri kaynağı pivot tablolarını alır.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source pivot tables on Sheet1. // To get an array of data source pivot tables for the entire // spreadsheet, replace 'sheet' with 'ss'. const dataSourcePivotTables = sheet.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
Return
DataSourcePivotTable[]
: Veri kaynağı pivot tablolarının listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Tüm veri kaynağı tablolarını alır.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of data source tables on Sheet1. // To get an array of data source tables for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceTables = sheet.getDataSourceTables(); // Logs the last completed data execution time on the first data source table. console.log(dataSourceTables[0].getStatus().getLastExecutionTime());
Return
DataSourceTable[]
: Veri kaynağı tablolarının listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Bu sayfayla ilişkili tüm geliştirici meta verilerini alın.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Gets all the developer metadata for the sheet. const developerMetaDataList = sheet.getDeveloperMetadata(); // Logs the developer metadata to the console. for (const developerMetaData of developerMetaDataList) { console.log(developerMetaData.getKey()); }
Return
DeveloperMetadata[]
: Bu sayfayla ilişkili geliştirici meta verileri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDrawings()
Sayfa üzerindeki bir çizim dizisini döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the drawings from the sheet. const allDrawings = sheet.getDrawings(); // Logs the number of drawings present on the sheet. console.log(allDrawings.length);
Return
Drawing[]
: Bu sayfadaki çizimlerin listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Bu sayfadaki filtreyi veya filtre yoksa null
değerini döndürür.
// Gets the filter on the active sheet. let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter();
Return
Filter
— Filtre.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
Yanıtları bu sayfaya gönderen formun URL'sini veya bu URL'ye sahipse null
döndürür.
sayfasında ilişkili form yok.
var sheet = SpreadsheetApp.getActiveSheet(); var url = sheet.getFormUrl();
Return
String
— Yanıtlarını bu sayfaya yerleştiren formun URL'si veya bu durumda null
sayfasının ilişkili bir formu yok.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenColumns()
Dondurulmuş sütunların sayısını döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Return
Integer
- dondurulmuş sütunların sayısı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
Dondurulmuş satır sayısını döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Return
Integer
- dondurulmuş satırların sayısı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getImages()
Sayfadaki tüm kılavuz üzeri resimleri döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the over-the-grid images from Sheet1. // To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead. const images = sheet.getImages(); // For each image, logs the anchor cell in A1 notation. for (const image of images) { console.log(image.getAnchorCell().getA1Notation()); }
Return
OverGridImage[]
: Kılavuz üzeri görüntüler dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIndex()
Sayfanın üst e-tablosundaki konumunu alır. Başlangıç: 1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); // Note that the JavaScript index is 0, but this logs 1 var sheet = ss.getSheets()[0]; // ... because spreadsheets are 1-indexed Logger.log(sheet.getIndex());
Return
Integer
: Sayfanın, üst e-tablosundaki konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
İçerik barındıran son sütunun konumunu döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Return
Integer
: Sayfanın içerik barındıran son sütunu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
İçerik barındıran son satırın konumunu döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Return
Integer
: Sayfanın içerik barındıran son satırı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxColumns()
İçeriğinden bağımsız olarak, sayfadaki mevcut sütun sayısını döndürür.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxColumns());
Return
Integer
: Sayfanın maksimum genişliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxRows()
İçeriğinden bağımsız olarak sayfadaki satırların geçerli sayısını döndürür.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxRows());
Return
Integer
: Sayfanın maksimum yüksekliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getName()
Sayfanın adını döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getName());
Return
String
: Sayfanın adı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
Bu sayfadaki tüm adlandırılmış aralıkları alır.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges(); if (namedRanges.length > 1) { Logger.log(namedRanges[0].getName()); }
Return
NamedRange[]
: Sayfadaki tüm adlandırılmış aralıkların dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getParent()
Bu sayfayı içeren Spreadsheet
değerini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // parent is identical to ss var parent = sheet.getParent();
Return
Spreadsheet
: Üst e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPivotTables()
Bu sayfadaki tüm pivot tabloları döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the pivot table info for the sheet. const pivotTables = sheet.getPivotTables(); // Logs the pivot tables to the console. for (const pivotTable of pivotTables) { console.log(pivotTable.getSourceDataRange().getValues()); }
Return
PivotTable[]
: Bu sayfadaki pivot tablolar.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getProtections(type)
Sayfadaki tüm korumalı aralıkları temsil eden bir nesne dizisini veya tek bir öğeyi alır diziyi temsil eder.
// Remove all range protections in the spreadsheet that the user has permission to edit. var sheet = SpreadsheetApp.getActiveSheet(); var protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove sheet protection from the active sheet, if the user has permission to edit it. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0]; if (protection && protection.canEdit()) { protection.remove(); }
Parametreler
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 tek bir öğe
diziyi temsil eder.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column)
Verilen koordinatlarda sol üstteki hücreyi içeren aralığı döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Passing only two arguments returns a "range" with a single cell. var range = sheet.getRange(1, 1); var values = range.getValues(); Logger.log(values[0][0]);
Parametreler
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 dizine ekleme 1 ile başlar. |
Return
Range
: Yalnızca bu hücreyi içeren bir aralıktır.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows)
Verilen koordinatlarda sol üstteki hücreyi ve verilen sayıda hücreyi içeren aralığı döndürür satır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // When the "numRows" argument is used, only a single column of data is returned. var range = sheet.getRange(1, 1, 3); var values = range.getValues(); // Prints 3 values from the first column, starting from row 1. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Aralığın başlangıç satırı dizini; satır dizine ekleme 1 ile başlar. |
column | Integer | Aralığın sütun dizini; sütun dizine ekleme 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 aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows, numColumns)
Verilen koordinatlarda, verilen sayıda satırla sol üstteki hücreyi içeren aralığı döndürür yardımcı olur.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 3, 3); var values = range.getValues(); // Print values from a 3x3 box. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Aralığın başlangıç satırı dizini; satır dizine ekleme 1 ile başlar. |
column | Integer | Aralığın başlangıç sütun dizini; sütun dizine ekleme 1 ile başlar. |
numRows | Integer | Döndürülecek satır sayısı. |
numColumns | Integer | Döndürülecek sütun sayısı. |
Return
Range
: Belirtilen alana karşılık gelen bir aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
A1 gösteriminde veya R1C1 notasyonunda belirtilen aralığı döndürür.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
a1Notation | String | A1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi döndürülecek aralık. |
Return
Range
- belirlenen konumdaki aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRangeList(a1Notations)
Belirtilen sayfadaki aralıkları temsil eden RangeList
koleksiyonunu döndürür
boş olmayan bir A1 gösterimleriyle veya R1C1 gösterimleriyle ilişkilendirilmelidir.
// Get a list of ranges A1:D4, F1:H4. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
a1Notations | String[] | A1 gösterimi veya R1C1 gösteriminde belirtildiği gibi, döndürülecek aralıkların listesi. |
Return
RangeList
: Belirlenen konumdaki aralık listesi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroup(rowIndex, groupDepth)
Verilen dizin ve grup derinliğindeki satır grubunu döndürür.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at row 2 and has a depth of 1, or // null if the group doesn’t exist. var rowGroup = sheet.getRowGroup(2, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowIndex | Integer | Grup kontrolü açma/kapatma düğmesinin satır dizini veya grup içindeki bir dizin. |
groupDepth | Integer | Grubun derinliği. |
Return
Group
— Kontrol dizinindeki ve derinlikteki satır grubu veya grup
mevcut değildir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupControlPosition()
Sayfadaki tüm satır grupları için GroupControlTogglePosition
değerini döndürür.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the row grouping control toggle is shown after the // group. var rowGroupControlPosition = sheet.getRowGroupControlPosition();
Return
Satır gruplandırma kontrolünü açma/kapatma düğmesi bu sayfada gruptan sonra gösteriliyorsa GroupControlTogglePosition
— true
veya false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupDepth(rowIndex)
Verilen dizindeki satırın grup derinliğini döndürür.
Grup derinliği, satırla kaç grubun çakıştığını gösterir. Sıfır arasında olabilir ve sekiz.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over rows 1 through 3 var groupDepth = sheet.getRowGroupDepth(1);
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
Verilen satırın piksel cinsinden yüksekliğini alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
E-tablodaki geçerli Selection
değerini döndürür.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Return
Selection
- geçerli seçim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetId()
Bu nesnenin temsil ettiği sayfanın kimliğini döndürür.
Bu, e-tabloya özgü olan sayfanın kimliğidir. Kimlik, tek tip bir
Sayfa konumundan bağımsız olarak sayfa oluşturma zamanında atanan, artan tam sayı. Bu
değeri, Sheet
örneği yerine gridId
parametresi alan Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
gibi yöntemlerle birlikte kullanışlıdır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Return
Integer
- E-tabloya özgü sayfa kimliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
Sayfa adını döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Return
String
— sayfanın adı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
Verilen koordinatlardan başlayarak bu aralık için değerlerin dikdörtgen ızgarasını döndürür. A -1 satır veya sütun konumu olarak verilen değer, en son satırı veya sütunu almaya eşdeğerdir yer alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
startRow | Integer | Başlangıç satırının konumu. |
startColumn | Integer | Başlangıç sütununun konumu. |
numRows | Integer | Değer döndürülecek satır sayısı. |
numColumns | Integer | Değer döndürülecek sütun sayısı. |
Return
Object[][]
: İki boyutlu bir değer dizisi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSlicers()
Sayfada bir dilimleyici dizisi döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all slicers in the spreadsheet. const slicers = sheet.getSlicers(); // Logs the slicer titles to the console. for (const slicer of slicers) { console.log(slicer.getTitle()); }
Return
Slicer[]
— Bu sayfadaki dilimleyicilerin listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTabColorObject()
Sayfa sekmesi rengini veya sayfa sekmesinde renk yoksa null
değerini alır.
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var color = first.getTabColorObject();
Return
Color
: Sayfa sekmesi rengi veya sayfa sekmesinde renk yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getType()
Sayfanın türünü döndürür.
Varsayılan sayfa türü SheetType.GRID
şeklindedir. Tek bir yerleştirilmiş öğe içeren bir sayfa
EmbeddedChart
gibi bir nesne SheetType.OBJECT
sayfasıdır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getType());
Return
SheetType
— Sayfanın türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hasHiddenGridlines()
Sayfanın kılavuz çizgileri gizliyse true
değerini döndürür; aksi takdirde false
değerini döndürür.
Kılavuz çizgileri varsayılan olarak görünür durumdadır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Checks if the spreadsheet has hidden gridelines and logs the result to the console. console.log(sheet.hasHiddenGridlines());
Return
Boolean
— Kılavuz çizgileri gizliyse true
; Aksi takdirde false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Verilen aralıktaki sütunu veya sütunları gizler.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Range | Gizlenecek sütun aralığı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex)
Belirtilen dizinde tek bir sütunu gizler. Bu yöntem için 1-dizin kullanın.
Dizin kullanarak birden fazla sütunu gizlemek için hideColumns(columnIndex, numColumns)
işlevini kullanın.
Aralık kullanarak birden fazla sütunu gizlemek için hideColumn()
işlevini kullanın.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Hides the first column sheet.hideColumns(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnIndex | Integer | Gizlenecek sütunun dizini. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex, numColumns)
Belirtilen dizinden başlayarak bir veya daha fazla ardışık sütunu gizler. Bu yöntem için 1-dizin kullanın.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three columns sheet.hideColumns(1, 3);
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRow(row)
Belirtilen aralıktaki satırları gizler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Range | Gizlenecek satır aralığı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex)
Belirtilen dizindeki satırı gizler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first row sheet.hideRows(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowIndex | Integer | Gizlenecek satırın dizini. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex, numRows)
Belirtilen dizinden başlayarak bir veya daha fazla ardışık satırı gizler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three rows sheet.hideRows(1, 3);
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideSheet()
Bu sayfayı gizler. Sayfa zaten gizliyse herhangi bir etkisi olmaz. Bu yöntem bir istisna oluşturur.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.hideSheet();
Return
Sheet
— Geçerli sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertChart(chart)
Bu sayfaya yeni bir grafik ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates a simple bar chart from the first three rows // of the first two columns of the spreadsheet var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B4")) .setPosition(5, 5, 0, 0) .setOption("title", "Dynamic Chart") .build(); sheet.insertChart(chart);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
chart | EmbeddedChart | Eklenecek grafik. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
Verilen sütun konumundan sonra bir sütun ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
afterPosition | Integer | Kendisinden sonra yeni sütunun ekleneceği sütun. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Verilen sütun konumundan önce bir sütun ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
beforePosition | Integer | Kendisine yeni sütunun eklenmesi gereken sütun. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex)
Bir sayfada belirtilen konuma boş bir sütun ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all columns by one sheet.insertColumns(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnIndex | Integer | Sütunun nereye ekleneceğini gösteren dizin. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex, numColumns)
Belirtilen konumdan başlayarak sayfaya bir veya daha fazla ardışık boş sütun ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all columns by three sheet.insertColumns(1, 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnIndex | Integer | Sütunun nereye ekleneceğini gösteren dizin. |
numColumns | Integer | Eklenecek sütun sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
Verilen sütun konumundan sonra belirli sayıda sütun ekler.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Inserts two columns after the first column on the first sheet of the spreadsheet. sheet.insertColumnsAfter(1,2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
afterPosition | Integer | Kendisinden sonra yeni sütunun ekleneceği sütun. |
howMany | Integer | Eklenecek sütun sayısı. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
Belirtilen sütun konumundan önce bir sayıda sütun ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
beforePosition | Integer | Kendisine yeni sütunun eklenmesi gereken sütun. |
howMany | Integer | Eklenecek sütun sayısı. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row)
Belirli bir satır ve sütundaki belgeye resim olarak BlobSource
ekler. Resim
boyutu blob içeriklerinden alınır. Desteklenen maksimum blob boyutu 2 MB'tır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blobSource | BlobSource | Resim içeriklerini, 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row, offsetX, offsetY)
Belirli bir satır ve sütundaki belgeye resim olarak BlobSource
ekler.
piksel uzaklığı. Resim boyutu blob içeriklerinden alınır. Desteklenen maksimum blob
boyut 2 MB'tır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blobSource | BlobSource | Resim içeriklerini, 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öşesinden yatay uzaklık (piksel cinsinden). |
offsetY | Integer | Hücre köşesinden dikey uzaklık (piksel cinsinden). |
Return
OverGridImage
— Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row)
Dokümana belirli bir satır ve sütundaki resim ekler.
Sağlanan URL herkesin erişimine açık olmalıdır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
Belirli bir satır ve sütunda dokümana bir resim ekler. Bu resim belirli bir piksel uzaklığıyla gösterilir.
Sağlanan URL herkesin erişimine açık olmalıdır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
Parametreler
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öşesinden yatay uzaklık (piksel cinsinden). |
offsetY | Integer | Hücre köşesinden dikey uzaklık (piksel cinsinden). |
Return
OverGridImage
— Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowAfter(afterPosition)
Verilen satır konumundan sonra bir satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
afterPosition | Integer | Kendisinden sonra yeni satırın ekleneceği satır. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
Verilen satır konumundan önce bir satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
beforePosition | Integer | Kendisine yeni satırın eklenmesi gereken satır. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex)
Bir sayfada belirtilen konuma boş bir satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by one sheet.insertRows(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowIndex | Integer | Satırın nereye ekleneceğini gösteren dizin. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex, numRows)
Belirtilen konumdan başlayarak sayfaya bir veya daha fazla ardışık boş satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by three sheet.insertRows(1, 3);
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
Belirtilen satır konumundan sonra birkaç satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Parametreler
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 zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
Verilen satır konumundan önce birkaç satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
beforePosition | Integer | Kendisine yeni satırların ekleneceği satır. |
howMany | Integer | Eklenecek satır sayısı. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos)
Bu sayfaya yeni bir dilimleyici ekler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range of the sheet. const range = sheet.getRange('A1:D10'); // Inserts the slicer with a random range into the sheet. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10); // Logs the insert slicer result to the console. console.log(insertSlicers);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Dilimleyici dilimleyicinin oluşturulduğu aralık. |
anchorRowPos | Integer | Dilimleyicinin üst tarafı bu satıra sabitlenir. |
anchorColPos | Integer | Dilimleyicinin üst tarafı bu sütuna sabitlenir. |
Return
Slicer
— Yeni eklenen dilimleyici.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)
Bu sayfaya yeni bir dilimleyici ekler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range. const range = sheet.getRange('A1:D10'); // Inserts a slicer using the random range function. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0); // Logs the insert slicer result to the console. console.log(insertSlicers);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Dilimleyici dilimleyicinin oluşturulduğu aralık. |
anchorRowPos | Integer | Dilimleyicinin üst tarafı bu satıra sabitlenir. |
anchorColPos | Integer | Dilimleyicinin üst tarafı bu sütuna sabitlenir. |
offsetX | Integer | Hücre köşesinden yatay uzaklık (piksel cinsinden). |
offsetY | Integer | Hücre köşesinden dikey uzaklık (piksel cinsinden). |
Return
Slicer
— Yeni eklenen dilimleyici.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isColumnHiddenByUser(columnPosition)
Belirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | İncelenecek sütunun konumu. |
Return
Boolean
— Sütun gizliyse true
, gizliyse false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRightToLeft()
Bu sayfa düzeni sağdan sola ise true
değerini döndürür. Sayfa, false
değerini döndürür
varsayılan soldan sağa düzeni kullanır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Checks if a spreadsheet is ordered from right to left and logs the result to the console. console.log(sheet.isRightToLeft());
Return
Boolean
— Sağdan solaysa true
; Aksi takdirde false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
Belirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | İncelenecek satırın konumu. |
Return
Boolean
— Satır gizliyse true
, gizliyse false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByUser(rowPosition)
Belirtilen satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByUser(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | İncelenecek satırın konumu. |
Return
Boolean
— Satır gizliyse true
, gizliyse false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isSheetHidden()
Sayfa şu anda gizliyse true
değerini döndürür.
var sheet = SpreadsheetApp.getActiveSheet(); if (sheet.isSheetHidden()) { // do something... }
Return
Boolean
— Sayfa gizliyse true
, gizliyse false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveColumns(columnSpec, destinationIndex)
Belirtilen aralık tarafından seçilen sütunları destinationIndex
ile belirtilen konuma taşır. columnSpec
öğesinin kendisinin, reklam öğesinin tamamını
sütun veya taşınacak sütun grubudur; aralığın kapsadığı tüm sütunları seçer.
// The code below moves rows A-B to destination index 5. // This results in those columns becoming columns C-D. var sheet = SpreadsheetApp.getActiveSheet(); // Selects column A and column B to be moved. var columnSpec = sheet.getRange("A1:B1"); sheet.moveColumns(columnSpec, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnSpec | Range | Taşınması gereken sütunları kapsayan aralık. |
destinationIndex | Integer | Sütunların taşınması gereken dizin. Bu dizinin koordinatlara göre belirlenebilir. Mevcut veriler sağdan kaynak sütunlar ızgaradan kaldırılırken taşınan sütunlara yer açın. Bu nedenle, veriler başlangıçta belirtilenden farklı bir dizine sahip olabilir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveRows(rowSpec, destinationIndex)
Belirtilen aralık tarafından seçilen satırları destinationIndex
ile belirtilen konuma taşır. rowSpec
öğesinin kendisinin, tüm satırı tam olarak temsil etmesi gerekmez.
veya taşınacak satır grubudur. Aralığın kapsadığı tüm satırları seçer.
// The code below moves rows 1-2 to destination index 5. // This results in those rows becoming rows 3-4. var sheet = SpreadsheetApp.getActiveSheet(); // Selects row 1 and row 2 to be moved. var rowSpec = sheet.getRange("A1:A2"); sheet.moveRows(rowSpec, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowSpec | Range | Taşınması gereken satırları kapsayan aralık. |
destinationIndex | Integer | Satırların taşınması gereken dizin. Bu dizinin koordinatlara göre otomatik olarak oluşturulur. Mevcut veriler aşağı kaydırılır ve kaynak satırlar ızgaradan kaldırılırken taşınan satırlar için yer açın. Dolayısıyla, veriler başlangıçta belirtilenden farklı bir dizine eklenebilir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
newChart()
Bu sayfa için yeni bir grafik oluşturmak üzere bir oluşturucu döndürür.
Bu örnekte, yeni bir grafiğin nasıl oluşturulacağı gösterilmektedir:
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B8"); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setPosition(2, 2, 0, 0) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build());
Return
EmbeddedChartBuilder
: Yeni grafik oluşturmak için kullanılan bir oluşturucu.
protect()
Sayfayı düzenlenmeye karşı koruyabilecek,
izni gerekir. Komut dosyası, e-tablo için düzenleyenler listesini gerçekten değiştirene kadar (
Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
veya yeni bir
Protection.setDomainEdit(editable)
değeri için geçerliyse bu izinler,
(bu, sayfanın korunmadığı anlamına gelir.) Sayfa
zaten korunduğundan bu yöntem, mevcut koruma ayarlarını temsil eden bir nesne döndürür.
Korunan sayfalar, korumasız bölgeler içerebilir.
// Protect the active sheet, then remove all other users from the list of editors. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.protect().setDescription('Sample protected sheet'); // Ensure the current user is an editor before removing others. Otherwise, if the user's edit // permission comes from a group, the script throws an exception upon removing the group. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
Return
Protection
: Koruma ayarlarını temsil eden bir nesne.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeChart(chart)
Bir grafiği üst sayfadan kaldırır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This removes all the embedded charts from the spreadsheet var charts = sheet.getCharts(); for (var i in charts) { sheet.removeChart(charts[i]); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
chart | EmbeddedChart | Kaldırılacak grafik. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
Belirtilen aralığı, etkin sayfada active range
olarak ayarlar ve
current cell
olarak aralıkta sol üstteki hücre.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRangeList(rangeList)
Belirtilen aralık listesini active ranges
olarak
etkin sayfada. Listedeki son aralık active range
olarak ayarlandı.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(range)
Bu sayfa için etkin seçim bölgesini ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(a1Notation)
A1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi etkin seçimi ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
a1Notation | String | A1 gösteriminde veya R1C1 notasyonunda belirtildiği şekilde etkin olarak ayarlanacak aralık. |
Return
Range
- yeni etkin aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnGroupControlPosition(position)
Sayfadaki sütun grubu denetimini açma/kapatma düğmesinin konumunu ayarlar.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setColumnGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
position | GroupControlTogglePosition | Sütun grubu kontrolünü açma/kapatma düğmesinin konumu. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnPosition, width)
Belirli bir sütunun genişliğini piksel cinsinden ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | Ayarlanacak sütunun konumu. |
width | Integer | Piksel cinsinden ayarlanacak genişlik. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidths(startColumn, numColumns, width)
Belirli sütunların genişliğini piksel cinsinden ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three columns to a width of 200 pixels sheet.setColumnWidths(1, 3, 200);
Parametreler
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 | Piksel cinsinden ayarlanacak genişlik. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setConditionalFormatRules(rules)
Sayfadaki mevcut tüm koşullu biçim kurallarını giriş kurallarıyla değiştirir. Kurallar giriş sırasına göre değerlendirilir.
// Remove one of the existing conditional format rules. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); rules.splice(1, 1); // Deletes the 2nd format rule. sheet.setConditionalFormatRules(rules);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rules | ConditionalFormatRule[] | Yeni koşullu biçim kuralları. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setCurrentCell(cell)
Belirtilen hücreyi current cell
olarak ayarlar.
Belirtilen hücre önceden seçilmiş bir aralıkta yer alıyorsa bu aralık hücrenin geçerli hücre olduğu etkin aralık.
Belirtilen hücre seçilen aralıklarda bulunmuyorsa mevcut seçimler şu şekildedir: kaldırılır ve hücre, geçerli hücre ve etkin aralık olur.
Not:Belirtilen Range
tek bir hücreden oluşmalıdır, aksi takdirde
kabul edersiniz.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Parametreler
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenColumns(columns)
Belirtilen sayıda sütunu dondurur. Sıfır ise hiçbir sütun dondurulmaz.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first column sheet.setFrozenColumns(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columns | Integer | Dondurulacak sütun sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenRows(rows)
Belirtilen sayıda satırı dondurur. Sıfır ise hiçbir satır dondurulmaz.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rows | Integer | Dondurulacak satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHiddenGridlines(hideGridlines)
Sayfa kılavuz çizgilerini gizler veya ortaya çıkarır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can us eSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Hides the gridlines in the sheet. sheet.setHiddenGridlines(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
hideGridlines | Boolean | true ise bu sayfadaki kılavuz çizgilerini gizleyin; Aksi takdirde
yardımcı olabilir. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
Sayfa adını ayarlar.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setName("not first anymore");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Sayfanın yeni adı. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRightToLeft(rightToLeft)
Sayfa düzenini sağdan sola olarak ayarlar veya ayarı kaldırır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets the sheet layout, so that the sheet is ordered from right to left. sheet.setRightToLeft(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rightToLeft | Boolean | true ise, sayfa düzeni sağdan sola olacak şekilde ayarlanır ve A1 hücresi en üstte olacak şekilde
tıklayın. false ise sayfa düzeni varsayılana ayarlanır.
soldan sağa, A1 hücresi sol üstte olacak şekilde. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowGroupControlPosition(position)
Sayfadaki satır grubu denetimi açma/kapatma düğmesinin konumunu ayarlar.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
position | GroupControlTogglePosition | Satır grubu kontrolü açma/kapatma düğmesinin konumu. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
Belirli bir satırın satır yüksekliğini piksel cinsinden ayarlar. Varsayılan olarak, satırlar hücre içeriğine sığacak şekilde büyür. Eğer
satırları belirli bir yüksekliğe zorlamak istiyorsanız setRowHeightsForced(startRow, numRows, height)
değerini kullanın.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first row to a height of 200 pixels sheet.setRowHeight(1, 200);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | Değiştirilecek satır konumu. |
height | Integer | Ayarlanacak yükseklik (piksel cinsinden). |
Return
Sheet
— Yöntem zinciri oluşturmak için yararlı olan e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeights(startRow, numRows, height)
Belirtilen satırların yüksekliğini piksel cinsinden ayarlar. Varsayılan olarak, satırlar hücre içeriğine sığacak şekilde büyür. Şu durumda:
satırları belirli bir yüksekliğe zorlamak istiyorsanız setRowHeightsForced(startRow, numRows, height)
değerini kullanın.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 20 pixels sheet.setRowHeights(1, 3, 20);
Parametreler
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 yükseklik (piksel cinsinden). |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeightsForced(startRow, numRows, height)
Belirtilen satırların yüksekliğini piksel cinsinden ayarlar. Varsayılan olarak, satırlar hücre içeriğine sığacak şekilde büyür. Zaman
setRowHeightsForced
kullandığınızda satır öğeleri,
hücre içeriğinin satır yüksekliğinden
uzun olduğunu düşünelim.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 5 pixels. sheet.setRowHeightsForced(1, 3, 5);
Parametreler
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 yükseklik (piksel cinsinden). |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColor(color)
Sayfa sekmesi rengini ayarlar.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setTabColor("ff0000"); // Set the color to red. first.setTabColor(null); // Unset the color.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS gösteriminde bir renk kodu (ör. '#ffffff' veya 'white' ) veya
Sekme rengini sıfırlamak için null . |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColorObject(color)
Sayfa sekmesi rengini ayarlar.
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); first.setTabColorObject(color); // Set the color to theme accent 1. first.setTabColorObject(null); // Unset the color.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | Color | Ayarlanacak sayfa sekmesi rengi. |
Return
Sheet
— Bu sayfa, zincirleme işlemeyle ilgilidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex)
Sütunu belirtilen dizinde gösterir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first column sheet.showColumns(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnIndex | Integer | Gösterilecek sütunun dizini. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex, numColumns)
Belirtilen dizinden başlayarak bir veya daha fazla ardışık sütunu gösterir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three columns sheet.showColumns(1, 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnIndex | Integer | Gösterilecek sütunların başlangıç dizini. |
numColumns | Integer | Gösterilecek sütun sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex)
Belirtilen dizindeki satırı gösterir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first row sheet.showRows(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowIndex | Integer | Gösterilecek satırın dizini. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex, numRows)
Belirtilen dizinden başlayarak bir veya daha fazla ardışık satırı gösterir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three rows sheet.showRows(1, 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowIndex | Integer | Gösterilecek satırların başlangıç dizini. |
numRows | Integer | Gösterilecek satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showSheet()
Sayfayı görünür hale getirir. Sayfa zaten görünür durumdaysa herhangi bir etkisi olmaz.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.showSheet();
Return
Sheet
— Geçerli sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition)
Sayfayı sütuna göre artan düzende sıralar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | Sıralama ölçütü olarak kullanılacak sütun. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
Sayfayı sütuna göre sıralar. Artan veya azalan düzeni belirtmek için bir parametre alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Parametreler
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 zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideColumn(column)
Sütunu belirtilen aralıkta gösterir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Range | Gizliyse, gösterilecek aralık. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideRow(row)
Verilen aralıktaki satırı gösterir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideRow(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Range | Gizliyse, gösterilecek aralık. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateChart(chart)
Bu sayfadaki grafiği günceller.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This code is going to loop through all the charts and change them to // column charts var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; var newChart = chart .modify() .setChartType(Charts.ChartType.COLUMN) .build(); sheet.updateChart(newChart); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
chart | EmbeddedChart | Güncellenecek grafik. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets