Mevcut bir veri kaynağı grafiğine erişme ve grafik üzerinde değişiklik yapma.
Bu sınıfı yalnızca bir veritabanına bağlı verilerle kullanın.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
forceRefreshData() | DataSourceChart | Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler. |
getDataSource() | DataSource | Nesnenin bağlı olduğu veri kaynağını alır. |
getStatus() | DataExecutionStatus | Nesnenin veri yürütme durumunu alır. |
refreshData() | DataSourceChart | Nesnenin verilerini yeniler. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Mevcut yürütme işlemi tamamlanana kadar bekler ve sağlanan saniye sayısından sonra zaman aşımına uğrar. |
Ayrıntılı belgeler
forceRefreshData()
Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler. Daha fazla bilgi için refreshData()
sayfasını ziyaret edin.
Veri kaynağı türü etkinleştirilmemişse 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 kapsamların 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 kapsamların 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 kapsamların 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. Belirtimi güncellemek için DataSource#updateSpec()
öğesini kullanın. Veri kaynağında beklenmeyen düzenlemeleri önlemek için bu yöntem forceRefreshData()
yerine tercih edilir.
Veri kaynağı türü etkinleştirilmemişse 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 kapsamların 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 sağlanan saniye sayısından sonra zaman aşımına uğrar. Yürütme işlemi, zaman aşımına uğradığında tamamlanmazsa ancak veri yürütmeyi iptal etmezse istisna oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timeoutInSeconds | Integer | Veri yürütülmesi için beklenecek saniye (saniye cinsinden). Maksimum süre 300 saniyedir. |
Return
DataExecutionStatus
: Veri yürütme durumu.
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