Class Spreadsheet

E-tablo

Google E-Tablolar dosyalarına erişebilir ve bu dosyaları değiştirebilir. Genel işlemler, yeni e-tablolar eklemek ve ortak çalışanlar eklemektir.

Yöntemler

YöntemDönüş türüKısa açıklama
addDeveloperMetadata(key)SpreadsheetBelirtilen anahtarla geliştirici meta verilerini üst düzey e-tabloya ekler.
addDeveloperMetadata(key, visibility)SpreadsheetBelirtilen anahtar ve görünürlükle birlikte geliştirici meta verilerini e-tabloya ekler.
addDeveloperMetadata(key, value)SpreadsheetBelirtilen anahtar ve değeri içeren geliştirici meta verilerini e-tabloya ekler.
addDeveloperMetadata(key, value, visibility)SpreadsheetBelirtilen anahtar, değer ve görünürlükle birlikte geliştirici meta verilerini e-tabloya ekler.
addEditor(emailAddress)SpreadsheetKullanıcıyı Spreadsheet düzenleyici listesine ekler.
addEditor(user)SpreadsheetKullanıcıyı Spreadsheet düzenleyici listesine ekler.
addEditors(emailAddresses)SpreadsheetBelirtilen kullanıcı dizisini, Spreadsheet düzenleyicisi listesine ekler.
addMenu(name, subMenus)voidE-tablo kullanıcı arayüzünde yeni bir menü oluşturur.
addViewer(emailAddress)SpreadsheetKullanıcıyı Spreadsheet öğesini görüntüleyenler listesine ekler.
addViewer(user)SpreadsheetKullanıcıyı Spreadsheet öğesini görüntüleyenler listesine ekler.
addViewers(emailAddresses)SpreadsheetBelirtilen kullanıcı dizisini, Spreadsheet için görüntüleyen listesine ekler.
appendRow(rowContents)SheetSayfadaki geçerli veri bölgesinin en altına bir satır ekler.
autoResizeColumn(columnPosition)SheetBelirli bir sütunun genişliğini, içeriğine sığacak şekilde ayarlar.
copy(name)SpreadsheetE-tabloyu kopyalar ve yeni e-tabloyu döndürür.
createDeveloperMetadataFinder()DeveloperMetadataFinderBu e-tablonun kapsamında geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür.
createTextFinder(findText)TextFinderE-tablo için bir metin bulucu oluşturur. Bu metin bulucu, e-tablodaki metinleri bulup değiştirmek için kullanılabilir.
deleteActiveSheet()SheetO anda etkin olan sayfayı siler.
deleteColumn(columnPosition)SheetBelirtilen sütun konumundaki sütunu siler.
deleteColumns(columnPosition, howMany)voidBelirtilen sütun konumundan başlayarak belirli bir sayıda sütunu siler.
deleteRow(rowPosition)SheetBelirtilen satır konumundaki satırı siler.
deleteRows(rowPosition, howMany)voidBelirtilen satır konumundan başlayan sayıda satırı siler.
deleteSheet(sheet)voidBelirtilen sayfayı siler.
duplicateActiveSheet()SheetEtkin sayfayı kopyalar ve etkin sayfa haline getirir.
getActiveCell()RangeBu sayfadaki etkin hücreyi döndürür.
getActiveRange()RangeEtkin sayfada seçilen aralığı veya etkin aralık yoksa null değerini döndürür.
getActiveRangeList()RangeListEtkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null değerini döndürür.
getActiveSheet()SheetBir e-tablodaki etkin sayfayı alır.
getAs(contentType)BlobBu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün.
getBandings()Banding[]Bu e-tablodaki tüm bantları döndürür.
getBlob()BlobBu nesnenin içindeki verileri blob olarak döndürün.
getColumnWidth(columnPosition)IntegerBelirli bir sütunun genişliğini piksel olarak alır.
getCurrentCell()RangeEtkin sayfadaki geçerli hücreyi veya geçerli hücre yoksa null değerini döndürür.
getDataRange()RangeVerilerin bulunduğu boyutlara karşılık gelen bir Range döndürür.
getDataSourceFormulas()DataSourceFormula[]Tüm veri kaynağı formüllerini alır.
getDataSourcePivotTables()DataSourcePivotTable[]Tüm veri kaynağı pivot tablolarını alır.
getDataSourceRefreshSchedules()DataSourceRefreshSchedule[]Bu e-tablonun yenileme programlarını alır.
getDataSourceSheets()DataSourceSheet[]E-tablodaki tüm veri kaynağı sayfalarını döndürür.
getDataSourceTables()DataSourceTable[]Tüm veri kaynağı tablolarını alır.
getDataSources()DataSource[]E-tablodaki tüm veri kaynaklarını döndürür.
getDeveloperMetadata()DeveloperMetadata[]Üst düzey e-tabloyla ilişkilendirilen geliştirici meta verilerini alır.
getEditors()User[]Bu Spreadsheet için düzenleyenlerin listesini alır.
getFormUrl()StringYanıtlarını bu e-tabloya gönderen formun URL'sini veya bu e-tablonun ilişkilendirilmiş bir formu yoksa null değerini döndürür.
getFrozenColumns()IntegerDondurulmuş sütunların sayısını döndürür.
getFrozenRows()IntegerDondurulmuş satırların sayısını döndürür.
getId()StringBu e-tablo için benzersiz bir tanımlayıcı alır.
getImages()OverGridImage[]Sayfadaki tüm ızgara içi resimleri döndürür.
getIterativeCalculationConvergenceThreshold()NumberYinelemeli hesaplama sırasında kullanılan eşik değerini döndürü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.
getMaxIterativeCalculationCycles()IntegerYinelemeli hesaplama sırasında kullanılacak maksimum yineleme sayısını döndürür.
getName()StringBelgenin adını alır.
getNamedRanges()NamedRange[]Bu e-tablodaki tüm adlandırılmış aralıkları alır.
getNumSheets()IntegerBu e-tablodaki sayfa sayısını döndürür.
getOwner()UserDokümanın sahibini veya ortak Drive'daki bir doküman için null değerini döndürür.
getPredefinedSpreadsheetThemes()SpreadsheetTheme[]Önceden tanımlanmış temaların listesini döndürür.
getProtections(type)Protection[]E-tablodaki tüm korunan aralıkları veya sayfaları temsil eden bir nesne dizisini alır.
getRange(a1Notation)RangeAralığı A1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi döndürür.
getRangeByName(name)RangeAdlandırılmış aralık veya belirtilen ada sahip herhangi bir aralık bulunmazsa null döndürür.
getRangeList(a1Notations)RangeListAynı sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür.
getRecalculationInterval()RecalculationIntervalBu e-tabloya ilişkin hesaplama aralığını döndürür.
getRowHeight(rowPosition)IntegerBelirli bir satırın piksel cinsinden yüksekliğini alır.
getSelection()SelectionE-tablodaki geçerli Selection değerini döndürür.
getSheetByName(name)SheetBelirtilen ada sahip bir sayfa döndürür.
getSheetId()IntegerBu nesnenin temsil ettiği sayfanın kimliğini döndürür.
getSheetName()StringSayfa 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.
getSheets()Sheet[]Bu e-tablodaki tüm sayfaları alır.
getSpreadsheetLocale()StringE-tablo yerel ayarını alır.
getSpreadsheetTheme()SpreadsheetThemeE-tablonun geçerli temasını veya herhangi bir tema uygulanmazsa null değerini döndürür.
getSpreadsheetTimeZone()StringE-tablonun saat dilimini alır.
getUrl()StringBelirli e-tablonun URL'sini döndürür.
getViewers()User[]Bu Spreadsheet için görüntüleyenlerin ve yorum yapanların listesini alır.
hideColumn(column)voidBelirli bir aralıktaki sütunu veya sütunları gizler.
hideRow(row)voidVerilen aralıktaki satırları gizler.
insertColumnAfter(afterPosition)SheetBelirtilen sütun konumundan sonra bir sütun ekler.
insertColumnBefore(beforePosition)SheetBelirtilen sütun konumundan önce bir sütun ekler.
insertColumnsAfter(afterPosition, howMany)SheetBelirtilen sütun konumundan sonra belirtilen sayıda sütun ekler.
insertColumnsBefore(beforePosition, howMany)SheetBelirtilen sütun konumundan önce belirli sayıda sütun ekler.
insertDataSourceSheet(spec)DataSourceSheetE-tabloya yeni bir DataSourceSheet ekler ve veri yürütme işlemini başlatır.
insertImage(blobSource, column, row)OverGridImageDokümanda belirli bir satır ve sütunda resim olarak bir Spreadsheet ekler.
insertImage(blobSource, column, row, offsetX, offsetY)OverGridImageDokümanda belirli bir satır ve sütunda, piksel ofseti ile resim olarak Spreadsheet ekler.
insertImage(url, column, row)OverGridImageDokümana belirli bir satıra ve sütuna resim ekler.
insertImage(url, column, row, offsetX, offsetY)OverGridImageDokümanda belirli bir satır ve sütunda, piksel ofsetiyle bir resim ekler.
insertRowAfter(afterPosition)SheetBelirtilen satır konumundan sonra bir satır ekler.
insertRowBefore(beforePosition)SheetBelirtilen satır konumundan önce bir satır ekler.
insertRowsAfter(afterPosition, howMany)SheetBelirtilen satır konumundan sonraya belirli sayıda satır ekler.
insertRowsBefore(beforePosition, howMany)SheetBelirtilen satır konumundan önceye belirli sayıda satır ekler.
insertSheet()SheetVarsayılan sayfa adını kullanarak e-tabloya yeni bir sayfa ekler.
insertSheet(sheetIndex)SheetBelirtilen dizindeki e-tabloya yeni bir sayfa ekler.
insertSheet(sheetIndex, options)SheetBelirtilen dizindeki e-tabloya yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır.
insertSheet(options)SheetVarsayılan sayfa adı ve isteğe bağlı gelişmiş bağımsız değişkenler kullanarak e-tabloya yeni bir sayfa ekler.
insertSheet(sheetName)SheetE-tabloya belirtilen adla yeni bir sayfa ekler.
insertSheet(sheetName, sheetIndex)SheetE-tabloya, verilen dizinde belirtilen adla yeni bir sayfa ekler.
insertSheet(sheetName, sheetIndex, options)SheetE-tabloya, belirtilen dizinde belirtilen adla yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır.
insertSheet(sheetName, options)SheetE-tabloya belirtilen adla yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır.
insertSheetWithDataSourceTable(spec)SheetE-tabloya yeni bir sayfa ekler, belirtilen veri kaynağı spesifikasyonuyla sayfanın tamamını kapsayan bir DataSourceTable oluşturur ve veri yürütme işlemini başlatır.
isColumnHiddenByUser(columnPosition)BooleanBelirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.
isIterativeCalculationEnabled()BooleanBu e-tabloda yinelemeli hesaplamanın etkin olup olmadığını döndürür.
isRowHiddenByFilter(rowPosition)BooleanBelirli bir satırın bir filtre tarafından gizlenip gizlenmediğini döndürür (filtre görünümü değil).
isRowHiddenByUser(rowPosition)BooleanBelirli bir satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.
moveActiveSheet(pos)voidEtkin sayfayı, sayfa listesinde belirli bir konuma taşır.
moveChartToObjectSheet(chart)SheetYeni bir SheetType.OBJECT sayfası oluşturur ve sağlanan grafiği bu e-tabloya taşır.
refreshAllDataSources()voidGeçersiz veri kaynağı nesnelerini atlayarak desteklenen tüm veri kaynaklarını ve bunlara bağlı veri kaynağı nesnelerini yeniler.
removeEditor(emailAddress)SpreadsheetKullanıcıyı, Spreadsheet düzenleyici listesinden kaldırır.
removeEditor(user)SpreadsheetKullanıcıyı, Spreadsheet düzenleyici listesinden kaldırır.
removeMenu(name)voidaddMenu(name, subMenus) tarafından eklenen menüyü kaldırır.
removeNamedRange(name)voidVerilen ada sahip olan adlandırılmış bir aralığı siler.
removeViewer(emailAddress)Spreadsheetİlgili kullanıcıyı, Spreadsheet için görüntüleyenler ve yorum yapanlar listesinden kaldırır.
removeViewer(user)Spreadsheetİlgili kullanıcıyı, Spreadsheet için görüntüleyenler ve yorum yapanlar listesinden kaldırır.
rename(newName)voidDokümanı yeniden adlandırır.
renameActiveSheet(newName)voidGeçerli etkin sayfayı verilen yeni adla yeniden adlandırır.
resetSpreadsheetTheme()SpreadsheetThemeUygulanan temayı kaldırır ve e-tablodaki varsayılan temayı ayarlar.
setActiveRange(range)RangeBelirtilen aralığı etkin sayfada active range olarak ayarlar ve aralıktaki sol üstteki hücre current cell olarak ayarlanır.
setActiveRangeList(rangeList)RangeListBelirtilen aralık listesini, etkin sayfada active ranges olarak ayarlar.
setActiveSelection(range)RangeBu sayfa için etkin seçim bölgesini ayarlar.
setActiveSelection(a1Notation)RangeEtkin seçimi, A1 gösteriminde veya R1C1 gösteriminde belirtildiği şekilde ayarlar.
setActiveSheet(sheet)SheetBelirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar.
setActiveSheet(sheet, restoreSelection)SheetBelirli bir sayfayı e-tablodaki etkin sayfa olarak ayarlar ve bu sayfadaki en son seçimi geri yükleme seçeneği sunar.
setColumnWidth(columnPosition, width)SheetBelirli bir sütunun genişliğini piksel cinsinden ayarlar.
setCurrentCell(cell)RangeBelirtilen hücreyi current cell olarak ayarlar.
setFrozenColumns(columns)voidBelirli sayıda sütunu dondurur.
setFrozenRows(rows)voidBelirli sayıda satırı dondurur.
setIterativeCalculationConvergenceThreshold(minThreshold)SpreadsheetYinelemeli hesaplama için minimum eşik değerini belirler.
setIterativeCalculationEnabled(isEnabled)SpreadsheetBu e-tabloda yinelemeli hesaplamanın etkin olup olmadığını belirler.
setMaxIterativeCalculationCycles(maxIterations)SpreadsheetYinelemeli hesaplama sırasında gerçekleştirilmesi gereken maksimum hesaplama yinelemesi sayısını belirler.
setNamedRange(name, range)voidAralığı adlandırır.
setRecalculationInterval(recalculationInterval)SpreadsheetBu e-tablonun ne sıklıkta yeniden hesaplanması gerektiğini ayarlar.
setRowHeight(rowPosition, height)SheetBelirli bir satırın satır yüksekliğini piksel cinsinden ayarlar.
setSpreadsheetLocale(locale)voidE-tablo yerel ayarını belirler.
setSpreadsheetTheme(theme)SpreadsheetThemeE-tabloda bir tema ayarlar.
setSpreadsheetTimeZone(timezone)voidE-tablonun saat dilimini ayarlar.
show(userInterface)voidKullanıcının tarayıcısının görüntü alanında ortalanmış bir iletişim kutusunda özel kullanıcı arayüzü bileşeni görüntüler.
sort(columnPosition)SheetSayfayı sütuna göre artan düzende sıralar.
sort(columnPosition, ascending)SheetSayfayı sütuna göre sıralar.
toast(msg)voidE-tablonun sağ alt köşesinde, belirtilen mesajı içeren bir pop-up pencere gösterir.
toast(msg, title)voidE-tablonun sağ alt köşesinde, belirtilen mesajı ve başlığı içeren bir pop-up pencere gösterir.
toast(msg, title, timeoutSeconds)voidE-tablonun sağ alt köşesinde, başlığı ve mesajı içeren ve belirli bir süre boyunca görünür olan bir pop-up pencere gösterir.
unhideColumn(column)voidBelirtilen aralıktaki sütunu gösterir.
unhideRow(row)voidVerilen aralıktaki satırı gösterir.
updateMenu(name, subMenus)voidaddMenu(name, subMenus) tarafından eklenen bir menüyü günceller.
waitForAllDataExecutionsCompletion(timeoutInSeconds)voidE-tablodaki mevcut tüm yürütme işlemleri tamamlanana kadar bekler ve belirtilen sayıda saniye geçtikten sonra zaman aşımına uğrar.

Ayrıntılı belgeler

addDeveloperMetadata(key)

Belirtilen anahtarla geliştirici meta verilerini üst düzey e-tabloya 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');

// Adds the key 'NAME' in the developer metadata for the spreadsheet.
ss.addDeveloperMetadata('NAME')

// Gets the first developer metadata object and logs its key.
const developerMetaData = ss.getDeveloperMetadata()[0]
console.log(developerMetaData.getKey())

Parametreler

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

Return

Spreadsheet — Zincirleme için bu 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

addDeveloperMetadata(key, visibility)

Belirtilen anahtar ve görünürlükle birlikte geliştirici meta verilerini e-tabloya 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');

// Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility
// to the developer project that created the metadata.
ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the first developer metadata object and logs its key and visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()},
.             Visibility: ${developerMetaData.getVisibility()}`);

Parametreler

AdTürAçıklama
keyStringYeni geliştirici meta verilerinin anahtarı.
visibilityDeveloperMetadataVisibilityYeni geliştirici meta verilerinin görünürlüğü.

Return

Spreadsheet — Zincirleme için bu 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

addDeveloperMetadata(key, value)

Belirtilen anahtar ve değeri içeren geliştirici meta verilerini e-tabloya 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');

// Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the
// spreadsheet.
ss.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the first developer metadata object and logs its key and value.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}`);

Parametreler

AdTürAçıklama
keyStringYeni geliştirici meta verilerinin anahtarı.
valueStringYeni geliştirici meta verilerinin değeri.

Return

Spreadsheet — Zincirleme için bu 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

addDeveloperMetadata(key, value, visibility)

Belirtilen anahtar, değer ve görünürlükle birlikte geliştirici meta verilerini e-tabloya 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');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to any developer project with document access.
ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the first developer metadata object and logs its key, value, and visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(`Key: ${developerMetaData.getKey()},
             Value: ${developerMetaData.getValue()},
             Visibility: ${developerMetaData.getVisibility()}`);

Parametreler

AdTürAçıklama
keyStringYeni geliştirici meta verilerinin anahtarı.
valueStringYeni geliştirici meta verilerinin değeri.
visibilityDeveloperMetadataVisibilityYeni geliştirici meta verilerinin görünürlüğü.

Return

Spreadsheet — Zincirleme için bu 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

addEditor(emailAddress)

Kullanıcıyı Spreadsheet düzenleyici listesine ekler. Kullanıcı zaten görüntüleyen listesindeyse bu yöntem kullanıcıyı görüntüleyen listesinin dışına çıkarır.

Parametreler

AdTürAçıklama
emailAddressStringEklenecek kullanıcının e-posta adresi.

Return

Spreadsheet — Bu Spreadsheet, zincirleme bağlantı için.

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

addEditor(user)

Kullanıcıyı Spreadsheet düzenleyici listesine ekler. Kullanıcı zaten görüntüleyen listesindeyse bu yöntem kullanıcıyı görüntüleyen listesinin dışına çıkarır.

Parametreler

AdTürAçıklama
userUserEklenecek kullanıcının temsili.

Return

Spreadsheet — Bu Spreadsheet, zincirleme bağlantı için.

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

addEditors(emailAddresses)

Belirtilen kullanıcı dizisini, Spreadsheet düzenleyicisi listesine ekler. Kullanıcılardan biri zaten görüntüleyen listesindeyse bu yöntem, söz konusu kullanıcıları görüntüleyen listesinin dışına çıkarır.

Parametreler

AdTürAçıklama
emailAddressesString[]Eklenecek kullanıcıların e-posta adresleri dizisi.

Return

Spreadsheet — Bu Spreadsheet, zincirleme bağlantı için.

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

addMenu(name, subMenus)

E-tablo kullanıcı arayüzünde yeni bir menü oluşturur.

Her menü girişi, kullanıcı tanımlı bir işlevi çalıştırır. E-tablo yüklendiğinde menünün otomatik olarak oluşturulması için genellikle bunu onOpen() işlevinden çağırmak istersiniz.

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [];
  // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is
  // executed.
  menuEntries.push({name: "Menu Entry 1", functionName: "function1"});
  menuEntries.push(null); // line separator
  menuEntries.push({name: "Menu Entry 2", functionName: "function2"});

  ss.addMenu("addMenuExample", menuEntries);
}

Parametreler

AdTürAçıklama
nameStringOluşturulacak menünün adı.
subMenusObject[]name ve functionName parametreleriyle bir dizi JavaScript haritası. Dahil edilen kitaplıklardaki Library.libFunction1 gibi işlevleri kullanabilirsiniz.

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

addViewer(emailAddress)

Kullanıcıyı Spreadsheet öğesini görüntüleyenler listesine ekler. Kullanıcı zaten düzenleyenler listesindeyse bu yöntemin herhangi bir etkisi olmaz.

Parametreler

AdTürAçıklama
emailAddressStringEklenecek kullanıcının e-posta adresi.

Return

Spreadsheet — Bu Spreadsheet, zincirleme bağlantı için.

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

addViewer(user)

Kullanıcıyı Spreadsheet öğesini görüntüleyenler listesine ekler. Kullanıcı zaten düzenleyenler listesindeyse bu yöntemin herhangi bir etkisi olmaz.

Parametreler

AdTürAçıklama
userUserEklenecek kullanıcının temsili.

Return

Spreadsheet — Bu Spreadsheet, zincirleme bağlantı için.

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

addViewers(emailAddresses)

Belirtilen kullanıcı dizisini, Spreadsheet için görüntüleyen listesine ekler. Kullanıcılardan biri zaten düzenleyen listesindeyse bu yöntemin o kullanıcılar için bir etkisi yoktur.

Parametreler

AdTürAçıklama
emailAddressesString[]Eklenecek kullanıcıların e-posta adresleri dizisi.

Return

Spreadsheet — Bu Spreadsheet, zincirleme bağlantı için.

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

AdTürAçıklama
rowContentsObject[]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

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

AdTürAçıklama
columnPositionIntegerYeniden 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

copy(name)

E-tabloyu kopyalar ve yeni e-tabloyu döndürür.

// This code makes a copy of the current spreadsheet and names it appropriately
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.copy("Copy of " + ss.getName());

Parametreler

AdTürAçıklama
nameStringKopyanın adı.

Return

Spreadsheet — Zincirleme için bu 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

createDeveloperMetadataFinder()

Bu e-tablonun kapsamında geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür. Varsayılan olarak e-tablo, e-tablo, satır ve sütunlarla ilişkili tüm meta veriler dikkate alınır.

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

// Adds developer metadata to the spreadsheet.
ss.addDeveloperMetadata('NAME', 'CHARLIE');
ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION');
ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT');

// Creates a developer metadata finder.
const developerMetadataFinder = ss.createDeveloperMetadataFinder();

// Finds the developer metadata objects with 'COMPANY' as the key.
const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find();

// Gets the first result of developer metadata that has the key 'COMPANY' and logs its value.
console.log(googleMetadataFromSpreadsheet[0].getValue());

Return

DeveloperMetadataFinder: Bu e-tablonun kapsamındaki meta verileri aramak için kullanılan geliştirici meta veri bulucu.


createTextFinder(findText)

E-tablo için bir metin bulucu oluşturur. Bu metin bulucu, e-tablodaki metinleri bulup değiştirmek için kullanılabilir. Arama, e-tablonun ilk sayfasından başlar.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

// Creates  a text finder.
var textFinder = spreadsheet.createTextFinder('dog');

// Returns the first occurrence of 'dog' in the spreadsheet.
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

AdTürAçıklama
findTextStringAranacak metin.

Return

TextFinder: E-tablo için TextFinder.


deleteActiveSheet()

O anda etkin olan sayfayı siler.

// The code below deletes the currently active sheet and stores the new active sheet in a
// variable
var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();

Return

Sheet: Yeni etkin 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

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

AdTürAçıklama
columnPositionIntegerİ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

AdTürAçıklama
columnPositionIntegerSilinecek ilk sütunun konumu.
howManyIntegerSilinecek 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

AdTürAçıklama
rowPositionIntegerİ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

AdTürAçıklama
rowPositionIntegerSilinecek ilk satırın konumu.
howManyIntegerSilinecek 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

deleteSheet(sheet)

Belirtilen sayfayı siler.

// The code below deletes the specified sheet.
var ss = SpreadsheetApp.getActive();
var sheet = ss.getSheetByName('My Sheet');
ss.deleteSheet(sheet);

Parametreler

AdTürAçıklama
sheetSheetSilinecek 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

duplicateActiveSheet()

Etkin sayfayı kopyalar ve etkin sayfa haline getirir.

// The code below makes a duplicate of the active sheet
SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();

Return

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

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:


getActiveSheet()

Bir e-tablodaki etkin sayfayı alır.

Bir e-tablodaki etkin sayfa, e-tablo kullanıcı arayüzünde görüntülenen sayfadır.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

Return

Sheet: E-tablodaki etkin sayfa.


getAs(contentType)

Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. Bu yöntem, dosya adına uygun uzantıyı ekler (örneğin, "dosyam.pdf"). Bununla birlikte, dosya adında son noktanın ardından gelen bölümün (varsa) değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" haline gelir.

Günlük dönüşüm kotalarını görüntülemek için Google Hizmetleri Kotalar bölümüne bakın. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkı kotalara tabi olabilir.

Parametreler

AdTürAçıklama
contentTypeStringDönüştürülecek MIME türü. Çoğu blob için geçerli tek seçenek 'application/pdf''tir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png' değerleri de geçerlidir.

Return

Blob: Blob halinde veriler.


getBandings()

Bu e-tablodaki tüm bantları 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 an array of the bandings in the spreadsheet.
const bandings = ss.getBandings();

// Logs the range of the first banding in the spreadsheet to the console.
console.log(bandings[0].getRange().getA1Notation());

Return

Banding[] — Bu e-tablodaki ş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

getBlob()

Bu nesnenin içindeki verileri blob olarak döndürün.

Return

Blob: Blob halinde veriler.


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

AdTürAçıklama
columnPositionIntegerİ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

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

getDataSourceRefreshSchedules()

Bu e-tablonun yenileme programlarını alı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');

// Activates BigQuery operations for the connected spreadsheet.
SpreadsheetApp.enableBigQueryExecution();

// Gets the frequency type of the first referesh schedule in the array.
const frequencyType = ss.getDataSourceRefreshSchedules()[0]
                        .getFrequency()
                        .getFrequencyType()
                        .toString();

// Logs the frequency type to the console.
console.log(frequencyType);

Return

DataSourceRefreshSchedule[] — Bu e-tablonun yenileme planları.

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

getDataSourceSheets()

E-tablodaki tüm veri kaynağı sayfalarını döndürür.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// 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 the first data source sheet in the spreadsheet.
const dataSource = ss.getDataSourceSheets()[0];

// Gets the name of the data source sheet.
console.log(dataSource.asSheet().getName());

Return

DataSourceSheet[]: Tüm veri kaynağı sayfalarını içeren dizi.

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

getDataSources()

E-tablodaki tüm veri kaynaklarını döndürür.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// 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 the data sources on the spreadsheet.
const dataSources = ss.getDataSources();

// Logs the name of the first column on the first data source.
console.log(dataSources[0].getColumns()[0].getName());

Return

DataSource[]: Tüm veri kaynaklarını içeren dizi.

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()

Üst düzey e-tabloyla ilişkilendirilen geliştirici meta verilerini alı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');

// Adds 'Google' as a key to the spreadsheet metadata.
ss.addDeveloperMetadata('Google');

// Gets the spreadsheet's metadata.
const ssMetadata = ss.getDeveloperMetadata();

// Gets the first set of the spreadsheet's metadata and logs the key to the console.
console.log(ssMetadata[0].getKey());

Return

DeveloperMetadata[]: Bu aralıkla 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

getEditors()

Bu Spreadsheet için düzenleyenlerin listesini alır.

Return

User[]: Düzenleme iznine sahip olan kullanıcı 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

getFormUrl()

Yanıtlarını bu e-tabloya gönderen formun URL'sini veya bu e-tablonun ilişkilendirilmiş bir formu yoksa null değerini döndürür. Bu e-tabloya birden fazla form yanıt gönderiyorsa döndürülen form URL'si belirsiz olur. Alternatif olarak, sayfa başına form URL ilişkilendirmeleri Sheet.getFormUrl() yöntemiyle alınabilir.

// 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 the form URL from the spreadsheet.
const formUrl = ss.getFormUrl();

// Logs the form URL to the console.
console.log(formUrl);

Return

String: Yanıtlarını bu e-tabloya yerleştiren formun URL'si veya bu e-tablonun ilişkili 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

getId()

Bu e-tablo için benzersiz bir tanımlayıcı alır. E-tablo kimliği URL'sinden çıkarılabilir. Örneğin, https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 URL'sindeki e-tablo kimliği "abc1234567"dir.

// The code below logs the ID for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());

Return

String: E-tablonun benzersiz kimliği (veya anahtarı).


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

getIterativeCalculationConvergenceThreshold()

Yinelemeli hesaplama sırasında kullanılan eşik değerini döndürür. Ardışık hesaplamanın sonuçları bu değerden daha az farklılık gösterdiğinde yinelemeli hesaplama durur.

// 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');

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

Return

Number: Yakınsaklık eşiğ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

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

getMaxIterativeCalculationCycles()

Yinelemeli hesaplama sırasında kullanılacak maksimum yineleme sayısını 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');

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

Return

Integer: Maksimum hesaplama yineleme 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

getName()

Belgenin adını alır.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getName());

Return

String: E-tablonun 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 e-tablodaki tüm adlandırılmış aralıkları alır.

// The code below logs the name of the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  Logger.log(namedRanges[i].getName());
}

Return

NamedRange[]: E-tablodaki 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

getNumSheets()

Bu e-tablodaki sayfa sayısını döndürür.

// The code below logs the number of sheets in the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());

Return

Integer: E-tablodaki sayfa sayısı.


getOwner()

Dokümanın sahibini veya ortak Drive'daki bir doküman için null değerini döndürür.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var owner = ss.getOwner();
Logger.log(owner.getEmail());

Return

User: Dokümanın sahibi veya doküman ortak Drive'daysa 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

getPredefinedSpreadsheetThemes()

Önceden tanımlanmış temaların listesini döndürür.

// The code below returns the list of predefined themes.
var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet()
                               .getPredefinedSpreadsheetThemes();

Return

SpreadsheetTheme[]: Önceden tanımlanmış temaları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

getProtections(type)

E-tablodaki tüm korunan aralıkları veya sayfaları temsil eden bir nesne dizisini alır.

// Remove all range protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}
// Remove all sheet protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

Parametreler

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

Return

Protection[]: E-tablodaki tüm korunan aralıkları veya sayfaları temsil eden bir nesne 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

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

AdTürAçıklama
a1NotationStringA1 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

getRangeByName(name)

Adlandırılmış aralık veya belirtilen ada sahip herhangi bir aralık bulunmazsa null döndürür. E-tablonun birden fazla sayfası aynı aralık adını kullanıyorsa sayfa adını ek tırnak işaretleri olmadan belirtin. Örneğin getRangeByName('TaxRates') veya getRangeByName('Sheet Name!TaxRates') girin ancak getRangeByName('"Sheet Name"!TaxRates') belirtmeyin.

// Log the number of columns for the range named 'TaxRates' in the active spreadsheet.
var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates');
if (range != null) {
  Logger.log(range.getNumColumns());
}

Parametreler

AdTürAçıklama
nameStringAlınacak aralığın adı.

Return

Range: Belirtilen ada sahip hücre aralığı.


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

AdTürAçıklama
a1NotationsString[]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

getRecalculationInterval()

Bu e-tabloya ilişkin hesaplama aralığını 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');

// Logs the calculation interval for the spreadsheet to the console.
console.log(ss.getRecalculationInterval().toString());

Return

RecalculationInterval: Bu e-tablo için hesaplama 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

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

AdTürAçıklama
rowPositionIntegerİncelenecek satırın konumu.

Return

Integer — piksel cinsinden satır yüksekliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, 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

getSheetByName(name)

Belirtilen ada sahip bir sayfa döndürür.

Aynı ada sahip birden fazla sayfa varsa en soldaki sayfa döndürülür. Belirtilen ada sahip bir sayfa yoksa null değerini döndürür.

// The code below logs the index of a sheet named "Expenses"
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses");
if (sheet != null) {
  Logger.log(sheet.getIndex());
}

Parametreler

AdTürAçıklama
nameStringAlınacak sayfanın adı.

Return

Sheet: Belirtilen ada sahip sayfa.


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

AdTürAçıklama
startRowIntegerBaşlangıç satırının konumu.
startColumnIntegerBaşlangıç sütununun konumu.
numRowsIntegerDeğer döndürülecek satır sayısı.
numColumnsIntegerDeğ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

getSheets()

Bu e-tablodaki tüm sayfaları alır.

// The code below logs the name of the second sheet
var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
if (sheets.length > 1) {
  Logger.log(sheets[1].getName());
}

Return

Sheet[]: E-tablodaki tüm sayfaları içeren bir dizi.


getSpreadsheetLocale()

E-tablo yerel ayarını alı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 the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Return

String: E-tablonun yerel ayarı.

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

getSpreadsheetTheme()

E-tablonun geçerli temasını veya herhangi bir tema uygulanmazsa null değerini döndürür.

// The code below returns the current theme of the spreadsheet.
var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();

Return

SpreadsheetTheme: Uygulanan geçerli tema.

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

getSpreadsheetTimeZone()

E-tablonun saat dilimini alı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');

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Return

String — "Uzun" biçimde belirtilen saat dilimi (örneğin, Joda.org tarafından listelenen "Amerika/New_York").

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

getUrl()

Belirli e-tablonun URL'sini döndürür.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getUrl());

Return

String: Belirli e-tablonun URL'si.

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

getViewers()

Bu Spreadsheet için görüntüleyenlerin ve yorum yapanların listesini alır.

Return

User[]: Görüntüleme veya yorum yapma iznine sahip bir kullanıcı 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

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

AdTürAçıklama
columnRangeGizlenecek 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

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

AdTürAçıklama
rowRangeGizlenecek 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

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

AdTürAçıklama
afterPositionIntegerYeni 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

AdTürAçıklama
beforePositionIntegerÖ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

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

AdTürAçıklama
afterPositionIntegerYeni sütunun ekleneceği sütundur.
howManyIntegerEklenecek 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

AdTürAçıklama
beforePositionIntegerÖnüne yeni sütunun ekleneceği sütun.
howManyIntegerEklenecek 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

insertDataSourceSheet(spec)

E-tabloya yeni bir DataSourceSheet ekler ve veri yürütme işlemini başlatır. Bu da yeni sayfayı etkin sayfa haline getirir.

Veri kaynağı türü etkinleştirilmemişse istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// 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');

// Builds a data source specification.
// TODO (developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
 .asBigQuery()
 .setProjectId('project-id-1')
 .setTableProjectId('bigquery-public-data')
 .setDatasetId('ncaa_basketball')
 .setTableId('mbb_historical_teams_games')
 .build();

// Adds the data source and its data to the spreadsheet.
ss.insertDataSourceSheet(dataSourceSpec);

Parametreler

AdTürAçıklama
specDataSourceSpecEklenecek veri kaynağı spesifikasyonu.

Return

DataSourceSheet: Yeni 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

insertImage(blobSource, column, row)

Dokümanda belirli bir satır ve sütunda resim olarak bir Spreadsheet 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

AdTürAçıklama
blobSourceBlobSourceResim içeriklerini, MIME türünü ve (isteğe bağlı olarak) adı içeren blob.
columnIntegerSütun konumu.
rowIntegerSatır konumu.

Return

OverGridImage: Eklenen resim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, 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 Spreadsheet 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

AdTürAçıklama
blobSourceBlobSourceResim içeriklerini, MIME türünü ve (isteğe bağlı olarak) adı içeren blob.
columnIntegerSütun konumu.
rowIntegerSatır konumu.
offsetXIntegerHücre köşesinden yatay uzaklık.
offsetYIntegerHü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

AdTürAçıklama
urlStringResmin URL'si.
columnIntegerIzgara sütunu konumu.
rowIntegerIzgara satırı konumu.

Return

OverGridImage: Eklenen resim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, 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

AdTürAçıklama
urlStringGörselin URL'si.
columnIntegerSütun konumu.
rowIntegerSatır konumu.
offsetXIntegerHücre köşesinden yatay uzaklık.
offsetYIntegerHü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

AdTürAçıklama
afterPositionIntegerYeni 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

AdTürAçıklama
beforePositionIntegerÖ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

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

AdTürAçıklama
afterPositionIntegerYeni satırların ekleneceği satır.
howManyIntegerEklenecek 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

AdTürAçıklama
beforePositionIntegerÖnüne yeni satır eklenmesi gereken satır.
howManyIntegerEklenecek 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

insertSheet()

Varsayılan sayfa adını kullanarak e-tabloya yeni bir sayfa ekler. Yeni sayfa, etkin sayfa haline gelir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet();

Return

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

insertSheet(sheetIndex)

Belirtilen dizindeki e-tabloya yeni bir sayfa ekler. Yeni sayfa etkin sayfa haline gelir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet(1);

Parametreler

AdTürAçıklama
sheetIndexIntegerYeni oluşturulan sayfanın dizini. Bir sayfayı e-tablodaki ilk sayfa olarak eklemek için sayfayı 0 olarak ayarlayın.

Return

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

insertSheet(sheetIndex, options)

Belirtilen dizindeki e-tabloya yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır. Yeni sayfa, etkin sayfa haline gelir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet(1, {template: templateSheet});

Parametreler

AdTürAçıklama
sheetIndexIntegerYeni oluşturulan sayfanın dizini. Bir sayfayı e-tablodaki ilk sayfa olarak eklemek için sayfayı 0 olarak ayarlayın.
optionsObjectİsteğe bağlı gelişmiş JavaScript bağımsız değişkenleri.

Gelişmiş parametreler

AdTürAçıklama
templateSheetŞablon sayfası nesnesindeki tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır.

Return

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

insertSheet(options)

Varsayılan sayfa adı ve isteğe bağlı gelişmiş bağımsız değişkenler kullanarak e-tabloya yeni bir sayfa ekler. Yeni sayfa, etkin sayfa haline gelir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet({template: templateSheet});

Parametreler

AdTürAçıklama
optionsObjectAşağıda listelenen isteğe bağlı gelişmiş JavaScript bağımsız değişkenleri.

Gelişmiş parametreler

AdTürAçıklama
templateSheetŞablon sayfası nesnesindeki tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, bu e-tablo nesnesinin sayfalarından biri olmalıdır.

Return

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

insertSheet(sheetName)

E-tabloya belirtilen adla yeni bir sayfa ekler. Yeni sayfa etkin sayfa haline gelir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet');

Parametreler

AdTürAçıklama
sheetNameStringYeni sayfanın adı.

Return

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

insertSheet(sheetName, sheetIndex)

E-tabloya, verilen dizinde belirtilen adla yeni bir sayfa ekler. Yeni sayfa etkin sayfa haline gelir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet', 1);

Parametreler

AdTürAçıklama
sheetNameStringYeni sayfanın adı.
sheetIndexIntegerYeni oluşturulan sayfanın dizini. Bir sayfayı e-tablodaki ilk sayfa olarak eklemek için sayfayı 0 olarak ayarlayın.

Return

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

insertSheet(sheetName, sheetIndex, options)

E-tabloya, belirtilen dizinde belirtilen adla yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır. Yeni sayfa, etkin sayfa haline gelir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', 1, {template: templateSheet});

Parametreler

AdTürAçıklama
sheetNameStringYeni sayfanın adı.
sheetIndexIntegerYeni eklenen sayfanın dizini. Bir sayfayı e-tablodaki ilk sayfa olarak eklemek için sayfayı 0 olarak ayarlayın.
optionsObjectİsteğe bağlı gelişmiş JavaScript bağımsız değişkenleri.

Gelişmiş parametreler

AdTürAçıklama
templateSheetŞablon sayfası nesnesindeki tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır.

Return

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

insertSheet(sheetName, options)

E-tabloya belirtilen adla yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır. Yeni sayfa, etkin sayfa haline gelir.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', {template: templateSheet});

Parametreler

AdTürAçıklama
sheetNameStringYeni sayfanın adı.
optionsObjectİsteğe bağlı gelişmiş JavaScript bağımsız değişkenleri.

Gelişmiş parametreler

AdTürAçıklama
templateSheetŞablon sayfası nesnesindeki tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır.

Return

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

insertSheetWithDataSourceTable(spec)

E-tabloya yeni bir sayfa ekler, belirtilen veri kaynağı spesifikasyonuyla sayfanın tamamını kapsayan bir DataSourceTable oluşturur ve veri yürütme işlemini başlatır. Bir yan etki olarak, yeni sayfayı etkin sayfa haline getirir.

Veri kaynağı türü etkinleştirilmemişse istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// 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');

// Adds a sheet and sets cell A1 as the parameter cell.
const parameterCell = ss.insertSheet('parameterSheet').getRange('A1');

// Sets the value of the parameter cell to 'Duke'.
parameterCell.setValue('Duke');

const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' +
  '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL';

// Adds a data source with a query parameter.
// TODO(developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
 .asBigQuery()
 .setProjectId('project-id-1')
 .setRawQuery(query)
 .setParameterFromCell('SCHOOL', 'parameterSheet!A1')
 .build();

// Adds sheets for the data source and data source table to the spreadsheet.
ss.insertSheetWithDataSourceTable(dataSourceSpec);

Parametreler

AdTürAçıklama
specDataSourceSpecEklenecek veri kaynağı spesifikasyonu.

Return

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

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

AdTürAçıklama
columnPositionIntegerİ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

isIterativeCalculationEnabled()

Bu e-tabloda yinelemeli hesaplamanın etkin olup olmadığını 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');

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Return

Boolean — Yinelemeli hesaplama etkinse true, aksi takdirde 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

AdTürAçıklama
rowPositionIntegerİ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

AdTürAçıklama
rowPositionIntegerİ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

moveActiveSheet(pos)

Etkin sayfayı, sayfa listesinde belirli bir konuma taşır. Konum negatifse veya sayfa sayısından büyükse bir istisna atar.

// This example assumes that there are 2 sheets in the current
// active spreadsheet: one named "first" in position 1 and another named "second"
// in position 2.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// Gets the "first" sheet and activates it.
var sheet = spreadsheet.getSheetByName("first").activate();

// Logs 'Current index of sheet: 1'
console.log("Current index of sheet: %s", sheet.getIndex());

spreadsheet.moveActiveSheet(2);

// Logs 'New index of sheet: 2'
console.log("New index of sheet: %s", sheet.getIndex());

Parametreler

AdTürAçıklama
posIntegerEtkin sayfanın, sayfalar listesinde taşınacağı 1 dizin konumu.

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

moveChartToObjectSheet(chart)

Yeni bir SheetType.OBJECT sayfası oluşturur ve sağlanan grafiği bu e-tabloya taşır. Grafik zaten kendi sayfasındaysa bu sayfa yeni bir sayfa oluşturulmadan döndürülür.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.newChart().setPosition(1, 1, 0, 0).build();
sheet.insertChart(chart);
var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);

Parametreler

AdTürAçıklama
chartEmbeddedChartTaşınacak grafik.

Return

Sheet: Grafiğin bulunduğu 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

refreshAllDataSources()

Geçersiz veri kaynağı nesnelerini atlayarak desteklenen tüm veri kaynaklarını ve bunlara bağlı veri kaynağı nesnelerini yeniler.

Belirli veri kaynağı türleri için veri yürütmeyi etkinleştirmek amacıyla SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// 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 the first data source sheet on the spreadsheet.
const dataSheet = ss.getDataSourceSheets()[0];

// Refreshes all data sources on the spreadsheet.
ss.refreshAllDataSources();

// Logs the last refreshed time of the first data source sheet.
console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);

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

removeEditor(emailAddress)

Kullanıcıyı, Spreadsheet düzenleyici listesinden kaldırır. Genel erişime sahip bir kullanıcı sınıfına ait olan (örneğin, Spreadsheet, kullanıcının tüm alan adıyla paylaşılıyorsa veya Spreadsheet, kullanıcının erişebildiği bir ortak Drive'da yer alıyorsa) bu yöntem, kullanıcıların Spreadsheet ürününe erişmesini engellemez.

Bu işlem, Drive dosyalarını görüntüleyenler listesinden de kaldırır.

Parametreler

AdTürAçıklama
emailAddressStringKaldırılacak kullanıcının e-posta adresi.

Return

Spreadsheet — Bu Spreadsheet, zincirleme bağlantı için.

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

removeEditor(user)

Kullanıcıyı, Spreadsheet düzenleyici listesinden kaldırır. Genel erişime sahip bir kullanıcı sınıfına ait olan (örneğin, Spreadsheet, kullanıcının tüm alan adıyla paylaşılıyorsa veya Spreadsheet, kullanıcının erişebildiği bir ortak Drive'da yer alıyorsa) bu yöntem, kullanıcıların Spreadsheet ürününe erişmesini engellemez.

Bu işlem, Drive dosyalarını görüntüleyenler listesinden de kaldırır.

Parametreler

AdTürAçıklama
userUserKaldırılacak kullanıcının temsili.

Return

Spreadsheet — Bu Spreadsheet, zincirleme bağlantı için.

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

removeMenu(name)

addMenu(name, subMenus) tarafından eklenen menüyü kaldırır. name bağımsız değişkeni, addMenu(name, subMenus) öğesine karşılık gelen çağrıyla aynı değere sahip olmalıdır.

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"},
                                       {name: "foo", functionName: "foo"}]);
}
function removeBadMenu() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.removeMenu("badMenu");  // name must match the name used when added the menu
}
function foo(){
// Do nothing
}

Parametreler

AdTürAçıklama
nameStringKaldırılacak menünü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

removeNamedRange(name)

Verilen ada sahip olan adlandırılmış bir aralığı siler. E-tabloda belirtilen ada sahip herhangi bir aralık bulunamazsa istisna oluşturur.

// The code below creates a new named range "foo", and then remove it.
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("foo", ss.getActiveRange());
ss.removeNamedRange("foo");

Parametreler

AdTürAçıklama
nameStringAralık 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

removeViewer(emailAddress)

İlgili kullanıcıyı, Spreadsheet için görüntüleyenler ve yorum yapanlar listesinden kaldırır. Kullanıcı düzenleyen veya görüntüleyen ya da yorumcu değilse bu yöntemin herhangi bir etkisi yoktur. Ayrıca, Spreadsheet, kullanıcının tüm alanıyla paylaşılıyorsa veya Spreadsheet kullanıcının erişebildiği bir ortak Drive'da yer alıyorsa bu yöntem, genel erişime sahip bir kullanıcı sınıfında yer alan kullanıcıların Spreadsheet öğesine erişimini de engellemez.

Bu işlem, Drive dosyalarında kullanıcıyı düzenleyenler listesinden de kaldırır.

Parametreler

AdTürAçıklama
emailAddressStringKaldırılacak kullanıcının e-posta adresi.

Return

Spreadsheet — Zincirleme için bu Spreadsheet.

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

removeViewer(user)

İlgili kullanıcıyı, Spreadsheet için görüntüleyenler ve yorum yapanlar listesinden kaldırır. Kullanıcı görüntüleyen değil düzenleyense bu yöntemin herhangi bir etkisi yoktur. Ayrıca, Spreadsheet kullanıcının tüm alanıyla paylaşılıyorsa veya Spreadsheet kullanıcının erişebildiği bir ortak Drive'da bulunuyorsa bu yöntem, genel erişime sahip bir kullanıcı sınıfında bulunan kullanıcıların Spreadsheet öğesine erişimini de engellemez.

Bu işlem, Drive dosyalarında kullanıcıyı düzenleyenler listesinden de kaldırır.

Parametreler

AdTürAçıklama
userUserKaldırılacak kullanıcının temsili.

Return

Spreadsheet — Zincirleme için bu Spreadsheet.

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

rename(newName)

Dokümanı yeniden adlandırır.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.rename("This is the new name");

Parametreler

AdTürAçıklama
newNameStringDokümanın yeni 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

renameActiveSheet(newName)

Geçerli etkin sayfayı verilen yeni adla yeniden adlandırır.

// The code below renames the active sheet to "Hello world"
SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");

Parametreler

AdTürAçıklama
newNameStringGeçerli etkin sayfanın yeni 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

resetSpreadsheetTheme()

Uygulanan temayı kaldırır ve e-tablodaki varsayılan temayı ayarlar.

// The code below applies default theme on the spreadsheet.
SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();

Return

SpreadsheetTheme: Varsayılan tema.

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

AdTürAçıklama
rangeRangeEtkin 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

AdTürAçıklama
rangeListRangeListSeç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

AdTürAçıklama
rangeRangeEtkin 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

AdTürAçıklama
a1NotationStringA1 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

setActiveSheet(sheet)

Belirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar. Google E-Tablolar kullanıcı arayüzü, sayfa farklı bir e-tabloya ait değilse seçilen sayfayı görüntüler.

// The code below makes the first sheet active in the active spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);

Parametreler

AdTürAçıklama
sheetSheetEtkin sayfa olarak ayarlanacak sayfa.

Return

Sheet: Etkin 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

setActiveSheet(sheet, restoreSelection)

Belirli bir sayfayı e-tablodaki etkin sayfa olarak ayarlar ve bu sayfadaki en son seçimi geri yükleme seçeneği sunar. Google E-Tablolar kullanıcı arayüzü, sayfa farklı bir e-tabloya ait değilse seçilen sayfayı görüntüler.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var firstSheet = spreadsheet.getSheets()[0];
var secondSheet = spreadsheet.getSheets()[1];
// Set the first sheet as the active sheet and select the range D4:F4.
spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate();

// Switch to the second sheet to do some work.
spreadsheet.setActiveSheet(secondSheet);
// Switch back to first sheet, and restore its selection.
spreadsheet.setActiveSheet(firstSheet, true);

// The selection of first sheet is restored, and it logs D4:F4
var range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

Parametreler

AdTürAçıklama
sheetSheetYeni etkin sayfa.
restoreSelectionBooleanTf true'da, yeni etkin sayfanın en son seçimi yeni sayfa etkin hale geldiğinde tekrar seçilir. false değerine ayarlanırsa yeni sayfa mevcut seçim değiştirilmeden etkin hale gelir.

Return

Sheet: Yeni etkin 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

AdTürAçıklama
columnPositionIntegerAyarlanacak sütunun konumu.
widthIntegerAyarlanacak 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

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

AdTürAçıklama
cellRangeGeçerli hücre olarak ayarlanacak hücre.

Return

Range: Yeni ayarlanan geçerli hücre

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, 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

AdTürAçıklama
columnsIntegerDondurulacak 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

AdTürAçıklama
rowsIntegerDondurulacak 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

setIterativeCalculationConvergenceThreshold(minThreshold)

Yinelemeli hesaplama için minimum eşik değerini belirler. Ardışık hesaplamanın sonuçları bu değerden daha az farklılık gösterdiğinde yinelemeli hesaplama durur. Bu değer, negatif olmayan bir değer olmalıdır ve varsayılan olarak 0,05'tir.

// 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');

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

Parametreler

AdTürAçıklama
minThresholdNumberMinimum yakınlaşma eşiği (negatif olmamalıdır).

Return

Spreadsheet — Zincirleme için bu 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

setIterativeCalculationEnabled(isEnabled)

Bu e-tabloda yinelemeli hesaplamanın etkin olup olmadığını belirler. Hesaplama etkinleştirildiğinde maksimum hesaplama döngüsü sayısı ve yakınsaklık eşiği daha önce ayarlanmamışsa bunlar varsayılan olarak sırasıyla 50 ve 0, 05 olur. Bunlardan biri daha önce ayarlandıysa önceki değerlerini korur.

// 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');

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Parametreler

AdTürAçıklama
isEnabledBooleanYinelemeli hesaplamanın etkinleştirilmesi gerekiyorsa true; aksi takdirde false.

Return

Spreadsheet — Zincirleme için bu 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

setMaxIterativeCalculationCycles(maxIterations)

Yinelemeli hesaplama sırasında gerçekleştirilmesi gereken maksimum hesaplama yinelemesi sayısını belirler. Bu değer 1 ile 10.000 (dahil) arasında olmalıdır ve varsayılan olarak 50 değerine ayarlanı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');

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

Parametreler

AdTürAçıklama
maxIterationsIntegerMaksimum hesaplama yineleme sayısı (1 ile 10.000 arasında).

Return

Spreadsheet — Zincirleme için bu 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

setNamedRange(name, range)

Aralığı adlandırır.

// The code below creates a new named range "TaxRates" in the active spreadsheet
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());

Parametreler

AdTürAçıklama
nameStringAralığa verilecek ad.
rangeRangeAralık spesifikasyonu.

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

setRecalculationInterval(recalculationInterval)

Bu e-tablonun ne sıklıkta yeniden hesaplanması gerektiğini ayarlar.

// 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');

// Sets the  calculation interval for the spreadsheet to 'ON_CHANGE'.
const interval = ss.setRecalculationInterval(SpreadsheetApp.RecalculationInterval.ON_CHANGE);

// Logs the calculation interval to the console.
console.log(interval);

Parametreler

AdTürAçıklama
recalculationIntervalRecalculationIntervalYeni yeniden hesaplama aralığı.

Return

Spreadsheet — Zincirleme için bu 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

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 Sheet.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

AdTürAçıklama
rowPositionIntegerDeğiştirilecek satır konumu.
heightIntegerAyarlanacak 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

setSpreadsheetLocale(locale)

E-tablo yerel ayarını belirler.

// 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');

// Sets the spreadsheet locale.
ss.setSpreadsheetLocale('fr');

// Gets the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Parametreler

AdTürAçıklama
localeStringKullanılacak yerel ayar kodu (ör. "en", "fr" veya "en_US").

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

setSpreadsheetTheme(theme)

E-tabloda bir tema ayarlar.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// The code below sets the second predefined theme as the current theme of the spreadsheet.
var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes();
spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);

Parametreler

AdTürAçıklama
themeSpreadsheetThemeUygulanacak tema.

Return

SpreadsheetTheme: Yeni geçerli tema.

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

setSpreadsheetTimeZone(timezone)

E-tablonun saat dilimini ayarlar.

// 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');

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Parametreler

AdTürAçıklama
timezoneString"Uzun" biçimde belirtilen saat dilimi (örneğin, Joda.org tarafından listelendiği şekliyle "Amerika/New_York").

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

show(userInterface)

Kullanıcının tarayıcısının görüntü alanında ortalanmış bir iletişim kutusunda özel kullanıcı arayüzü bileşeni görüntüler. Sunucu tarafı komut dosyasının yürütme işlemi askıya alınmaz. Kullanıcı arayüzü bileşeninin, sunucu tarafıyla iletişim kurmak için sunucu tarafı komut dosyasına eşzamansız geri çağırmalar yapması gerekir.

Sunucu tarafı komut dosyasında daha önce henüz kapatılmamış bir iletişim kutusu görüntüleniyorsa mevcut iletişim kutusu, yeni istenen iletişim kutusunun kullanıcı arayüzüyle değiştirilir.

Aşağıdaki kod snippet'i, belirtilen başlık, yükseklik ve genişlikle birlikte bir iletişim kutusunda basit bir HtmlService uygulamasını gösterir:

var htmlApp = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setTitle('My HtmlService Application')
    .setWidth(250)
    .setHeight(300);

SpreadsheetApp.getActiveSpreadsheet().show(htmlApp);

// The script resumes execution immediately after showing the dialog.

Parametreler

AdTürAçıklama
userInterfaceObjectHtmlOutput.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/script.container.ui

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

AdTürAçıklama
columnPositionIntegerSı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

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

Return

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

toast(msg)

E-tablonun sağ alt köşesinde, belirtilen mesajı içeren bir pop-up pencere gösterir.

// Show a popup with the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started');

Parametreler

AdTürAçıklama
msgStringDurum mesajında gösterilecek mesaj.

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

toast(msg, title)

E-tablonun sağ alt köşesinde, belirtilen mesajı ve başlığı içeren bir pop-up pencere gösterir.

// Show a popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');

Parametreler

AdTürAçıklama
msgStringDurum mesajında gösterilecek mesaj.
titleStringKısa iletinin isteğe bağlı başlığı.

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

toast(msg, title, timeoutSeconds)

E-tablonun sağ alt köşesinde, başlığı ve mesajı içeren ve belirli bir süre boyunca görünür olan bir pop-up pencere gösterir.

// Show a 3-second popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);

Parametreler

AdTürAçıklama
msgStringDurum mesajında gösterilecek mesaj.
titleStringKısa iletinin isteğe bağlı başlığı.
timeoutSecondsNumberSaniye cinsinden zaman aşımı. null değerine ayarlanırsa durum mesajı varsayılan olarak 5 saniyeye ayarlanır. Negatifse durum mesajı kapatılana kadar kalı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

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

AdTürAçıklama
columnRangeGizlenmiş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

AdTürAçıklama
rowRangeGizlenmiş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

updateMenu(name, subMenus)

addMenu(name, subMenus) tarafından eklenen bir menüyü günceller. addMenu(name, subMenus) ile tam olarak aynı şekilde çalışır.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var menuEntries = [];
menuEntries.push({name: "Lone Menu Entry", functionName: "function1"});
ss.updateMenu("addMenuExample", menuEntries);

Parametreler

AdTürAçıklama
nameStringGüncellenecek menünün adı.
subMenusObject[]name ve functionName parametreleriyle bir dizi JavaScript haritası. Dahil edilen kitaplıklardaki Library.libFunction1 gibi işlevleri kullanabilirsiniz.

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

waitForAllDataExecutionsCompletion(timeoutInSeconds)

E-tablodaki mevcut tüm yürütme işlemleri tamamlanana kadar bekler ve belirtilen sayıda saniye geçtikten sonra zaman aşımına uğrar. Yürütmeler zaman aşımına uğradığında tamamlanmazsa ancak veri yürütme işlemlerini iptal etmezse bir istisna oluşturur.

Parametreler

AdTürAçıklama
timeoutInSecondsIntegerVeri yürütme işlemlerinin bekleme süresi (saniye cinsinden). Maksimum süre 300 saniyedir.

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

Kullanımdan kaldırılan yöntemler