Class DataSourceChart

DataSourceChart

Mevcut bir veri kaynağı grafiğine erişme ve bu grafiği değiştirme

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
cancelDataRefresh()DataSourceChartBu nesne çalışıyorsa bu nesneyle ilişkili veri yenilemesini 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)DataExecutionStatusGeçerli yürütme tamamlanana kadar bekler ve sağlanan saniye sayısı dolduktan sonra zaman aşımına uğrar.

Ayrıntılı belgeler

cancelDataRefresh()

Bu nesne çalışıyorsa bu nesneyle ilişkili veri yenilemesini iptal eder.

Bu örnekte, formül yenilemesinin 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 bir istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için 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() sayfasına bakın. Bu nesnenin şu anda devam eden yenilemesini iptal etmek istiyorsanız cancelDataRefresh() adresine bakın.

Veri kaynağı türü etkin değilse bir istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için 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 durumudur.

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. Teknik özellikleri güncellemek için DataSource#updateSpec() öğesini kullanın. Veri kaynağında beklenmeyen düzenlemeleri önlemek için yöntem forceRefreshData() yerine tercih edilir.

Veri kaynağı türü etkin değilse bir istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için 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)

Geçerli yürütme tamamlanana kadar bekler ve sağlanan saniye sayısı dolduktan sonra zaman aşımına uğrar. Zaman aşımına uğradığında yürütme tamamlanmazsa ancak veri yürütme işlemini iptal etmezse bir istisna oluşturur.

Parametreler

AdTürAçıklama
timeoutInSecondsIntegerSaniye cinsinden veri yürütülmesi için beklenecek süre. Maksimum süre 300 saniyedir.

Return

DataExecutionStatus: Veri yürütme durumudur.

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