Class DataSourceChart

DataSourceChart

Mevcut bir veri kaynağı grafiğine erişip değiştirin.

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

Yöntemler

YöntemDönüş türüKısa açıklama
cancelDataRefresh()DataSourceChartŞu anda çalışıyorsa bu nesneyle ilişkili veri yenilemeyi iptal eder.
forceRefreshData()DataSourceChartGeçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler.
getDataSource()DataSourceNesnenin bağlı olduğu veri kaynağını alır.
getStatus()DataExecutionStatusNesnenin veri yürütme durumunu alır.
refreshData()DataSourceChartNesnenin verilerini yeniler.
waitForCompletion(timeoutInSeconds)DataExecutionStatusMevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı sonunda zaman aşımına uğrar.

Ayrıntılı belgeler

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

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

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

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

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

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

waitForCompletion(timeoutInSeconds)

Mevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı sonunda 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çin beklenecek süre (saniye cinsinden). 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