Class DataSourceSheet

DataSourceSheet

Mevcut veri kaynağı sayfasına erişme ve sayfada değişiklik yapma. Yeni bir veri kaynağı sayfası oluşturmak için Spreadsheet.insertDataSourceSheet(spec) işlevini kullanın.

Bu sınıfı yalnızca bir veritabanına bağlı verilerle kullanın.

Yöntemler

YöntemDönüş türüKısa açıklama
addFilter(columnName, filterCriteria)DataSourceSheetVeri kaynağı sayfasına uygulanan bir filtre ekler.
asSheet()SheetVeri kaynağı sayfasını normal sayfa nesnesi olarak döndürür.
autoResizeColumn(columnName)DataSourceSheetBelirtilen sütunun genişliğini otomatik olarak yeniden boyutlandırır.
autoResizeColumns(columnNames)DataSourceSheetBelirtilen sütunların genişliğini otomatik olarak yeniden boyutlandırır.
cancelDataRefresh()DataSourceSheetBu nesne şu anda çalışıyorsa, nesneyle ilişkili veri yenileme işlemini iptal eder.
forceRefreshData()DataSourceSheetMevcut durumdan bağımsız olarak bu nesnenin verilerini yeniler.
getColumnWidth(columnName)IntegerBelirtilen sütunun genişliğini döndürür.
getDataSource()DataSourceNesnenin bağlı olduğu veri kaynağını alır.
getFilters()DataSourceSheetFilter[]Veri kaynağı sayfasına uygulanan tüm filtreleri döndürür.
getSheetValues(columnName)Object[]Sağlanan sütun adı için veri kaynağı sayfasındaki tüm değerleri döndürür.
getSheetValues(columnName, startRow, numRows)Object[]Sağlanan sütun adı için, veri kaynağı sayfasındaki tüm değerleri başlangıç satırı (1 temelli) ve sağlanan numRows değerine kadar.
getSortSpecs()SortSpec[]Veri kaynağı sayfasındaki tüm sıralama özelliklerini alır.
getStatus()DataExecutionStatusNesnenin veri yürütme durumunu alır.
refreshData()DataSourceSheetNesnenin verilerini yeniler.
removeFilters(columnName)DataSourceSheetVeri kaynağı sayfası sütununa uygulanan tüm filtreleri kaldırır.
removeSortSpec(columnName)DataSourceSheetVeri kaynağı sayfasındaki bir sütunda sıralama özelliğini kaldırır.
setColumnWidth(columnName, width)DataSourceSheetBelirtilen sütunun genişliğini ayarlar.
setColumnWidths(columnNames, width)DataSourceSheetBelirtilen sütunların genişliğini ayarlar.
setSortSpec(columnName, ascending)DataSourceSheetVeri kaynağı sayfasındaki bir sütunda sıralama özelliğini ayarlar.
setSortSpec(columnName, sortOrder)DataSourceSheetVeri kaynağı sayfasındaki bir sütunda sıralama özelliğini ayarlar.
waitForCompletion(timeoutInSeconds)DataExecutionStatusGeçerli yürütme işlemi tamamlanana kadar bekler. Belirtilen sayıda saniye geçtikten sonra zaman aşımına uğrar.

Ayrıntılı belgeler

addFilter(columnName, filterCriteria)

Veri kaynağı sayfasına uygulanan bir filtreyi ekler.

Parametreler

AdTürAçıklama
columnNameStringBu filtrenin uygulanacağı sütunun adı.
filterCriteriaFilterCriteriaUygulanacak filtre ölçütleri.

Return

DataSourceSheet — Yöntem zinciri için 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

asSheet()

Veri kaynağı sayfasını normal sayfa nesnesi olarak döndürür.

Return

Sheet: Normal 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(columnName)

Belirtilen sütunun genişliğini otomatik olarak yeniden boyutlandırır.

Parametreler

AdTürAçıklama
columnNameStringSütun adı.

Return

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

autoResizeColumns(columnNames)

Belirtilen sütunların genişliğini otomatik olarak yeniden boyutlandırır.

Parametreler

AdTürAçıklama
columnNamesString[]Güncellenecek sütun adlarının listesi.

Return

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

cancelDataRefresh()

Bu nesne şu anda çalışıyorsa, nesneyle ilişkili veri yenileme işlemini iptal eder.

Bu örnekte, formül yenilemenin nasıl iptal edileceği gösterilmektedir.

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

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

Return

DataSourceSheet: Veri nesnesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

forceRefreshData()

Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler. Şunun için refreshData() sayfasına bakın: inceleyebilirsiniz. Bu nesnenin şu anda çalışan yenileme işlemini iptal etmek istiyorsanız cancelDataRefresh() bölümüne bakın.

Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

Return

DataSourceSheet: Veri nesnesi.

Yetkilendirme

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

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

getColumnWidth(columnName)

Belirtilen sütunun genişliğini döndürür.

Parametreler

AdTürAçıklama
columnNameStringSütun adı.

Return

Integer: Sütunun genişliği veya sütun varsayılan genişliği kullanıyorsa 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

getDataSource()

Nesnenin bağlı olduğu veri kaynağını alır.

Return

DataSource — Veri kaynağı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getFilters()

Veri kaynağı sayfasına uygulanan tüm filtreleri döndürür.

Return

DataSourceSheetFilter[]: Veri kaynağı sayfasına uygulanan tüm filtrelerin 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

getSheetValues(columnName)

Sağlanan sütun adı için veri kaynağı sayfasındaki tüm değerleri döndürür.

Parametreler

AdTürAçıklama
columnNameStringDeğerlerinin alınacağı veri kaynağı sütununun adı.

Return

Object[]: Tek 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

getSheetValues(columnName, startRow, numRows)

Sağlanan sütun adı için, veri kaynağı sayfasındaki tüm değerleri başlangıç satırı (1 temelli) ve sağlanan numRows değerine kadar.

Parametreler

AdTürAçıklama
columnNameStringDeğerlerinin alınacağı veri kaynağı sütununun adı.
startRowIntegerDeğer getirmeye başlanacak satır konumu.
numRowsIntegerGetirilecek satır sayısı.

Return

Object[]: Tek 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

getSortSpecs()

Veri kaynağı sayfasındaki tüm sıralama özelliklerini alır.

Return

SortSpec[]: Sıralama özelliklerinin 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

getStatus()

Nesnenin veri yürütme durumunu alır.

Return

DataExecutionStatus — Veri yürütme durumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

refreshData()

Nesnenin verilerini yeniler.

Şu anda error durumundaysa istisna atar. Spesifikasyonu güncellemek için DataSource#updateSpec() simgesini kullanın. Yöntem veri kaynağında beklenmeyen düzenlemeleri önlemek için forceRefreshData() yerine tercih edilir.

Veri kaynağı türü etkinleştirilmemişse 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ü.

Return

DataSourceSheet: Veri nesnesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

removeFilters(columnName)

Veri kaynağı sayfası sütununa uygulanan tüm filtreleri kaldırır.

Parametreler

AdTürAçıklama
columnNameStringFiltrelerin kaldırılacağı sütunun adı.

Return

DataSourceSheet — Yöntem zinciri için veri kaynağı sayfası.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

removeSortSpec(columnName)

Veri kaynağı sayfasındaki bir sütunda sıralama özelliğini kaldırır.

Parametreler

AdTürAçıklama
columnNameStringSütunun adı.

Return

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

setColumnWidth(columnName, width)

Belirtilen sütunun genişliğini ayarlar.

Parametreler

AdTürAçıklama
columnNameStringSütun adı.
widthIntegerSütunun yeni genişliği.

Return

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

setColumnWidths(columnNames, width)

Belirtilen sütunların genişliğini ayarlar.

Parametreler

AdTürAçıklama
columnNamesString[]Güncellenecek sütun adlarının listesi.
widthIntegerSütunların yeni genişliği.

Return

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

setSortSpec(columnName, ascending)

Veri kaynağı sayfasındaki bir sütunda sıralama spesifikasyonunu ayarlar.

Parametreler

AdTürAçıklama
columnNameStringSıralanacak sütunun adı.
ascendingBooleantrue ise sütunu artan düzende, false ise azalan düzende sıralayın.

Return

DataSourceSheet: Zincirleme için 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

setSortSpec(columnName, sortOrder)

Veri kaynağı sayfasındaki bir sütunda sıralama özelliğini ayarlar.

Parametreler

AdTürAçıklama
columnNameStringSıralanacak sütunun adı.
sortOrderSortOrderSıralama ölçütü.

Return

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

waitForCompletion(timeoutInSeconds)

Mevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı dolduktan sonra zaman aşımına uğrar. Zaman aşımına uğradığında yürütme tamamlanmazsa bir istisna atar ancak veri yürütme sürecidir.

Parametreler

AdTürAçıklama
timeoutInSecondsIntegerVerilerin yürütülmesi için beklenecek saniye cinsinden süre. Maksimum değer 300'dür. saniye.

Return

DataExecutionStatus: Veri yürütme durumu.

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