Class DataSourceSheet

VeriKaynakSayfa

Mevcut veri kaynağı sayfasına erişme ve sayfayı değiştirme Yeni bir veri kaynağı sayfası oluşturmak için Spreadsheet.insertDataSourceSheet(spec) simgesini 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 bir 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()DataSourceSheetŞu anda çalışıyorsa bu nesneyle ilişkili veri yenilemeyi iptal eder.
forceRefreshData()DataSourceSheetGeçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler.
getColumnWidth(columnName)Integer|nullBelirtilen 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[]Belirtilen sütun adı için veri kaynağı sayfasındaki tüm değerleri döndürür.
getSheetValues(columnName, startRow, numRows)Object[]Belirtilen başlangıç satırından (1 tabanlı) başlayıp belirtilen numRows'ya kadar, belirtilen sütun adı için veri kaynağı sayfasındaki tüm değerleri döndürür.
getSortSpecs()SortSpec[]Veri kaynağı sayfasındaki tüm sıralama spesifikasyonlarını alır.
getStatus()DataExecutionStatusNesnenin veri yürütme durumunu alır.
refreshData()DataSourceSheetNesnenin verilerini yeniler.
removeFilters(columnName)DataSourceSheetVeri kaynağı sayfasının sütununa uygulanan tüm filtreleri kaldırır.
removeSortSpec(columnName)DataSourceSheetVeri kaynağı sayfasındaki bir sütunda sıralama belirtimini 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 spesifikasyonunu ayarlar.
setSortSpec(columnName, sortOrder)DataSourceSheetVeri kaynağı sayfasındaki bir sütunda sıralama spesifikasyonunu ayarlar.
waitForCompletion(timeoutInSeconds)DataExecutionStatusMevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı geçtikten sonra zaman aşımına uğrar.

Ayrıntılı belgeler

addFilter(columnName, filterCriteria)

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

Parametreler

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

Return

DataSourceSheet: Yöntem zincirleme için veri kaynağı sayfası.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 bir sayfa nesnesi olarak döndürür.

Return

Sheet: Normal sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 kullanılan bu veri kaynağı sayfası.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 kullanılan bu veri kaynağı sayfası.

Yetkilendirme

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

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

cancelDataRefresh()

Şu anda çalışıyorsa bu nesneyle ilişkili veri yenilemeyi 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ü etkinleştirilmemişse istisna oluşturur. Belirli bir veri kaynağı türü için veri yürütmeyi 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 biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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. Daha fazla bilgi için refreshData() bölümüne bakın. Bu nesnenin şu anda devam eden yenileme işlemini iptal etmek istiyorsanız cancelDataRefresh() başlıklı makaleyi inceleyin.

Veri kaynağı türü etkinleştirilmemişse istisna oluşturur. Belirli bir veri kaynağı türü için veri yürütmeyi 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 biri 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|null: 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 biri 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

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

getSheetValues(columnName)

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

Parametreler

AdTürAçıklama
columnNameStringDeğerlerin getirileceği veri kaynağı sütununun adı.

Return

Object[]: Değerlerden oluşan tek boyutlu bir dizi.

Yetkilendirme

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

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

getSheetValues(columnName, startRow, numRows)

Belirtilen başlangıç satırından (1 tabanlı) başlayıp belirtilen numRows'ya kadar, belirtilen sütun adı için veri kaynağı sayfasındaki tüm değerleri döndürür.

Parametreler

AdTürAçıklama
columnNameStringDeğerlerin getirileceği veri kaynağı sütununun adı.
startRowIntegerDeğerlerin getirilmeye başlanacağı satır konumu.
numRowsIntegerGetirilecek satır sayısı.

Return

Object[]: Değerlerden oluşan tek boyutlu bir dizi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 spesifikasyonlarını alır.

Return

SortSpec[]: Sıralama spesifikasyonlarının listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

refreshData()

Nesnenin verilerini yeniler.

Şu anda error durumundaysa istisna oluşturur. Spesifikasyonu güncellemek için DataSource#updateSpec() simgesini kullanın. Bu yöntem, veri kaynağında beklenmedik düzenlemeleri önlemek için forceRefreshData() yerine tercih edilir.

Veri kaynağı türü etkinleştirilmemişse istisna oluşturur. Belirli bir veri kaynağı türü için veri yürütmeyi 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 biri veya daha fazlasıyla yetkilendirme gerektirir:

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

removeFilters(columnName)

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

Parametreler

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

Return

DataSourceSheet: Yöntem zincirleme için veri kaynağı sayfası.

Yetkilendirme

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

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

removeSortSpec(columnName)

Veri kaynağı sayfasındaki bir sütunda sıralama belirtimini 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 biri 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 kullanılan bu veri kaynağı sayfası.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 kullanılan bu veri kaynağı sayfası.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 biri 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 spesifikasyonunu 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 biri 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ı geçtikten sonra zaman aşımına uğrar. Zaman aşımına uğradığında yürütme tamamlanmazsa istisna oluşturur ancak veri yürütmeyi iptal etmez.

Parametreler

AdTürAçıklama
timeoutInSecondsIntegerVeri yürütme işleminin tamamlanması için beklenecek süre (saniye). Maksimum süre 300 saniyedir.

Return

DataExecutionStatus: Veri yürütme durumu.

Yetkilendirme

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

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