Menemukan atau mengganti teks dalam rentang, sheet, atau spreadsheet. Juga dapat menentukan opsi penelusuran.
Metode
| Metode | Jenis nilai yang ditampilkan | Deskripsi singkat |
|---|---|---|
find | Range[] | Menampilkan semua sel yang cocok dengan kriteria penelusuran. |
find | Range | Menampilkan sel berikutnya yang cocok dengan kriteria penelusuran. |
find | Range | Menampilkan sel sebelumnya yang cocok dengan kriteria penelusuran. |
get | Range | Menampilkan sel saat ini yang cocok dengan kriteria penelusuran. |
ignore | Text | Jika true, mengonfigurasi penelusuran untuk mengabaikan diakritik saat mencocokkan; jika tidak, penelusuran akan mencocokkan diakritik. |
match | Text | Jika true, mengonfigurasi penelusuran agar cocok dengan huruf besar/kecil teks penelusuran secara persis, jika tidak, penelusuran akan menggunakan pencocokan yang tidak peka huruf besar/kecil secara default. |
match | Text | Jika true, mengonfigurasi penelusuran agar cocok dengan seluruh isi sel; jika tidak, penelusuran akan menggunakan pencocokan sebagian secara default. |
match | Text | Jika true, mengonfigurasi penelusuran untuk menampilkan kecocokan yang muncul dalam teks formula;
jika tidak, sel dengan formula akan dipertimbangkan berdasarkan nilai yang ditampilkan. |
replace | Integer | Mengganti semua kecocokan dengan teks yang ditentukan. |
replace | Integer | Mengganti teks penelusuran di sel yang saat ini cocok dengan teks yang ditentukan dan menampilkan jumlah kemunculan yang diganti. |
start | Text | Mengonfigurasi penelusuran untuk mulai menelusuri segera setelah rentang sel yang ditentukan. |
use | Text | Jika true, mengonfigurasi penelusuran untuk menafsirkan string penelusuran sebagai ekspresi reguler;
jika tidak, penelusuran akan menafsirkan string penelusuran sebagai teks normal. |
Dokumentasi mendetail
findAll()
Menampilkan semua sel yang cocok dengan kriteria penelusuran.
Pulang pergi
Range[] — Semua sel yang cocok.
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
findNext()
Menampilkan sel berikutnya yang cocok dengan kriteria penelusuran.
Pulang pergi
Range — Sel yang cocok berikutnya, atau null jika tidak ada kecocokan sebelumnya.
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
findPrevious()
Menampilkan sel sebelumnya yang cocok dengan kriteria penelusuran.
Pulang pergi
Range — Sel yang cocok sebelumnya, atau null jika tidak ada kecocokan sebelumnya.
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
getCurrentMatch()
Menampilkan sel saat ini yang cocok dengan kriteria penelusuran.
Pulang pergi
Range — Sel yang cocok saat ini, atau null jika tidak ada kecocokan lebih lanjut.
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
ignoreDiacritics(ignoreDiacritics)
Jika true, mengonfigurasi penelusuran untuk mengabaikan diakritik saat mencocokkan; jika tidak, penelusuran akan mencocokkan diakritik. Diakritik adalah tanda, seperti aksen atau cedilla, yang jika
ditulis di atas atau di bawah huruf menunjukkan perbedaan pengucapan dari huruf yang sama
jika tidak bertanda atau bertanda berbeda.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
ignore | Boolean | Apakah penelusuran mempertimbangkan diakritik. |
Pulang pergi
TextFinder — Pencari teks ini, untuk dirangkaikan.
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
matchCase(matchCase)
Jika true, mengonfigurasi penelusuran agar cocok dengan huruf besar/kecil teks penelusuran secara persis, jika tidak, penelusuran akan menggunakan pencocokan yang tidak peka huruf besar/kecil secara default.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
match | Boolean | Apakah pencocokan peka huruf besar/kecil. |
Pulang pergi
TextFinder — Pencari teks ini, untuk dirangkaikan.
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
matchEntireCell(matchEntireCell)
Jika true, mengonfigurasi penelusuran agar cocok dengan seluruh isi sel; jika tidak, penelusuran akan menggunakan pencocokan sebagian secara default.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
match | Boolean | Apakah seluruh sel cocok. |
Pulang pergi
TextFinder — Pencari teks ini, untuk dirangkaikan.
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
matchFormulaText(matchFormulaText)
Jika true, konfigurasi penelusuran untuk menampilkan kecocokan yang muncul dalam teks formula;
jika tidak, sel dengan formula akan dipertimbangkan berdasarkan nilai yang ditampilkan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
match | Boolean | Apakah penelusuran memeriksa teks formula. |
Pulang pergi
TextFinder — Pencari teks ini, untuk dirangkaikan.
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
replaceAllWith(replaceText)
Mengganti semua kecocokan dengan teks yang ditentukan. Menampilkan jumlah kemunculan yang diganti, yang mungkin berbeda dengan jumlah sel yang cocok.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
replace | String | Teks yang menggantikan teks dalam sel yang cocok. |
Pulang pergi
Integer — Jumlah kemunculan yang diganti.
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
replaceWith(replaceText)
Mengganti teks penelusuran di sel yang saat ini cocok dengan teks yang ditentukan dan menampilkan jumlah kemunculan yang diganti.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
replace | String | Teks yang menggantikan konten dalam sel yang saat ini cocok. |
Pulang pergi
Integer — Jumlah kemunculan yang diganti.
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
startFrom(startRange)
Mengonfigurasi penelusuran untuk mulai menelusuri segera setelah rentang sel yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
start | Range | Rentang sel setelah penelusuran harus dimulai. |
Pulang pergi
TextFinder — Pencari teks ini, untuk dirangkaikan.
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
useRegularExpression(useRegEx)
Jika true, mengonfigurasi penelusuran untuk menafsirkan string penelusuran sebagai ekspresi reguler;
jika tidak, penelusuran akan menafsirkan string penelusuran sebagai teks normal. Untuk mengetahui detail selengkapnya tentang cara menggunakan ekspresi reguler, lihat
halaman dukungan Cari dan ganti.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
use | Boolean | Apakah akan menafsirkan string penelusuran sebagai ekspresi reguler. |
Pulang pergi
TextFinder — Pencari teks ini, untuk dirangkaikan.
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