Tìm hoặc thay thế văn bản trong một dải ô, trang tính hoặc bảng tính. Cũng có thể chỉ định các tuỳ chọn tìm kiếm.
Phương thức
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
find | Range[] | Trả về tất cả các ô khớp với tiêu chí tìm kiếm. |
find | Range | Trả về ô tiếp theo khớp với tiêu chí tìm kiếm. |
find | Range | Trả về ô trước đó khớp với tiêu chí tìm kiếm. |
get | Range | Trả về ô hiện tại khớp với tiêu chí tìm kiếm. |
ignore | Text | Nếu true, hãy định cấu hình tính năng tìm kiếm để bỏ qua dấu phụ trong khi so khớp; nếu không, tính năng tìm kiếm sẽ so khớp dấu phụ. |
match | Text | Nếu true, hãy định cấu hình tính năng tìm kiếm để khớp chính xác với chữ hoa chữ thường của văn bản tìm kiếm, nếu không, tính năng tìm kiếm sẽ mặc định khớp không phân biệt chữ hoa chữ thường. |
match | Text | Nếu true, hãy định cấu hình tìm kiếm để khớp toàn bộ nội dung của một ô; nếu không, tìm kiếm sẽ mặc định là khớp một phần. |
match | Text | Nếu true, hãy định cấu hình tìm kiếm để trả về các kết quả trùng khớp xuất hiện trong văn bản công thức; nếu không, các ô có công thức sẽ được xem xét dựa trên giá trị hiển thị của chúng. |
replace | Integer | Thay thế tất cả kết quả trùng khớp bằng văn bản đã chỉ định. |
replace | Integer | Thay thế văn bản tìm kiếm trong ô hiện được so khớp bằng văn bản đã chỉ định và trả về số lần xuất hiện được thay thế. |
start | Text | Định cấu hình tìm kiếm để bắt đầu tìm kiếm ngay sau dải ô được chỉ định. |
use | Text | Nếu true, hãy định cấu hình tính năng tìm kiếm để diễn giải chuỗi tìm kiếm dưới dạng biểu thức chính quy; nếu không, tính năng tìm kiếm sẽ diễn giải chuỗi tìm kiếm dưới dạng văn bản thông thường. |
Tài liệu chi tiết
find
Trả về tất cả các ô khớp với tiêu chí tìm kiếm.
Cầu thủ trả bóng
Range[] – Tất cả các ô trùng khớp.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
find
Trả về ô tiếp theo khớp với tiêu chí tìm kiếm.
Cầu thủ trả bóng
Range – Ô khớp tiếp theo hoặc null nếu không có ô khớp nào trước đó.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
find
Trả về ô trước đó khớp với tiêu chí tìm kiếm.
Cầu thủ trả bóng
Range – Ô khớp trước đó hoặc null nếu không có ô khớp trước đó.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get
Trả về ô hiện tại khớp với tiêu chí tìm kiếm.
Cầu thủ trả bóng
Range – Ô trùng khớp hiện tại hoặc null nếu không có ô nào trùng khớp khác.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
" id="ignorediacriticsignorediacritics" tabindex="-1">
ignore
Nếu true, hãy định cấu hình tính năng tìm kiếm để bỏ qua dấu phụ trong khi so khớp; nếu không, tính năng tìm kiếm sẽ so khớp dấu phụ. Dấu phụ là một dấu, chẳng hạn như dấu trọng âm hoặc dấu cedilla, khi được viết phía trên hoặc phía dưới một chữ cái, cho biết sự khác biệt về cách phát âm của cùng một chữ cái khi không được đánh dấu hoặc được đánh dấu theo cách khác.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
ignore | Boolean | Liệu tính năng tìm kiếm có xem xét các dấu phụ hay không. |
Cầu thủ trả bóng
Text – Trình tìm kiếm văn bản này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
match
Nếu true, hãy định cấu hình tính năng tìm kiếm để khớp chính xác với chữ hoa chữ thường của văn bản tìm kiếm, nếu không, tính năng tìm kiếm sẽ mặc định khớp không phân biệt chữ hoa chữ thường.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
match | Boolean | Liệu kết quả so khớp có phân biệt chữ hoa chữ thường hay không. |
Cầu thủ trả bóng
Text – Trình tìm kiếm văn bản này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
match
Nếu true, hãy định cấu hình tìm kiếm để khớp toàn bộ nội dung của một ô; nếu không, tìm kiếm sẽ mặc định là khớp một phần.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
match | Boolean | Liệu toàn bộ ô có được so khớp hay không. |
Cầu thủ trả bóng
Text – Trình tìm kiếm văn bản này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
match
Nếu true, hãy định cấu hình tìm kiếm để trả về các kết quả trùng khớp xuất hiện trong văn bản công thức; nếu không, các ô có công thức sẽ được xem xét dựa trên giá trị hiển thị của chúng.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
match | Boolean | Liệu tính năng tìm kiếm có kiểm tra văn bản công thức hay không. |
Cầu thủ trả bóng
Text – Trình tìm kiếm văn bản này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replace
Thay thế tất cả kết quả trùng khớp bằng văn bản đã chỉ định. Trả về số lần xuất hiện được thay thế, số này có thể khác với số ô khớp.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
replace | String | Văn bản thay thế văn bản trong các ô khớp. |
Cầu thủ trả bóng
Integer – Số lần xuất hiện được thay thế.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replace
Thay thế văn bản tìm kiếm trong ô hiện được so khớp bằng văn bản đã chỉ định và trả về số lần xuất hiện được thay thế.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
replace | String | Văn bản thay thế nội dung trong ô hiện đang được so khớp. |
Cầu thủ trả bóng
Integer – Số lần xuất hiện được thay thế.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
start
Định cấu hình tìm kiếm để bắt đầu tìm kiếm ngay sau dải ô được chỉ định.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
start | Range | Phạm vi ô mà sau đó quá trình tìm kiếm sẽ bắt đầu. |
Cầu thủ trả bóng
Text – Trình tìm kiếm văn bản này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
use
Nếu true, hãy định cấu hình tính năng tìm kiếm để diễn giải chuỗi tìm kiếm dưới dạng biểu thức chính quy; nếu không, tính năng tìm kiếm sẽ diễn giải chuỗi tìm kiếm dưới dạng văn bản thông thường. Để biết thêm thông tin chi tiết về cách sử dụng biểu thức chính quy, hãy tham khảo
trang hỗ trợ về tính năng Tìm và thay thế.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
use | Boolean | Liệu có diễn giải chuỗi tìm kiếm dưới dạng biểu thức chính quy hay không. |
Cầu thủ trả bóng
Text – Trình tìm kiếm văn bản này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets