Mengakses dan mengubah diagram sumber data yang ada.
Hanya gunakan class ini dengan data yang terhubung ke database BigQuery.
Metode
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
|---|---|---|
cancelDataRefresh() | DataSourceChart | Membatalkan pemuatan ulang data yang terkait dengan objek ini jika objek sedang berjalan. |
forceRefreshData() | DataSourceChart | Memuat ulang data objek ini terlepas dari status saat ini. |
getDataSource() | DataSource | Mendapatkan sumber data yang ditautkan ke objek. |
getStatus() | DataExecutionStatus | Mendapatkan status eksekusi data objek. |
refreshData() | DataSourceChart | Memuat ulang data objek. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Menunggu hingga eksekusi saat ini selesai, waktu habis setelah jumlah detik yang diberikan. |
Dokumentasi mendetail
cancelDataRefresh()
Membatalkan pemuatan ulang data yang terkait dengan objek ini jika objek sedang berjalan.
Contoh ini menunjukkan cara membatalkan pemuatan ulang formula.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data untuk jenis sumber data
tertentu.
Pulang pergi
DataSourceChart — Objek data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
Memperbarui data objek ini terlepas dari status saat ini. Lihat refreshData() untuk
secara lebih mendetail. Jika Anda ingin membatalkan pemuatan ulang objek ini yang sedang berjalan, lihat cancelDataRefresh().
Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data untuk jenis sumber data
tertentu.
Pulang pergi
DataSourceChart — Objek data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getDataSource()
Mendapatkan sumber data yang ditautkan ke objek.
Pulang pergi
DataSource — Sumber data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getStatus()
Mendapatkan status eksekusi data objek.
Pulang pergi
DataExecutionStatus — Status eksekusi data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
refreshData()
Memuat ulang data objek.
Menampilkan pengecualian jika saat ini dalam status error. Gunakan DataSource#updateSpec() untuk mengupdate spesifikasi. Metode ini lebih disukai daripada forceRefreshData() untuk mencegah pengeditan yang tidak terduga pada sumber data.
Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data untuk jenis sumber data
tertentu.
Pulang pergi
DataSourceChart — Objek data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
Menunggu hingga eksekusi saat ini selesai, waktu habis setelah jumlah detik yang diberikan. Menampilkan pengecualian jika eksekusi tidak selesai saat waktu habis, tetapi tidak membatalkan dalam eksekusi data.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
timeoutInSeconds | Integer | Waktu tunggu eksekusi data, dalam detik. Durasi maksimumnya adalah 300 detik. |
Pulang pergi
DataExecutionStatus — Status eksekusi data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets