Class Spreadsheet

E-tablo

Google E-Tablolar dosyalarına erişebilir ve bu dosyaları değiştirebilir. Sık yapılan işlemler arasında yeni sayfa ekleme ve birlikte çalışır.

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üğe sahip geliştirici meta verilerini e-tabloya ekler.
addDeveloperMetadata(key, value)SpreadsheetBelirtilen anahtar ve değere sahip geliştirici meta verilerini e-tabloya ekler.
addDeveloperMetadata(key, value, visibility)SpreadsheetBelirtilen anahtar, değer ve görünürlüğe sahip geliştirici meta verilerini e-tabloya ekler.
addEditor(emailAddress)SpreadsheetBelirtilen kullanıcıyı Spreadsheet için düzenleyenler listesine ekler.
addEditor(user)SpreadsheetBelirtilen kullanıcıyı Spreadsheet için düzenleyenler listesine ekler.
addEditors(emailAddresses)SpreadsheetBelirtilen kullanıcı dizisini, Spreadsheet için düzenleyenler listesine ekler.
addMenu(name, subMenus)voidE-tablo kullanıcı arayüzünde yeni bir menü oluşturur.
addViewer(emailAddress)SpreadsheetBelirtilen kullanıcıyı Spreadsheet için görüntüleyenler listesine ekler.
addViewer(user)SpreadsheetBelirtilen kullanıcıyı Spreadsheet için görüntüleyenler listesine ekler.
addViewers(emailAddresses)SpreadsheetBelirtilen kullanıcı dizisini, Spreadsheet için görüntüleyenler listesine ekler.
appendRow(rowContents)SheetSayfadaki geçerli veri bölgesinin altına bir satır ekler.
autoResizeColumn(columnPosition)SheetBelirli bir sütunun genişliğini, içeriğine uyacak şekilde ayarlar.
copy(name)SpreadsheetE-tabloyu kopyalar ve yeni e-tabloyu döndürür.
createDeveloperMetadataFinder()DeveloperMetadataFinderŞu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür: e-tablo kullanabilirsiniz.
createTextFinder(findText)TextFinderE-tablo için bir metin bulucu oluşturur. Bu metin bulucu, içindeki metni bulup değiştirmek için kullanılabilir. e-tabloyla değiştirebilirsiniz.
deleteActiveSheet()SheetO anda etkin olan sayfayı siler.
deleteColumn(columnPosition)SheetBelirtilen sütun konumundaki sütunu siler.
deleteColumns(columnPosition, howMany)voidBelirli bir sütun konumundan başlayan bir dizi sütunu siler.
deleteRow(rowPosition)SheetVerilen satır konumundaki satırı siler.
deleteRows(rowPosition, howMany)voidBelirtilen satır konumundan başlayan satır sayısını siler.
deleteSheet(sheet)voidBelirtilen sayfayı siler.
duplicateActiveSheet()SheetEtkin sayfayı çoğaltır ve etkin sayfa haline getirir.
getActiveCell()RangeBu sayfadaki etkin hücreyi döndürür.
getActiveRange()RangeEtkin sayfada seçili aralığı veya etkin bir aralık yoksa null değerini döndürür.
getActiveRangeList()RangeListEtkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null'i döndürür. değerleridir.
getActiveSheet()SheetE-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 şeritleri döndürür.
getBlob()BlobBu nesnenin içindeki verileri blob olarak döndürün.
getColumnWidth(columnPosition)IntegerBelirli bir sütunun piksel cinsinden genişliğini 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şkili geliştirici meta verilerini alır.
getEditors()User[]Bu Spreadsheet için düzenleyenlerin listesini alır.
getFormUrl()StringYanıtları bu e-tabloya gönderen formun URL'sini veya aşağıdaki durumlarda null değerini döndürür bu e-tabloda ilişkilendirilmiş form yok.
getFrozenColumns()IntegerDondurulmuş sütunların sayısını döndürür.
getFrozenRows()IntegerDondurulmuş satır 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 kılavuz üzeri resimleri döndürür.
getIterativeCalculationConvergenceThreshold()NumberYinelemeli hesaplama sırasında kullanılan eşik değerini döndürür.
getLastColumn()Integerİçerik barındıran son sütunun konumunu döndürür.
getLastRow()Integerİçerik barındıran son satırın konumunu döndürür.
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 korumalı aralıkları veya sayfaları temsil eden bir nesne dizisi alır.
getRange(a1Notation)RangeA1 gösteriminde veya R1C1 notasyonunda belirtilen aralığı döndürür.
getRangeByName(name)RangeAdlandırılmış bir aralık veya belirtilen ada sahip bir aralık bulunamazsa null döndürür.
getRangeList(a1Notations)RangeListBelirtilen sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür boş olmayan bir A1 gösterimleriyle veya R1C1 gösterimleriyle ilişkilendirilmelidir.
getRecalculationInterval()RecalculationIntervalBu e-tablonun hesaplama aralığını döndürür.
getRowHeight(rowPosition)IntegerVerilen 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 tema uygulanmadıysa null değerini döndürür.
getSpreadsheetTimeZone()StringE-tabloya ilişkin saat dilimini alır.
getUrl()StringBelirli bir e-tablonun URL'sini döndürür.
getViewers()User[]Bu Spreadsheet için görüntüleyenlerin ve yorumcuların listesini alır.
hideColumn(column)voidVerilen aralıktaki sütunu veya sütunları gizler.
hideRow(row)voidBelirtilen aralıktaki satırları gizler.
insertColumnAfter(afterPosition)SheetVerilen sütun konumundan sonra bir sütun ekler.
insertColumnBefore(beforePosition)SheetVerilen sütun konumundan önce bir sütun ekler.
insertColumnsAfter(afterPosition, howMany)SheetVerilen sütun konumundan sonra belirli sayıda sütun ekler.
insertColumnsBefore(beforePosition, howMany)SheetBelirtilen sütun konumundan önce bir sayıda sütun ekler.
insertDataSourceSheet(spec)DataSourceSheetE-tabloya yeni bir DataSourceSheet ekler ve veri yürütmeyi başlatır.
insertImage(blobSource, column, row)OverGridImageBelirli bir satır ve sütundaki belgeye resim olarak Spreadsheet ekler.
insertImage(blobSource, column, row, offsetX, offsetY)OverGridImageBelirli bir satır ve sütundaki belgeye resim olarak Spreadsheet ekler. piksel uzaklığı.
insertImage(url, column, row)OverGridImageDokümana belirli bir satır ve sütundaki resim ekler.
insertImage(url, column, row, offsetX, offsetY)OverGridImageBelirli bir satır ve sütunda dokümana bir resim ekler. Bu resim belirli bir piksel uzaklığıyla gösterilir.
insertRowAfter(afterPosition)SheetVerilen satır konumundan sonra bir satır ekler.
insertRowBefore(beforePosition)SheetVerilen satır konumundan önce bir satır ekler.
insertRowsAfter(afterPosition, howMany)SheetBelirtilen satır konumundan sonra birkaç satır ekler.
insertRowsBefore(beforePosition, howMany)SheetVerilen satır konumundan önce birkaç 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şkenlerdir.
insertSheet(options)SheetVarsayılan sayfa adını ve isteğe bağlı gelişmişyi kullanarak e-tabloya yeni bir sayfa ekler bağımsız değişkenlerdir.
insertSheet(sheetName)SheetE-tabloya verilen ada yeni bir sayfa ekler.
insertSheet(sheetName, sheetIndex)SheetE-tabloya, belirtilen dizinde belirtilen ada sahip 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.
insertSheet(sheetName, options)SheetE-tabloya verilen ada sahip yeni bir sayfa ekler ve isteğe bağlı olarak gelişmiş bağımsız değişkenlerdir.
insertSheetWithDataSourceTable(spec)SheetE-tabloya yeni bir sayfa ekler, DataSourceTable Veri kaynağı spesifikasyonunu içeren tüm sayfayı açar ve verileri yürütmeye başlar.
isColumnHiddenByUser(columnPosition)BooleanBelirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.
isIterativeCalculationEnabled()BooleanBu e-tabloda yinelemeli hesaplamanın etkinleştirilip etkinleştirilmediğini döndürür.
isRowHiddenByFilter(rowPosition)BooleanBelirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür.
isRowHiddenByUser(rowPosition)BooleanBelirtilen satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.
moveActiveSheet(pos)voidEtkin sayfayı sayfa listesinde belirtilen konuma taşır.
moveChartToObjectSheet(chart)SheetYeni bir SheetType.OBJECT e-tablosu oluşturur ve sağlanan grafiği bu sayfaya taşır.
refreshAllDataSources()voidGeçersiz olanı atlayarak desteklenen tüm veri kaynaklarını ve bağlı veri kaynağı nesnelerini yeniler veri kaynağı nesneleridir.
removeEditor(emailAddress)SpreadsheetBelirtilen kullanıcıyı Spreadsheet için düzenleyenler listesinden kaldırır.
removeEditor(user)SpreadsheetBelirtilen kullanıcıyı Spreadsheet için düzenleyenler listesinden kaldırır.
removeMenu(name)voidaddMenu(name, subMenus) tarafından eklenen bir menüyü kaldırır.
removeNamedRange(name)voidVerilen ada sahip bir adlandırılmış aralığı siler.
removeViewer(emailAddress)SpreadsheetBelirtilen kullanıcıyı Spreadsheet için görüntüleyenler ve yorumcular listesinden kaldırır.
removeViewer(user)SpreadsheetBelirtilen kullanıcıyı Spreadsheet için görüntüleyenler ve yorumcular 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 current cell olarak aralıkta sol üstteki hücre.
setActiveRangeList(rangeList)RangeListBelirtilen aralık listesini active ranges olarak etkin sayfada.
setActiveSelection(range)RangeBu sayfa için etkin seçim bölgesini ayarlar.
setActiveSelection(a1Notation)RangeA1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi etkin seçimi ayarlar.
setActiveSheet(sheet)SheetBelirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar.
setActiveSheet(sheet, restoreSelection)SheetBelirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar ve sayfadaki en son seçimi içerir.
setColumnWidth(columnPosition, width)SheetBelirli bir sütunun genişliğini piksel cinsinden ayarlar.
setCurrentCell(cell)RangeBelirtilen hücreyi current cell olarak ayarlar.
setFrozenColumns(columns)voidBelirtilen sayıda sütunu dondurur.
setFrozenRows(rows)voidBelirtilen 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 etkinleştirilip etkinleştirilmeyeceğini belirler.
setMaxIterativeCalculationCycles(maxIterations)SpreadsheetYinelemeli işlem sırasında yapılması gereken maksimum hesaplama yinelemelerinin sayısını ayarlar hesaplamanız gerekir.
setNamedRange(name, range)voidAralığa ad verir.
setRecalculationInterval(recalculationInterval)SpreadsheetBu e-tablonun ne sıklıkta yeniden hesaplama yapması gerektiğini ayarlar.
setRowHeight(rowPosition, height)SheetBelirli bir satırın satır yüksekliğini piksel cinsinden ayarlar.
setSpreadsheetLocale(locale)voidE-tablonun yerel ayarını belirler.
setSpreadsheetTheme(theme)SpreadsheetThemeE-tabloda bir tema ayarlar.
setSpreadsheetTimeZone(timezone)voidE-tablonun saat dilimini ayarlar.
show(userInterface)voidBir özel kullanıcı arayüzü bileşenini, kullanıcının tarayıcısının tarayıcısında ortalanmış bir iletişim kutusunda görüntüler görünüm.
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ın bulunduğu bir pop-up pencere gösterir.
toast(msg, title)voidE-tablonun sağ alt köşesinde, verilen iletiyi içeren bir pop-up pencere ve başlığı ekleyin.
toast(msg, title, timeoutSeconds)voidE-tablonun sağ alt köşesinde, ilgili başlığı içeren bir pop-up pencere ve bir süre boyunca görünür kalan mesajdır.
unhideColumn(column)voidSütunu belirtilen aralıkta 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ütmelerin tamamlanmasını bekler ve verilen saniye kadardır.

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 amaçlı bu e-tablo.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addDeveloperMetadata(key, visibility)

Belirtilen anahtar ve görünürlüğe sahip 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 amaçlı bu e-tablo.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addDeveloperMetadata(key, value)

Belirtilen anahtar ve değere sahip 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 amaçlı bu e-tablo.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addDeveloperMetadata(key, value, visibility)

Belirtilen anahtar, değer ve görünürlüğe sahip 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 amaçlı bu e-tablo.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addEditor(emailAddress)

Belirtilen kullanıcıyı Spreadsheet için düzenleyenler listesine ekler. Kullanıcı zaten bu yöntemle kullanıcıyı görüntüleyenler listesinden çı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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addEditor(user)

Belirtilen kullanıcıyı Spreadsheet için düzenleyenler listesine ekler. Kullanıcı zaten bu yöntemle kullanıcıyı görüntüleyenler listesinden çıkarır.

Parametreler

AdTürAçıklama
userUserEklenecek kullanıcıyı gösteren bir temsil.

Return

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

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addEditors(emailAddresses)

Belirtilen kullanıcı dizisini, Spreadsheet için düzenleyenler listesine ekler. İzleyici listesinde bulunan kullanıcılar, bu yöntem sayesinde diğer kullanıcılar tarafından izleyiciler.

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 kapsamlardan bir 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 bu komutu 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 parametrelerine sahip bir dizi JavaScript eşleme. Dahil edilen kitaplıklardaki ( Library.libFunction1 gibi) işlevleri kullanabilirsiniz.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addViewer(emailAddress)

Belirtilen kullanıcıyı Spreadsheet için görüntüleyenler listesine ekler. Kullanıcı zaten kullanıyorsanız bu yöntemin herhangi bir etkisi yoktur.

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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addViewer(user)

Belirtilen kullanıcıyı Spreadsheet için görüntüleyenler listesine ekler. Kullanıcı zaten kullanıyorsanız bu yöntemin herhangi bir etkisi yoktur.

Parametreler

AdTürAçıklama
userUserEklenecek kullanıcıyı gösteren bir temsil.

Return

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

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addViewers(emailAddresses)

Belirtilen kullanıcı dizisini, Spreadsheet için görüntüleyenler listesine ekler. kullanıcı zaten düzenleyenler listesinde olduğundan bu yöntemin onlar 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

appendRow(rowContents)

Sayfadaki geçerli veri bölgesinin altına bir satır ekler. Hücre içeriği = ile tekrar eklendiğinde formül olarak yorumlanır.

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

// Appends a new row with 3 columns to the bottom of the current
// data region in the sheet containing the values in the array.
sheet.appendRow(["a man", "a plan", "panama"]);

Parametreler

AdTürAçıklama
rowContentsObject[]Sayfadaki son satırdan sonra eklenecek değerler dizisi.

Return

Sheet — Yöntem zinciri oluşturmak için yararlı olan e-tablo.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

autoResizeColumn(columnPosition)

Belirli bir sütunun genişliğini, içeriğine uyacak şekilde ayarlar.

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

sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...');

// Sets the first column to a width which fits the text
sheet.autoResizeColumn(1);

Parametreler

AdTürAçıklama
columnPositionIntegerYeniden boyutlandırmak için belirtilen sütunun konumu.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

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 amaçlı bu e-tablo.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

createDeveloperMetadataFinder()

Şu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür: e-tablo kullanabilirsiniz. Bu ayar varsayılan olarak e-tablo ile ilişkili tüm meta verileri satır ve sütunlardan oluşur.

// 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 bir geliştirici meta veri bulucudur.


createTextFinder(findText)

E-tablo için bir metin bulucu oluşturur. Bu metin bulucu, içindeki metni bulup değiştirmek için kullanılabilir. e-tabloyla değiştirebilirsiniz. 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 kapsamlardan bir 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
columnPositionIntegerSütunun, ilk sütun için 1'den başlayan konumu.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

deleteColumns(columnPosition, howMany)

Belirli bir sütun konumundan başlayan bir dizi sütunu siler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first two columns
sheet.deleteColumns(1, 2);

Parametreler

AdTürAçıklama
columnPositionIntegerSilinecek ilk sütunun konumu.
howManyIntegerSilinecek sütun sayısı.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

deleteRow(rowPosition)

Verilen satır konumundaki satırı siler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first row
sheet.deleteRow(1);

Parametreler

AdTürAçıklama
rowPositionIntegerSatırın, ilk satır için 1'den başlayan konumu.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

deleteRows(rowPosition, howMany)

Belirtilen satır konumundan başlayan satır sayısını siler.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first two rows
sheet.deleteRows(1, 2);

Parametreler

AdTürAçıklama
rowPositionIntegerSilinecek ilk satırın konumu.
howManyIntegerSilinecek satır sayısı.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

duplicateActiveSheet()

Etkin sayfayı çoğaltır 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveCell()

Bu sayfadaki etkin hücreyi döndürür.

Not: Geçerli parametreyi döndüren getCurrentCell() kullanılması tercih edilir vurgulanan hücreyi tıklayın.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Returns the active cell
var cell = sheet.getActiveCell();

Return

Range - geçerli etkin hücre

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveRange()

Etkin sayfada seçili aralığı veya etkin bir aralık yoksa null değerini döndürür. Eğer birden çok aralık seçilir. Bu yöntem yalnızca en son seçilen aralığı döndürür.

"Etkin aralık" terimi kullanıcının etkin sayfada seçtiği aralığı ifade eder. Ancak özel işlevde, hücrenin etkin bir şekilde yeniden hesaplandığını ifade eder.

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

Return

Range - etkin aralık

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Aşağıdaki kaynakları da incelemenizi öneririz:


getActiveRangeList()

Etkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null'i döndürür. değerleridir.

Tek bir aralık seçildiyse bu bir getActiveRange() çağrısı gibi davranır.

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

Return

RangeList — etkin aralıkların listesi

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Aşağıdaki kaynakları da incelemenizi öneririz:


getActiveSheet()

E-tablodaki etkin sayfayı alır.

Bir e-tablodaki etkin sayfa, o e-tabloda görüntülenmekte olan sayfadır. Kullanıcı arayüzü.

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öntemi, dosya adına uygun uzantıyı ekler. Örneğin, "dosyam.pdf". Ancak, dosya adında son noktadan sonra gelen bölümün (varsa) mevcut bir alan olduğunu varsayar değiştirilmesi gereken uzantıdır. Sonuç olarak, "AlışverişListesi.12.25.2014" şu olur: "ShoppingList.12.25.pdf".

Günlük dönüşüm kotalarını görüntülemek için bkz. Google için Kotalar Hizmetler. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkılığa tabi olabilir kotalar.

Parametreler

AdTürAçıklama
contentTypeStringDönüşümün gerçekleştirileceği MIME türü. Çoğu blob için 'application/pdf', tek geçerli seçenektir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png''ten herhangi biri de geçerlidir. Bir Google Dokümanlar dokümanı için 'text/markdown' ayrıca geçerlidir.

Return

Blob — Veriler bir blob olarak.


getBandings()

Bu e-tablodaki tüm şeritleri 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 kapsamlardan bir 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 — Veriler bir blob olarak.


getColumnWidth(columnPosition)

Belirli bir sütunun piksel cinsinden genişliğini alır.

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

// Columns start at 1
Logger.log(sheet.getColumnWidth(1));

Parametreler

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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getCurrentCell()

Etkin sayfadaki geçerli hücreyi veya geçerli hücre yoksa null değerini döndürür. İlgili içeriği oluşturmak için kullanılan geçerli hücre, Google E-Tablolar kullanıcı arayüzünde odağın bulunduğu hücredir. Koyu renkle vurgulanmıştır kenarlık. Hiçbir zaman birden fazla geçerli hücre yoktur. Kullanıcı bir veya daha fazla hücre aralığı seçtiğinde seçimdeki hücrelerden biri geçerli hücredir.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// Returns the current highlighted cell in the one of the active ranges.
var currentCell = sheet.getCurrentCell();

Return

Range — geçerli hücre

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDataRange()

Verilerin bulunduğu boyutlara karşılık gelen bir Range döndürür.

Bu, işlevsel olarak A1 ve A1 ile sınırlanan bir Aralık oluşturmaya eşdeğerdir. (Sheet.getLastColumn(), Sheet.getLastRow()).

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

// This represents ALL the data
var range = sheet.getDataRange();
var values = range.getValues();

// This logs the spreadsheet in CSV format with a trailing comma
for (var i = 0; i < values.length; i++) {
  var row = "";
  for (var j = 0; j < values[i].length; j++) {
    if (values[i][j]) {
      row = row + values[i][j];
    }
    row = row + ",";
  }
  Logger.log(row);
}

Return

Range - e-tablodaki tüm verileri içeren bir aralık

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDataSourceFormulas()

Tüm veri kaynağı formüllerini alır.

// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets
// file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source formulas on Sheet1.
// To get an array of data source formulas for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceFormulas = sheet.getDataSourceFormulas();

// Logs the first data source formula in the array.
console.log(dataSourceFormulas[0].getFormula());

Return

DataSourceFormula[]: Veri kaynağı formüllerinin listesi.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDataSourcePivotTables()

Tüm veri kaynağı pivot tablolarını alır.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

Return

DataSourcePivotTable[]: Veri kaynağı pivot tablolarının listesi.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

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 programları.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

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 bir dizi.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDataSourceTables()

Tüm veri kaynağı tablolarını alır.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].getStatus().getLastExecutionTime());

Return

DataSourceTable[]: Veri kaynağı tablolarının listesi.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

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ın yer aldığı bir dizi.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDeveloperMetadata()

Üst düzey e-tabloyla ilişkili 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 kapsamlardan bir 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 bir kullanıcı dizisi.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFormUrl()

Yanıtları bu e-tabloya gönderen formun URL'sini veya aşağıdaki durumlarda null değerini döndürür bu e-tabloda ilişkilendirilmiş form yok. Bu e-tabloya birden fazla form yanıt gönderiyorsa döndürülen form URL'si belirsiz. Alternatif olarak, sayfa başına form URL ilişkilendirmeleri Sheet.getFormUrl() yöntemi ile alını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 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 null Bu e-tabloda ilişkilendirilmiş bir form yok.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFrozenColumns()

Dondurulmuş sütunların sayısını döndürür.

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

Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());

Return

Integer - dondurulmuş sütunların sayısı

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFrozenRows()

Dondurulmuş satır sayısını döndürür.

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

Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());

Return

Integer - dondurulmuş satırların sayısı

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getId()

Bu e-tablo için benzersiz bir tanımlayıcı alır. E-tablo kimliği, e-tablonun URL'sinden çıkarılabilir. Örneğin, URL'deki e-tablo kimliği https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 = "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 kılavuz üzeri resimleri döndürür.

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

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead.
const images = sheet.getImages();

// For each image, logs the anchor cell in A1 notation.
for (const image of images) {
 console.log(image.getAnchorCell().getA1Notation());
}

Return

OverGridImage[]: Kılavuz üzeri görüntüler dizisi.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getIterativeCalculationConvergenceThreshold()

Yinelemeli hesaplama sırasında kullanılan eşik değerini döndürür. Birbirini izleyenlerin sonuçları daha az farklılık olursa 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getLastColumn()

İçerik barındıran son sütunun konumunu döndürür.

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

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Return

Integer: Sayfanın içerik barındıran son sütunu

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getLastRow()

İçerik barındıran son satırın konumunu döndürür.

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

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Return

Integer: Sayfanın içerik barındıran son satırı

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

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 kapsamlardan bir 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 kapsamlardan bir 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 tüm adlandırılmış aralıkların dizisi.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

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 kapsamlardan bir 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 kapsamlardan bir 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 korumalı aralıkları veya sayfaları temsil eden bir nesne dizisi 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 korumalı aralıkları veya sayfaları temsil eden bir nesne dizisi.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange(a1Notation)

A1 gösteriminde veya R1C1 notasyonunda belirtilen aralığı döndürür.

// Get a range A1:D4 on sheet titled "Invoices"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var range = ss.getRange("Invoices!A1:D4");

// Get cell A1 on the first sheet
var sheet = ss.getSheets()[0];
var cell = sheet.getRange("A1");

Parametreler

AdTürAçıklama
a1NotationStringA1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi döndürülecek aralık.

Return

Range - belirlenen konumdaki aralık

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRangeByName(name)

Adlandırılmış bir aralık veya belirtilen ada sahip bir aralık bulunamazsa null döndürür. Birden fazla E-tablonun sayfalarında aynı aralık adını kullanıyorsa, sayfa adını fazladan olmadan Tırnak işaretleri (ör. getRangeByName('TaxRates') veya getRangeByName('Sheet Name!TaxRates'), ancak getRangeByName('"Sheet Name"!TaxRates') değil).

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

Belirtilen sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür boş olmayan bir A1 gösterimleriyle veya R1C1 gösterimleriyle ilişkilendirilmelidir.

// Get a list of ranges A1:D4, F1:H4.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var rangeList  = sheet.getRangeList(['A1:D4', 'F1:H4']);

Parametreler

AdTürAçıklama
a1NotationsString[]A1 gösterimi veya R1C1 gösteriminde belirtildiği gibi, döndürülecek aralıkların listesi.

Return

RangeList: Belirlenen konumdaki aralık listesi

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRecalculationInterval()

Bu e-tablonun 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-tablonun hesaplama aralığı.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRowHeight(rowPosition)

Verilen satırın piksel cinsinden yüksekliğini alır.

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

// Rows start at 1
Logger.log(sheet.getRowHeight(1));

Parametreler

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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSelection()

E-tablodaki geçerli Selection değerini döndürür.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var currentCell = selection.getCurrentCell();

Return

Selection - geçerli seçim

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSheetByName(name)

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

Birden fazla sayfa aynı ada sahipse en soldaki sayfa döndürülür. Şu durumda null değerini döndürür: belirtilen ada sahip bir sayfa yok.

// 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 adın bulunduğu 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, tek tip bir Sayfa konumundan bağımsız olarak sayfa oluşturma zamanında atanan, artan tam sayı. Bu değeri, Sheet örneği yerine gridId parametresi alan Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd) gibi yöntemlerle birlikte kullanışlıdır.

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

Logger.log(sheet.getSheetId());

Return

Integer - E-tabloya özgü sayfa kimliği

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSheetName()

Sayfa adını döndürür.

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

Logger.log(sheet.getSheetName());

Return

String — sayfanın adı

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSheetValues(startRow, startColumn, numRows, numColumns)

Verilen koordinatlardan başlayarak bu aralık için değerlerin dikdörtgen ızgarasını döndürür. A -1 satır veya sütun konumu olarak verilen değer, en son satırı veya sütunu almaya eşdeğerdir yer alır.

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

// The two samples below produce the same output
var values = sheet.getSheetValues(1, 1, 3, 3);
Logger.log(values);

var range = sheet.getRange(1, 1, 3, 3);
values = range.getValues();
Logger.log(values);

Parametreler

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 bir değer dizisi

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

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 sayfalardan oluşan 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 kapsamlardan bir 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 tema uygulanmadıysa null değerini döndürür.

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

Return

SpreadsheetTheme — Geçerli olarak uygulanan tema.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSpreadsheetTimeZone()

E-tabloya ilişkin 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 — "long" olarak belirtilen saat dilimi biçimindedir (örneğin, "Amerika/New_York", (Joda.org) tarafından sunulmaktadır.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getUrl()

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

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

Return

String — Belirli bir e-tablonun URL'si.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getViewers()

Bu Spreadsheet için görüntüleyenlerin ve yorumcuları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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

hideColumn(column)

Verilen aralıktaki sütunu veya sütunları gizler.

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

// This hides the first column
let range = sheet.getRange("A1");
sheet.hideColumn(range);

// This hides the first 3 columns
let range = sheet.getRange("A:C");
sheet.hideColumn(range);

Parametreler

AdTürAçıklama
columnRangeGizlenecek sütun aralığı.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

hideRow(row)

Belirtilen aralıktaki satırları gizler.

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

// This hides the first row
var range = sheet.getRange("A1");
sheet.hideRow(range);

Parametreler

AdTürAçıklama
rowRangeGizlenecek satır aralığı.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertColumnAfter(afterPosition)

Verilen sütun konumundan sonra bir sütun ekler.

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

// This inserts a column after the first column position
sheet.insertColumnAfter(1);

Parametreler

AdTürAçıklama
afterPositionIntegerKendisinden sonra yeni sütunun ekleneceği sütun.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertColumnBefore(beforePosition)

Verilen sütun konumundan önce bir sütun ekler.

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

// This inserts a column in the first column position
sheet.insertColumnBefore(1);

Parametreler

AdTürAçıklama
beforePositionIntegerKendisine yeni sütunun eklenmesi gereken sütun.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertColumnsAfter(afterPosition, howMany)

Verilen sütun konumundan sonra belirli sayıda sütun ekler.

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

// Inserts two columns after the first column on the first sheet of the spreadsheet.
sheet.insertColumnsAfter(1,2);

Parametreler

AdTürAçıklama
afterPositionIntegerKendisinden sonra yeni sütunun ekleneceği sütun.
howManyIntegerEklenecek sütun sayısı.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertColumnsBefore(beforePosition, howMany)

Belirtilen sütun konumundan önce bir sayıda sütun ekler.

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

// This inserts five columns before the first column
sheet.insertColumnsBefore(1, 5);

Parametreler

AdTürAçıklama
beforePositionIntegerKendisine yeni sütunun eklenmesi gereken sütun.
howManyIntegerEklenecek sütun sayısı.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertDataSourceSheet(spec)

E-tabloya yeni bir DataSourceSheet ekler ve veri yürütmeyi başlatır. Kullanıcı Bu durumda yeni sayfa da etkin sayfa olur.

Veri kaynağı türü etkin değilse istisna atar. Belirli bir veri kaynağına yönelik veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanma türü.

// 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertImage(blobSource, column, row)

Belirli bir satır ve sütundaki belgeye resim olarak 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertImage(blobSource, column, row, offsetX, offsetY)

Belirli bir satır ve sütundaki belgeye resim olarak Spreadsheet ekler. piksel uzaklığı. Resim boyutu blob içeriklerinden alınır. Desteklenen maksimum blob boyut 2 MB'tır.

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

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

Parametreler

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 (piksel cinsinden).
offsetYIntegerHücre köşesinden dikey uzaklık (piksel cinsinden).

Return

OverGridImage — Eklenen resim.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertImage(url, column, row)

Dokümana belirli bir satır ve sütundaki resim ekler.

Sağlanan URL herkesin erişimine açık olmalıdır.

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

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);

Parametreler

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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertImage(url, column, row, offsetX, offsetY)

Belirli bir satır ve sütunda dokümana bir resim ekler. Bu resim belirli bir piksel uzaklığıyla gösterilir.

Sağlanan URL herkesin erişimine açık olmalıdır.

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

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);

Parametreler

AdTürAçıklama
urlStringResmin URL'si.
columnIntegerSütun konumu.
rowIntegerSatır konumu.
offsetXIntegerHücre köşesinden yatay uzaklık (piksel cinsinden).
offsetYIntegerHücre köşesinden dikey uzaklık (piksel cinsinden).

Return

OverGridImage — Eklenen resim.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertRowAfter(afterPosition)

Verilen satır konumundan sonra bir satır ekler.

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

// This inserts a row after the first row position
sheet.insertRowAfter(1);

Parametreler

AdTürAçıklama
afterPositionIntegerKendisinden sonra yeni satırın ekleneceği satır.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertRowBefore(beforePosition)

Verilen satır konumundan önce bir satır ekler.

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

// This inserts a row before the first row position
sheet.insertRowBefore(1);

Parametreler

AdTürAçıklama
beforePositionIntegerKendisine yeni satırın eklenmesi gereken satır.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertRowsAfter(afterPosition, howMany)

Belirtilen satır konumundan sonra birkaç satır ekler.

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

// This inserts five rows after the first row
sheet.insertRowsAfter(1, 5);

Parametreler

AdTürAçıklama
afterPositionIntegerYeni satırların ekleneceği satır.
howManyIntegerEklenecek satır sayısı.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertRowsBefore(beforePosition, howMany)

Verilen satır konumundan önce birkaç satır ekler.

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

// This inserts five rows before the first row
sheet.insertRowsBefore(1, 5);

Parametreler

AdTürAçıklama
beforePositionIntegerKendisine yeni satırların ekleneceği satır.
howManyIntegerEklenecek satır sayısı.

Return

Sheet — e-tablo, yöntem zinciri için kullanışlıdır

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertSheet()

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

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

Return

Sheet: Yeni sayfa.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertSheet(sheetIndex)

Belirtilen dizindeki e-tabloya yeni bir sayfa ekler. Yeni sayfa, etkin sayfasına gitmelidir.

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

Parametreler

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

Return

Sheet: Yeni sayfa.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertSheet(sheetIndex, options)

Belirtilen dizindeki e-tabloya yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenlerdir. 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 e-tablonun dizini. Bir sayfayı ilk sayfa olarak eklemek için değeri 0 olarak ayarlayın.
optionsObjectİsteğe bağlı JavaScript gelişmiş bağımsız değişkenleri.

Gelişmiş parametreler

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

Return

Sheet: Yeni sayfa.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertSheet(options)

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

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

Parametreler

AdTürAçıklama
optionsObjectİsteğe bağlı JavaScript gelişmiş bağımsız değişkenleri aşağıda listelenmiştir.

Gelişmiş parametreler

AdTürAçıklama
templateSheetŞablon sayfası nesnesindeki tüm veriler tıklayın. E-tablo ş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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertSheet(sheetName)

E-tabloya verilen ada yeni bir sayfa ekler. Yeni sayfa, etkin sayfasına gitmelidir.

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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertSheet(sheetName, sheetIndex)

E-tabloya, belirtilen dizinde belirtilen ada sahip 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 e-tablonun dizini. Bir sayfayı ilk sayfa olarak eklemek için değeri 0 olarak ayarlayın.

Return

Sheet: Yeni sayfa.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

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. 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ı ilk sayfa olarak eklemek için 0 olarak ayarlayın.
optionsObjectİsteğe bağlı JavaScript gelişmiş bağımsız değişkenleri.

Gelişmiş parametreler

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

Return

Sheet: Yeni sayfa.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertSheet(sheetName, options)

E-tabloya verilen ada sahip yeni bir sayfa ekler ve isteğe bağlı olarak gelişmiş bağımsız değişkenlerdir. 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ı JavaScript gelişmiş bağımsız değişkenleri.

Gelişmiş parametreler

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

Return

Sheet: Yeni sayfa.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertSheetWithDataSourceTable(spec)

E-tabloya yeni bir sayfa ekler, DataSourceTable Veri kaynağı spesifikasyonunu içeren tüm sayfayı açar ve verileri yürütmeye başlar. Yan olarak yeni sayfayı etkin sayfa haline getirir.

Veri kaynağı türü etkin değilse istisna atar. Belirli bir veri kaynağına yönelik veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanma türü.

// 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isColumnHiddenByUser(columnPosition)

Belirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.

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

// Columns start at 1
Logger.log(sheet.isColumnHiddenByUser(1));

Parametreler

AdTürAçıklama
columnPositionIntegerİncelenecek sütunun konumu.

Return

Boolean — Sütun gizliyse true, gizliyse false.

Yetkilendirme

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

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isIterativeCalculationEnabled()

Bu e-tabloda yinelemeli hesaplamanın etkinleştirilip etkinleştirilmediğini 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isRowHiddenByFilter(rowPosition)

Belirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür.

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByFilter(1));

Parametreler

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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isRowHiddenByUser(rowPosition)

Belirtilen satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByUser(1));

Parametreler

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 kapsamlardan bir 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 belirtilen konuma taşır. Şu durumda bir istisna atar: konum negatif veya sayfa sayısından büyük.

// 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 kapsamlardan bir 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 e-tablosu oluşturur ve sağlanan grafiği bu sayfaya 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

refreshAllDataSources()

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

Şunun için veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanın: belirli bir veri kaynağı türü.

// 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

removeEditor(emailAddress)

Belirtilen kullanıcıyı Spreadsheet için düzenleyenler listesinden kaldırır. Bu yöntem Şu özelliklere sahip bir kullanıcı sınıfına aitse, kullanıcıların Spreadsheet öğesine erişmesini engelle: genel erişim (örneğin, Spreadsheet, kullanıcının tümüyle paylaşılıyorsa) veya Spreadsheet, kullanıcının erişebileceği bir ortak drive'da bulunuyorsa.

Bu işlem, Drive dosyaları için kullanıcıyı, görüntüleyenler listesinden de kaldırır.