Halaman ini diterjemahkan oleh Cloud Translation API.

Class DataSourceSheet

Mengakses dan mengubah sheet sumber data yang ada. Untuk membuat sheet sumber data baru, gunakan Spreadsheet.insertDataSourceSheet(spec).

Hanya gunakan class ini dengan data yang terhubung ke database.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`addFilter(columnName, filterCriteria)`	`DataSourceSheet`	Menambahkan filter yang diterapkan ke sheet sumber data.
`asSheet()`	`Sheet`	Menampilkan sheet sumber data sebagai objek sheet reguler.
`autoResizeColumn(columnName)`	`DataSourceSheet`	Otomatis mengubah ukuran lebar kolom yang ditentukan.
`autoResizeColumns(columnNames)`	`DataSourceSheet`	Otomatis mengubah ukuran lebar kolom yang ditentukan.
`forceRefreshData()`	`DataSourceSheet`	Memuat ulang data objek ini, terlepas dari status saat ini.
`getColumnWidth(columnName)`	`Integer`	Menampilkan lebar kolom yang ditentukan.
`getDataSource()`	`DataSource`	Mendapatkan sumber data yang ditautkan ke objek.
`getFilters()`	`DataSourceSheetFilter[]`	Menampilkan semua filter yang diterapkan ke sheet sumber data.
`getSheetValues(columnName)`	`Object[]`	Menampilkan semua nilai sheet sumber data untuk nama kolom yang disediakan.
`getSheetValues(columnName, startRow, numRows)`	`Object[]`	Menampilkan semua nilai sheet sumber data untuk nama kolom yang disediakan dari baris awal yang disediakan (berbasis-1) dan hingga `numRows` yang disediakan.
`getSortSpecs()`	`SortSpec[]`	Mendapatkan semua spesifikasi pengurutan di sheet sumber data.
`getStatus()`	`DataExecutionStatus`	Mendapatkan status eksekusi data objek.
`refreshData()`	`DataSourceSheet`	Memuat ulang data objek.
`removeFilters(columnName)`	`DataSourceSheet`	Menghapus semua filter yang diterapkan ke kolom sheet sumber data.
`removeSortSpec(columnName)`	`DataSourceSheet`	Menghapus spesifikasi pengurutan pada kolom dalam sheet sumber data.
`setColumnWidth(columnName, width)`	`DataSourceSheet`	Menetapkan lebar kolom yang ditentukan.
`setColumnWidths(columnNames, width)`	`DataSourceSheet`	Menetapkan lebar kolom yang ditentukan.
`setSortSpec(columnName, ascending)`	`DataSourceSheet`	Menetapkan spesifikasi pengurutan pada kolom dalam sheet sumber data.
`setSortSpec(columnName, sortOrder)`	`DataSourceSheet`	Menetapkan spesifikasi pengurutan pada kolom dalam sheet sumber data.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Menunggu hingga eksekusi saat ini selesai, waktu akan habis setelah jumlah detik yang diberikan.

Dokumentasi mendetail

`addFilter(columnName, filterCriteria)`

Menambahkan filter yang diterapkan ke sheet sumber data.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom tempat filter ini diterapkan.
`filterCriteria`	`FilterCriteria`	Kriteria filter yang akan diterapkan.

Return

DataSourceSheet — Sheet sumber data, untuk perantaian metode.

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

`asSheet()`

Menampilkan sheet sumber data sebagai objek sheet reguler.

Return

Sheet — Sheet reguler.

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

`autoResizeColumn(columnName)`

Otomatis mengubah ukuran lebar kolom yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom.

Return

DataSourceSheet — Sheet sumber data ini, 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

`autoResizeColumns(columnNames)`

Otomatis mengubah ukuran lebar kolom yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`columnNames`	`String[]`	Daftar nama kolom yang akan diperbarui.

Return

DataSourceSheet — Sheet sumber data ini, 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

`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

DataSourceSheet — 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

`getColumnWidth(columnName)`

Menampilkan lebar kolom yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom.

Return

Integer — Lebar kolom, atau null jika kolom menggunakan lebar default.

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

`getFilters()`

Menampilkan semua filter yang diterapkan ke sheet sumber data.

Return

DataSourceSheetFilter[] — Array dari semua filter yang diterapkan ke sheet 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

`getSheetValues(columnName)`

Menampilkan semua nilai sheet sumber data untuk nama kolom yang disediakan.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom sumber data yang nilainya akan diambil.

Return

Object[] — Array nilai satu dimensi.

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

`getSheetValues(columnName, startRow, numRows)`

Menampilkan semua nilai sheet sumber data untuk nama kolom yang disediakan dari baris awal yang disediakan (berbasis-1) dan hingga numRows yang disediakan.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom sumber data yang nilainya akan diambil.
`startRow`	`Integer`	Posisi baris untuk mulai mengambil nilai.
`numRows`	`Integer`	Jumlah baris yang akan diambil.

Return

Object[] — Array nilai satu dimensi.

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

`getSortSpecs()`

Mendapatkan semua spesifikasi pengurutan di sheet sumber data.

Return

SortSpec[] — Daftar spesifikasi pengurutan.

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

DataSourceSheet — 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

`removeFilters(columnName)`

Menghapus semua filter yang diterapkan ke kolom sheet sumber data.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom yang filternya akan dihapus.

Return

DataSourceSheet — Sheet sumber data, untuk perantaian metode.

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

`removeSortSpec(columnName)`

Menghapus spesifikasi pengurutan pada kolom dalam sheet sumber data.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom.

Return

DataSourceSheet — Sheet sumber data, untuk membuat rantai.

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

`setColumnWidth(columnName, width)`

Menetapkan lebar kolom yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom.
`width`	`Integer`	Lebar baru untuk kolom.

Return

DataSourceSheet — Sheet sumber data ini, 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

`setColumnWidths(columnNames, width)`

Menetapkan lebar kolom yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`columnNames`	`String[]`	Daftar nama kolom yang akan diperbarui.
`width`	`Integer`	Lebar baru untuk kolom.

Return

DataSourceSheet — Sheet sumber data ini, 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

`setSortSpec(columnName, ascending)`

Menetapkan spesifikasi pengurutan pada kolom dalam sheet sumber data.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom yang akan diurutkan.
`ascending`	`Boolean`	Jika `true`, urutkan kolom dalam urutan menaik; jika `false`, urutkan kolom dalam urutan menurun.

Return

DataSourceSheet — Sheet sumber data, untuk membuat rantai.

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

`setSortSpec(columnName, sortOrder)`

Menetapkan spesifikasi pengurutan pada kolom dalam sheet sumber data.

Parameter

Nama	Jenis	Deskripsi
`columnName`	`String`	Nama kolom yang akan diurutkan.
`sortOrder`	`SortOrder`	Urutan sortir.

Return

DataSourceSheet — Sheet sumber data, untuk membuat rantai.

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