Class DataSource

DataSource

Mevcut veri kaynağına erişin ve ayarı değiştirin. Yeni veri kaynağına sahip bir veri kaynağı tablosu oluşturmak için DataSourceTable sayfasını inceleyin.

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
createCalculatedColumn(name, formula)DataSourceColumnHesaplanmış bir sütun oluşturur.
createDataSourcePivotTableOnNewSheet()DataSourcePivotTableYeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı pivot tablosu oluşturur.
createDataSourceTableOnNewSheet()DataSourceTableYeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı tablosu oluşturur.
getCalculatedColumnByName(columnName)DataSourceColumnVeri kaynağında sütun adıyla eşleşen hesaplanmış sütunu döndürür.
getCalculatedColumns()DataSourceColumn[]Veri kaynağındaki hesaplanan tüm sütunları döndürür.
getColumns()DataSourceColumn[]Veri kaynağındaki tüm sütunları döndürür.
getDataSourceSheets()DataSourceSheet[]Bu veri kaynağıyla ilişkili veri kaynağı sayfalarını döndürür.
getSpec()DataSourceSpecVeri kaynağı spesifikasyonunu alır.
refreshAllLinkedDataSourceObjects()voidVeri kaynağına bağlı tüm veri kaynağı nesnelerini yeniler.
updateSpec(spec)DataSourceVeri kaynağı spesifikasyonunu günceller ve bu veri kaynağına bağlı veri kaynağı nesnelerini yeni spesifikasyonla yeniler.
updateSpec(spec, refreshAllLinkedObjects)DataSourceVeri kaynağı spesifikasyonunu günceller ve bağlı data source sheets öğesini yeni spesifikasyonla yeniler.
waitForAllDataExecutionsCompletion(timeoutInSeconds)voidBağlı veri kaynağı nesnelerinin tüm mevcut yürütme işlemleri tamamlanana kadar bekler ve belirtilen saniye sayısından sonra zaman aşımına uğrar.

Ayrıntılı belgeler

createCalculatedColumn(name, formula)

Hesaplanmış bir sütun oluşturur.

Parametreler

AdTürAçıklama
nameStringHesaplanan sütunun adı.
formulaStringHesaplanmış sütun formülü.

Return

DataSourceColumn: Yeni oluşturulan hesaplanmış sütun.

Yetkilendirme

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

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

createDataSourcePivotTableOnNewSheet()

Yeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı pivot tablosu oluşturur. Bunun sonucunda, yeni sayfa etkin sayfaya dönüştürülür.

Return

DataSourcePivotTable: Yeni oluşturulan veri kaynağı pivot tablosu.

Yetkilendirme

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

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

createDataSourceTableOnNewSheet()

Yeni bir sayfanın ilk hücresinde bu veri kaynağından bir veri kaynağı tablosu oluşturur. Bir yan etki olarak, yeni sayfayı etkin sayfa haline getirir.

Return

DataSourceTable: Yeni oluşturulan veri kaynağı tablosu.

Yetkilendirme

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

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

getCalculatedColumnByName(columnName)

Veri kaynağında sütun adıyla eşleşen hesaplanmış sütunu döndürür.

Parametreler

AdTürAçıklama
columnNameStringAlınacak hesaplanan sütunun adı.

Return

DataSourceColumn: Sütun adıyla eşleşen hesaplanmış sütun veya hesaplanmış bir sütun yoksa null.

Yetkilendirme

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

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

getCalculatedColumns()

Veri kaynağındaki hesaplanan tüm sütunları döndürür.

Return

DataSourceColumn[]: Veri kaynağındaki hesaplanan tüm sütunları içeren bir dizi.

Yetkilendirme

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

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

getColumns()

Veri kaynağındaki tüm sütunları döndürür.

Return

DataSourceColumn[]: Veri kaynağındaki tüm DataSourceColumn öğelerini içeren bir dizi.

Yetkilendirme

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

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

getDataSourceSheets()

Bu veri kaynağıyla ilişkili veri kaynağı sayfalarını döndürür.

Return

DataSourceSheet[]: Veri kaynağı sayfaları dizisi.

Yetkilendirme

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

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

getSpec()

Veri kaynağı spesifikasyonunu alır.

Return

DataSourceSpec: Veri kaynağı spesifikasyonu.

Yetkilendirme

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

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

refreshAllLinkedDataSourceObjects()

Veri kaynağına bağlı tüm veri kaynağı nesnelerini yeniler.

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

Yetkilendirme

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

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

updateSpec(spec)

Veri kaynağı spesifikasyonunu günceller ve bu veri kaynağına bağlı veri kaynağı nesnelerini yeni spesifikasyonla yeniler.

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

Parametreler

AdTürAçıklama
specDataSourceSpecGüncellenecek veri kaynağı spesifikasyonu.

Return

DataSource: Veri kaynağı.

Yetkilendirme

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

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

updateSpec(spec, refreshAllLinkedObjects)

Veri kaynağı spesifikasyonunu günceller ve bağlı data source sheets öğesini yeni spesifikasyonla yeniler.

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

Parametreler

AdTürAçıklama
specDataSourceSpecGüncellenecek veri kaynağı spesifikasyonu.
refreshAllLinkedObjectsBooleantrue ise bu veri kaynağına bağlı tüm veri kaynağı nesnelerini de yeniler.

Return

DataSource: Veri kaynağı.

Yetkilendirme

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

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

waitForAllDataExecutionsCompletion(timeoutInSeconds)

Bağlı veri kaynağı nesnelerinin tüm mevcut yürütme işlemleri tamamlanana kadar bekler ve belirtilen saniye sayısından sonra zaman aşımına uğrar. Yürütmeler zaman aşımına uğradığında tamamlanmazsa ancak veri yürütme işlemlerini iptal etmezse bir istisna oluşturur.

Parametreler

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

Yetkilendirme

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

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