Mevcut bir veri kaynağı grafiğine erişme ve bu grafiği değiştirme.
Bu sınıfı yalnızca BigQuery veritabanına bağlı verilerle kullanın.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
cancel | Data | Şu anda çalışıyorsa bu nesneyle ilişkili veri yenilemeyi iptal eder. |
force | Data | Mevcut durumdan bağımsız olarak bu nesnenin verilerini yeniler. |
get | Data | Nesnenin bağlı olduğu veri kaynağını alır. |
get | Data | Nesnenin veri yürütme durumunu alır. |
refresh | Data | Nesnenin verilerini yeniler. |
wait | Data | Mevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı dolduktan sonra zaman aşımına uğrar. |
Ayrıntılı dokümanlar
cancel Data Refresh()
Ş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 atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere Spreadsheet
yöntemlerini kullanın.
Return
Data
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
force Refresh Data()
Mevcut durumdan bağımsız olarak bu nesnenin verilerini yeniler. Daha fazla bilgi için refresh
bölümüne bakın. Bu nesnenin şu anda çalışan yenileme işlemini iptal etmek istiyorsanız cancel
bölümüne bakın.
Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere Spreadsheet
yöntemlerini kullanın.
Return
Data
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source()
Nesnenin bağlı olduğu veri kaynağını alır.
Return
Data
: Veri kaynağı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Status()
Nesnenin veri yürütme durumunu alır.
Return
Data
: Veri yürütme durumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refresh Data()
Nesnenin verilerini yeniler.
Şu anda error
durumundaysa istisna oluşturur. Spesifikasyonu güncellemek için Data
simgesini kullanın. Veri kaynağında beklenmedik düzenlemeleri önlemek için bu yöntem, force
yerine tercih edilir.
Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere Spreadsheet
yöntemlerini kullanın.
Return
Data
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
wait For Completion(timeoutInSeconds)
Mevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı dolduktan sonra zaman aşımına uğrar. Zaman aşımı olduğunda yürütme tamamlanmazsa bir istisna oluşturur ancak veri yürütme işlemini iptal etmez.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timeout | Integer | Veri yürütme işlemi için bekleme süresi (saniye cinsinden). Maksimum süre 300 saniyedir. |
Return
Data
: Veri yürütme durumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets