Halaman ini diterjemahkan oleh Cloud Translation API.

Class DataSourceChart

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 pembaruan data yang terkait dengan objek ini jika saat ini sedang berjalan.
`forceRefreshData()`	`DataSourceChart`	Memperbarui 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`	Memperbarui data objek.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Menunggu hingga eksekusi saat ini selesai, waktu tunggu habis setelah jumlah detik yang diberikan.

Dokumentasi mendetail

`cancelDataRefresh()`

Membatalkan pembaruan data yang terkait dengan objek ini jika saat ini sedang berjalan.

Contoh ini menunjukkan cara membatalkan pembaruan 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 mengetahui detail selengkapnya. Jika Anda ingin membatalkan pembaruan 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()`

Memperbarui data objek.

Menampilkan pengecualian jika saat ini dalam status error. Gunakan DataSource#updateSpec() untuk memperbarui 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 tunggu habis setelah jumlah detik yang diberikan. Menampilkan pengecualian jika eksekusi tidak selesai saat waktu tunggu habis, tetapi tidak membatalkan 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