Mengakses dan mengubah formula sumber data yang ada. Untuk membuat formula sumber data baru, gunakan Range.setFormula(formula).
Hanya gunakan class ini dengan data yang terhubung ke database.
Metode
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
|---|---|---|
forceRefreshData() | DataSourceFormula | Memuat ulang data objek ini, terlepas dari status saat ini. |
getAnchorCell() | Range | Menampilkan Range yang merepresentasikan sel tempat formula sumber data ini ditambatkan. |
getDataSource() | DataSource | Mendapatkan sumber data yang ditautkan ke objek. |
getDisplayValue() | String | Menampilkan nilai tampilan formula sumber data. |
getFormula() | String | Menampilkan formula untuk formula sumber data ini. |
getStatus() | DataExecutionStatus | Mendapatkan status eksekusi data objek. |
refreshData() | DataSourceFormula | Memuat ulang data objek. |
setFormula(formula) | DataSourceFormula | Memperbarui formula. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Menunggu hingga eksekusi saat ini selesai, waktu akan habis setelah jumlah detik yang diberikan. |
Dokumentasi mendetail
forceRefreshData()
Memuat ulang data objek ini, terlepas dari status saat ini. Lihat refreshData() untuk
detail selengkapnya.
Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data untuk jenis sumber data tertentu.
Return
DataSourceFormula — 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
getAnchorCell()
Menampilkan Range yang merepresentasikan sel tempat formula sumber data ini ditambatkan.
Return
Range — Sel anchor.
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.
Return
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
getDisplayValue()
Menampilkan nilai tampilan formula sumber data.
Return
String — Nilai tampilan.
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
getFormula()
Menampilkan formula untuk formula sumber data ini.
Return
String — Formula.
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.
Return
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 disarankan 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.
Return
DataSourceFormula — 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
setFormula(formula)
Memperbarui formula.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
formula | String | Formula baru. |
Return
DataSourceFormula — Formula sumber data, untuk perantaian.
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 akan habis setelah jumlah detik yang diberikan. Menampilkan pengecualian jika eksekusi tidak selesai saat waktu habis, tetapi tidak membatalkan eksekusi data.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
timeoutInSeconds | Integer | Waktu untuk menunggu eksekusi data, dalam detik. Durasi maksimumnya adalah 300 detik. |
Return
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