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