Truy cập và sửa đổi tệp Google Trang tính. Các thao tác thường dùng là thêm trang tính mới và thêm người cộng tác.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
add | Spreadsheet | Thêm siêu dữ liệu nhà phát triển bằng khoá đã chỉ định vào bảng tính cấp cao nhất. |
add | Spreadsheet | Thêm siêu dữ liệu nhà phát triển có khoá và chế độ hiển thị được chỉ định vào bảng tính. |
add | Spreadsheet | Thêm siêu dữ liệu nhà phát triển có khoá và giá trị đã chỉ định vào bảng tính. |
add | Spreadsheet | Thêm siêu dữ liệu nhà phát triển có khoá, giá trị và chế độ hiển thị được chỉ định vào bảng tính. |
add | Spreadsheet | Thêm người dùng đã cho vào danh sách người chỉnh sửa cho Spreadsheet . |
add | Spreadsheet | Thêm người dùng đã cho vào danh sách người chỉnh sửa cho Spreadsheet . |
add | Spreadsheet | Thêm mảng người dùng đã cho vào danh sách người chỉnh sửa cho Spreadsheet . |
add | void | Tạo một trình đơn mới trong giao diện người dùng của Bảng tính. |
add | Spreadsheet | Thêm người dùng đã cho vào danh sách người xem của Spreadsheet . |
add | Spreadsheet | Thêm người dùng đã cho vào danh sách người xem của Spreadsheet . |
add | Spreadsheet | Thêm mảng người dùng đã cho vào danh sách người xem cho Spreadsheet . |
append | Sheet | Thêm một hàng vào cuối vùng dữ liệu hiện tại trong trang tính. |
auto | Sheet | Đặt chiều rộng của cột đã cho cho phù hợp với nội dung của cột đó. |
copy(name) | Spreadsheet | Sao chép bảng tính và trả về bảng tính mới. |
create | Developer | Trả về Developer để tìm siêu dữ liệu nhà phát triển trong phạm vi của bảng tính này. |
create | Text | Tạo trình tìm kiếm văn bản cho bảng tính. Bạn có thể dùng trình tìm kiếm này để tìm và thay thế văn bản trong bảng tính. |
delete | Sheet | Xoá trang tính đang hoạt động. |
delete | Sheet | Xoá cột ở vị trí cột đã cho. |
delete | void | Xoá một số cột bắt đầu từ vị trí cột đã cho. |
delete | Sheet | Xoá hàng ở vị trí hàng đã cho. |
delete | void | Xoá một số hàng bắt đầu từ vị trí hàng đã cho. |
delete | void | Xoá trang tính đã chỉ định. |
duplicate | Sheet | Sao chép trang tính đang hoạt động và đặt trang tính đó làm trang tính đang hoạt động. |
get | Range | Trả về ô đang hoạt động trong trang tính này. |
get | Range | Trả về dải ô đã chọn trong trang tính đang hoạt động hoặc null nếu không có dải ô nào đang hoạt động. |
get | Range | Trả về danh sách các dải ô đang hoạt động trong trang tính đang hoạt động hoặc null nếu không có dải ô nào đang hoạt động. |
get | Sheet | Lấy trang tính đang hoạt động trong bảng tính. |
get | Blob | Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi thành loại nội dung đã chỉ định. |
get | Banding[] | Trả về tất cả các dải trong bảng tính này. |
get | Blob | Trả về dữ liệu bên trong đối tượng này dưới dạng blob. |
get | Integer | Lấy chiều rộng tính bằng pixel của cột đã cho. |
get | Range | Trả về ô hiện tại trong trang tính đang hoạt động hoặc null nếu không có ô hiện tại. |
get | Range | Trả về một Range tương ứng với các phương diện có dữ liệu. |
get | Data | Lấy tất cả công thức nguồn dữ liệu. |
get | Data | Lấy tất cả bảng tổng hợp nguồn dữ liệu. |
get | Data | Lấy lịch làm mới của bảng tính này. |
get | Data | Trả về tất cả các trang tính nguồn dữ liệu trong bảng tính. |
get | Data | Lấy tất cả bảng nguồn dữ liệu. |
get | Data | Trả về tất cả nguồn dữ liệu trong bảng tính. |
get | Developer | Lấy siêu dữ liệu nhà phát triển được liên kết với bảng tính cấp cao nhất. |
get | User[] | Lấy danh sách trình chỉnh sửa cho Spreadsheet này. |
get | String | Trả về URL của biểu mẫu gửi phản hồi đến bảng tính này hoặc null nếu bảng tính này không có biểu mẫu liên kết. |
get | Integer | Trả về số lượng cột được cố định. |
get | Integer | Trả về số lượng hàng được cố định. |
get | String | Lấy giá trị nhận dạng duy nhất cho bảng tính này. |
get | Over | Trả về tất cả hình ảnh nằm ngoài lưới trên trang tính. |
get | Number | Trả về giá trị ngưỡng được sử dụng trong quá trình tính toán lặp lại. |
get | Integer | Trả về vị trí của cột cuối cùng có nội dung. |
get | Integer | Trả về vị trí của hàng cuối cùng có nội dung. |
get | Integer | Trả về số lần lặp tối đa để sử dụng trong quá trình tính toán lặp. |
get | String | Lấy tên của tài liệu. |
get | Named | Lấy tất cả các dải ô có tên trong bảng tính này. |
get | Integer | Trả về số lượng trang tính trong bảng tính này. |
get | User | Trả về chủ sở hữu của tài liệu hoặc null đối với tài liệu trong bộ nhớ dùng chung. |
get | Spreadsheet | Trả về danh sách các giao diện được xác định trước. |
get | Protection[] | Lấy một mảng đối tượng đại diện cho tất cả các dải ô hoặc trang tính được bảo vệ trong bảng tính. |
get | Range | Trả về dải ô được chỉ định theo ký hiệu A1 hoặc ký hiệu R1C1. |
get | Range | Trả về một dải ô được đặt tên hoặc null nếu không tìm thấy dải ô có tên đã cho. |
get | Range | Trả về tập hợp Range đại diện cho các dải ô trong cùng một trang tính được chỉ định bằng danh sách không trống gồm các ký hiệu A1 hoặc R1C1. |
get | Recalculation | Trả về khoảng thời gian tính toán cho bảng tính này. |
get | Integer | Lấy chiều cao tính bằng pixel của hàng đã cho. |
get | Selection | Trả về Selection hiện tại trong bảng tính. |
get | Sheet | Trả về một trang tính có tên đã cho. |
get | Integer | Trả về mã nhận dạng của trang tính do đối tượng này biểu thị. |
get | String | Trả về tên trang tính. |
get | Object[][] | Trả về lưới hình chữ nhật gồm các giá trị cho dải ô này, bắt đầu từ toạ độ đã cho. |
get | Sheet[] | Lấy tất cả các trang tính trong bảng tính này. |
get | String | Lấy ngôn ngữ của bảng tính. |
get | Spreadsheet | Trả về giao diện hiện tại của bảng tính hoặc null nếu không áp dụng giao diện nào. |
get | String | Lấy múi giờ cho bảng tính. |
get | String | Trả về URL cho bảng tính đã cho. |
get | User[] | Lấy danh sách người xem và người nhận xét cho Spreadsheet này. |
hide | void | Ẩn cột hoặc các cột trong dải ô đã cho. |
hide | void | Ẩn các hàng trong dải ô đã cho. |
insert | Sheet | Chèn một cột sau vị trí cột đã cho. |
insert | Sheet | Chèn một cột trước vị trí cột đã cho. |
insert | Sheet | Chèn một số lượng cột nhất định sau vị trí cột đã cho. |
insert | Sheet | Chèn một số cột trước vị trí cột đã cho. |
insert | Data | Chèn một Data mới vào bảng tính và bắt đầu thực thi dữ liệu. |
insert | Over | Chèn Spreadsheet dưới dạng hình ảnh trong tài liệu ở một hàng và cột nhất định. |
insert | Over | Chèn Spreadsheet dưới dạng hình ảnh trong tài liệu ở một hàng và cột nhất định, với độ dời pixel. |
insert | Over | Chèn hình ảnh vào tài liệu ở một hàng và cột nhất định. |
insert | Over | Chèn hình ảnh vào tài liệu ở một hàng và cột nhất định, với độ dời pixel. |
insert | Sheet | Chèn một hàng sau vị trí hàng đã cho. |
insert | Sheet | Chèn một hàng trước vị trí hàng đã cho. |
insert | Sheet | Chèn một số hàng sau vị trí hàng đã cho. |
insert | Sheet | Chèn một số hàng trước vị trí hàng đã cho. |
insert | Sheet | Chèn một trang tính mới vào bảng tính, sử dụng tên trang tính mặc định. |
insert | Sheet | Chèn một trang tính mới vào bảng tính tại chỉ mục đã cho. |
insert | Sheet | Chèn một trang tính mới vào bảng tính tại chỉ mục đã cho và sử dụng các đối số nâng cao không bắt buộc. |
insert | Sheet | Chèn một trang tính mới vào bảng tính, sử dụng tên trang tính mặc định và các đối số nâng cao không bắt buộc. |
insert | Sheet | Chèn một trang tính mới vào bảng tính có tên đã cho. |
insert | Sheet | Chèn một trang tính mới vào bảng tính có tên đã cho tại chỉ mục đã cho. |
insert | Sheet | Chèn một trang tính mới vào bảng tính có tên đã cho tại chỉ mục đã cho và sử dụng các đối số nâng cao không bắt buộc. |
insert | Sheet | Chèn một trang tính mới vào bảng tính có tên đã cho và sử dụng các đối số nâng cao không bắt buộc. |
insert | Sheet | Chèn một trang tính mới vào bảng tính, tạo một Data trải dài trên toàn bộ trang tính với thông số kỹ thuật nguồn dữ liệu đã cho và bắt đầu thực thi dữ liệu. |
is | Boolean | Trả về kết quả cho biết người dùng có ẩn cột đã cho hay không. |
is | Boolean | Trả về kết quả cho biết tính năng tính toán lặp có được kích hoạt trong bảng tính này hay không. |
is | Boolean | Trả về giá trị cho biết liệu một bộ lọc (không phải chế độ xem bộ lọc) có ẩn hàng đã cho hay không. |
is | Boolean | Trả về kết quả cho biết người dùng có ẩn hàng đã cho hay không. |
move | void | Di chuyển trang tính đang hoạt động đến vị trí đã cho trong danh sách trang tính. |
move | Sheet | Tạo một trang tính Sheet mới và di chuyển biểu đồ được cung cấp vào trang tính đó. |
refresh | void | Làm mới tất cả nguồn dữ liệu được hỗ trợ và các đối tượng nguồn dữ liệu được liên kết của chúng, bỏ qua các đối tượng nguồn dữ liệu không hợp lệ. |
remove | Spreadsheet | Xoá người dùng đã cho khỏi danh sách trình chỉnh sửa cho Spreadsheet . |
remove | Spreadsheet | Xoá người dùng đã cho khỏi danh sách trình chỉnh sửa cho Spreadsheet . |
remove | void | Xoá một trình đơn do add thêm. |
remove | void | Xoá một dải ô được đặt tên có tên đã cho. |
remove | Spreadsheet | Xoá người dùng đã cho khỏi danh sách người xem và người bình luận cho Spreadsheet . |
remove | Spreadsheet | Xoá người dùng đã cho khỏi danh sách người xem và người bình luận cho Spreadsheet . |
rename(newName) | void | Đổi tên tài liệu. |
rename | void | Đổi tên trang tính đang hoạt động hiện tại thành tên mới đã cho. |
reset | Spreadsheet | Xoá giao diện đã áp dụng và đặt giao diện mặc định trên bảng tính. |
set | Range | Đặt dải ô được chỉ định làm active range trong trang tính đang hoạt động, với ô trên cùng bên trái trong dải ô là current cell . |
set | Range | Đặt danh sách dải ô đã chỉ định làm active ranges trong trang tính đang hoạt động. |
set | Range | Đặt vùng lựa chọn đang hoạt động cho trang tính này. |
set | Range | Đặt lựa chọn đang hoạt động, như được chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1. |
set | Sheet | Đặt trang tính đã cho làm trang tính đang hoạt động trong bảng tính. |
set | Sheet | Đặt trang tính đã cho làm trang tính đang hoạt động trong bảng tính, với tuỳ chọn khôi phục lựa chọn gần đây nhất trong trang tính đó. |
set | Sheet | Đặt chiều rộng của cột đã cho tính bằng pixel. |
set | Range | Đặt ô được chỉ định làm current cell . |
set | void | Cố định số cột đã cho. |
set | void | Khoá số hàng đã cho. |
set | Spreadsheet | Đặt giá trị ngưỡng tối thiểu cho phép tính toán lặp lại. |
set | Spreadsheet | Đặt xem tính năng tính toán lặp có được kích hoạt trong bảng tính này hay không. |
set | Spreadsheet | Đặt số lần lặp lại phép tính tối đa cần thực hiện trong quá trình tính toán lặp lại. |
set | void | Đặt tên cho một dải ô. |
set | Spreadsheet | Đặt tần suất bảng tính này tính toán lại. |
set | Sheet | Đặt chiều cao của hàng cho hàng đã cho theo pixel. |
set | void | Đặt ngôn ngữ của bảng tính. |
set | Spreadsheet | Đặt giao diện trên bảng tính. |
set | void | Đặt múi giờ cho bảng tính. |
show(userInterface) | void | Hiển thị một thành phần giao diện người dùng tuỳ chỉnh trong hộp thoại nằm ở giữa khung nhìn của trình duyệt của người dùng. |
sort(columnPosition) | Sheet | Sắp xếp trang tính theo cột, tăng dần. |
sort(columnPosition, ascending) | Sheet | Sắp xếp trang tính theo cột. |
toast(msg) | void | Hiển thị một cửa sổ bật lên ở góc dưới bên phải của bảng tính kèm theo thông báo đã cho. |
toast(msg, title) | void | Hiển thị một cửa sổ bật lên ở góc dưới bên phải của bảng tính với thông báo và tiêu đề đã cho. |
toast(msg, title, timeoutSeconds) | void | Hiển thị một cửa sổ bật lên ở góc dưới bên phải của bảng tính với tiêu đề và thông báo nhất định, cửa sổ này sẽ hiển thị trong một khoảng thời gian nhất định. |
unhide | void | Bỏ ẩn cột trong dải ô đã cho. |
unhide | void | Bỏ ẩn hàng trong dải ô đã cho. |
update | void | Cập nhật trình đơn do add thêm. |
wait | void | Chờ cho đến khi tất cả các lần thực thi hiện tại trong bảng tính hoàn tất, hết thời gian chờ sau số giây đã cung cấp. |
Tài liệu chi tiết
add Developer Metadata(key)
Thêm siêu dữ liệu nhà phát triển bằng khoá đã chỉ định vào bảng tính cấp cao nhất.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' in the developer metadata for the spreadsheet. ss.addDeveloperMetadata('NAME') // Gets the first developer metadata object and logs its key. const developerMetaData = ss.getDeveloperMetadata()[0] console.log(developerMetaData.getKey())
Tham số
Tên | Loại | Mô tả |
---|---|---|
key | String | Khoá cho siêu dữ liệu nhà phát triển mới. |
Cầu thủ trả bóng
Spreadsheet
– Bảng tính 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
add Developer Metadata(key, visibility)
Thêm siêu dữ liệu nhà phát triển có khoá và chế độ hiển thị được chỉ định vào bảng tính.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility // to the developer project that created the metadata. ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the first developer metadata object and logs its key and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, . Visibility: ${developerMetaData.getVisibility()}`);
Tham số
Tên | Loại | Mô tả |
---|---|---|
key | String | Khoá cho siêu dữ liệu nhà phát triển mới. |
visibility | Developer | Chế độ hiển thị của siêu dữ liệu mới của nhà phát triển. |
Cầu thủ trả bóng
Spreadsheet
– Bảng tính 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
add Developer Metadata(key, value)
Thêm siêu dữ liệu nhà phát triển có khoá và giá trị đã chỉ định vào bảng tính.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the // spreadsheet. ss.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the first developer metadata object and logs its key and value. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}`);
Tham số
Tên | Loại | Mô tả |
---|---|---|
key | String | Khoá cho siêu dữ liệu nhà phát triển mới. |
value | String | Giá trị cho siêu dữ liệu nhà phát triển mới. |
Cầu thủ trả bóng
Spreadsheet
– Bảng tính 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
add Developer Metadata(key, value, visibility)
Thêm siêu dữ liệu nhà phát triển có khoá, giá trị và chế độ hiển thị được chỉ định vào bảng tính.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to any developer project with document access. ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the first developer metadata object and logs its key, value, and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}, Visibility: ${developerMetaData.getVisibility()}`);
Tham số
Tên | Loại | Mô tả |
---|---|---|
key | String | Khoá cho siêu dữ liệu nhà phát triển mới. |
value | String | Giá trị cho siêu dữ liệu nhà phát triển mới. |
visibility | Developer | Chế độ hiển thị của siêu dữ liệu mới của nhà phát triển. |
Cầu thủ trả bóng
Spreadsheet
– Bảng tính 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
add Editor(emailAddress)
Thêm người dùng đã cho vào danh sách người chỉnh sửa cho Spreadsheet
. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ loại người dùng đó khỏi danh sách người xem.
Tham số
Tên | Loại | Mô tả |
---|---|---|
email | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
Spreadsheet
— Spreadsheet
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
add Editor(user)
Thêm người dùng đã cho vào danh sách người chỉnh sửa cho Spreadsheet
. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ loại người dùng đó khỏi danh sách người xem.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Nội dung đại diện cho người dùng cần thêm. |
Cầu thủ trả bóng
Spreadsheet
— Spreadsheet
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
add Editors(emailAddresses)
Thêm mảng người dùng đã cho vào danh sách người chỉnh sửa cho Spreadsheet
. Nếu có người dùng nào đã có trong danh sách người xem, thì phương thức này sẽ loại họ khỏi danh sách người xem.
Tham số
Tên | Loại | Mô tả |
---|---|---|
email | String[] | Một mảng gồm các địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
Spreadsheet
— Spreadsheet
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
add Menu(name, subMenus)
Tạo một trình đơn mới trong giao diện người dùng của Bảng tính.
Mỗi mục trong trình đơn sẽ chạy một hàm do người dùng xác định. Thông thường, bạn nên gọi hàm này từ hàm on
để trình đơn được tạo tự động khi tải bảng tính.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is // executed. menuEntries.push({name: "Menu Entry 1", functionName: "function1"}); menuEntries.push(null); // line separator menuEntries.push({name: "Menu Entry 2", functionName: "function2"}); ss.addMenu("addMenuExample", menuEntries); }
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên của trình đơn cần tạo. |
sub | Object[] | Một mảng bản đồ JavaScript có các tham số name và function . Bạn có thể sử dụng các hàm từ các thư viện đi kèm, chẳng hạn như
Library.libFunction1 . |
Ủ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
add Viewer(emailAddress)
Thêm người dùng đã cho vào danh sách người xem của Spreadsheet
. Nếu người dùng đã có trong danh sách người chỉnh sửa, thì phương thức này sẽ không có hiệu lực.
Tham số
Tên | Loại | Mô tả |
---|---|---|
email | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
Spreadsheet
— Spreadsheet
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
add Viewer(user)
Thêm người dùng đã cho vào danh sách người xem của Spreadsheet
. Nếu người dùng đã có trong danh sách người chỉnh sửa, thì phương thức này sẽ không có hiệu lực.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Nội dung đại diện cho người dùng cần thêm. |
Cầu thủ trả bóng
Spreadsheet
— Spreadsheet
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
add Viewers(emailAddresses)
Thêm mảng người dùng đã cho vào danh sách người xem cho Spreadsheet
. Nếu bất kỳ người dùng nào đã có trong danh sách người chỉnh sửa, thì phương thức này sẽ không ảnh hưởng đến họ.
Tham số
Tên | Loại | Mô tả |
---|---|---|
email | String[] | Một mảng gồm các địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
Spreadsheet
— Spreadsheet
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
append Row(rowContents)
Thêm một hàng vào cuối vùng dữ liệu hiện tại trong trang tính. Nếu nội dung của một ô bắt đầu bằng =
, thì nội dung đó sẽ được diễn giải là một công thức.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Appends a new row with 3 columns to the bottom of the current // data region in the sheet containing the values in the array. sheet.appendRow(["a man", "a plan", "panama"]);
Tham số
Tên | Loại | Mô tả |
---|---|---|
row | Object[] | Một mảng giá trị để chèn sau hàng cuối cùng trong trang tính. |
Cầu thủ trả bóng
Sheet
– Trang tính, hữu ích cho việc tạo chuỗi phương thứ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
auto Resize Column(columnPosition)
Đặt chiều rộng của cột đã cho cho phù hợp với nội dung của cột đó.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
column | Integer | Vị trí của cột đã cho để đổi kích thước. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
copy(name)
Sao chép bảng tính và trả về bảng tính mới.
// This code makes a copy of the current spreadsheet and names it appropriately var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.copy("Copy of " + ss.getName());
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên của bản sao. |
Cầu thủ trả bóng
Spreadsheet
– Bảng tính 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
create Developer Metadata Finder()
Trả về Developer
để tìm siêu dữ liệu nhà phát triển trong phạm vi của bảng tính này. Theo mặc định, hàm này xem xét tất cả siêu dữ liệu liên kết với bảng tính, trang tính, hàng và cột.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds developer metadata to the spreadsheet. ss.addDeveloperMetadata('NAME', 'CHARLIE'); ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION'); ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT'); // Creates a developer metadata finder. const developerMetadataFinder = ss.createDeveloperMetadataFinder(); // Finds the developer metadata objects with 'COMPANY' as the key. const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find(); // Gets the first result of developer metadata that has the key 'COMPANY' and logs its value. console.log(googleMetadataFromSpreadsheet[0].getValue());
Cầu thủ trả bóng
Developer
– Trình tìm siêu dữ liệu nhà phát triển để tìm siêu dữ liệu trong phạm vi của bảng tính này.
create Text Finder(findText)
Tạo trình tìm kiếm văn bản cho bảng tính. Bạn có thể dùng trình tìm kiếm này để tìm và thay thế văn bản trong bảng tính. Quá trình tìm kiếm bắt đầu từ trang tính đầu tiên của bảng tính.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Creates a text finder. var textFinder = spreadsheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the spreadsheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Tham số
Tên | Loại | Mô tả |
---|---|---|
find | String | Văn bản cần tìm kiếm. |
Cầu thủ trả bóng
Text
– Text
cho bảng tính.
delete Active Sheet()
Xoá trang tính đang hoạt động.
// The code below deletes the currently active sheet and stores the new active sheet in a // variable var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();
Cầu thủ trả bóng
Sheet
– Trang tính mới đang hoạt động.
Ủ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
delete Column(columnPosition)
Xoá cột ở vị trí cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
column | Integer | Vị trí của cột, bắt đầu từ 1 cho cột đầu tiên. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
delete Columns(columnPosition, howMany)
Xoá một số cột bắt đầu từ vị trí cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Tham số
Tên | Loại | Mô tả |
---|---|---|
column | Integer | Vị trí của cột đầu tiên cần xoá. |
how | Integer | Số lượng cột cần xoá. |
Ủ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
delete Row(rowPosition)
Xoá hàng ở vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
row | Integer | Vị trí của hàng, bắt đầu từ 1 cho hàng đầu tiên. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
delete Rows(rowPosition, howMany)
Xoá một số hàng bắt đầu từ vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Tham số
Tên | Loại | Mô tả |
---|---|---|
row | Integer | Vị trí của hàng đầu tiên cần xoá. |
how | Integer | Số hàng cần xoá. |
Ủ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
delete Sheet(sheet)
Xoá trang tính đã chỉ định.
// The code below deletes the specified sheet. var ss = SpreadsheetApp.getActive(); var sheet = ss.getSheetByName('My Sheet'); ss.deleteSheet(sheet);
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | Sheet | Trang tính cần xoá. |
Ủ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
duplicate Active Sheet()
Sao chép trang tính đang hoạt động và đặt trang tính đó làm trang tính đang hoạt động.
// The code below makes a duplicate of the active sheet SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();
Cầu thủ trả bóng
Sheet
– Trang tính mớ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
get Active Cell()
Trả về ô đang hoạt động trong trang tính này.
Lưu ý: Bạn nên sử dụng get
để trả về ô được làm nổi bật hiện tại.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Cầu thủ trả bóng
Range
– ô đang hoạt động hiện tạ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
get Active Range()
Trả về dải ô đã chọn trong trang tính đang hoạt động hoặc null
nếu không có dải ô nào đang hoạt động. Nếu bạn chọn nhiều dải ô, phương thức này sẽ chỉ trả về dải ô được chọn gần đây nhất.
Thuật ngữ "dải ô đang hoạt động" đề cập đến dải ô mà người dùng đã chọn trong trang tính đang hoạt động, nhưng trong hàm tuỳ chỉnh, thuật ngữ này đề cập đến ô đang được tính toán lại.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Cầu thủ trả bóng
Range
– dải ô đang hoạt động
Ủ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
Xem thêm
get Active Range List()
Trả về danh sách các dải ô đang hoạt động trong trang tính đang hoạt động hoặc null
nếu không có dải ô nào đang hoạt động.
Nếu bạn chỉ chọn một dải ô, thì thao tác này sẽ hoạt động như một lệnh gọi get
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Cầu thủ trả bóng
Range
– danh sách các dải ô đang hoạt động
Ủ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
Xem thêm
get Active Sheet()
Lấy trang tính đang hoạt động trong bảng tính.
Trang tính đang hoạt động trong bảng tính là trang tính đang hiển thị trong giao diện người dùng của bảng tính.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
Cầu thủ trả bóng
Sheet
– Trang tính đang hoạt động trong bảng tính.
get As(contentType)
Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi thành loại nội dung đã chỉ định. Phương thức này thêm đuôi tệp thích hợp vào tên tệp, ví dụ: "myfile.pdf". Tuy nhiên, hàm này giả định rằng phần tên tệp theo sau dấu chấm cuối cùng (nếu có) là một đuôi tệp hiện có cần được thay thế. Do đó, "ShoppingList.12.25.2014" sẽ trở thành "ShoppingList.12.25.pdf".
Để xem hạn mức hằng ngày cho lượt chuyển đổi, hãy xem bài viết Hạn mức cho Dịch vụ của Google. Các miền Google Workspace mới tạo có thể tạm thời phải tuân theo hạn mức nghiêm ngặt hơn.
Tham số
Tên | Loại | Mô tả |
---|---|---|
content | String | Loại MIME cần chuyển đổi sang. Đối với hầu hết các blob, 'application/pdf' là tuỳ chọn hợp lệ duy nhất. Đối với hình ảnh ở định dạng BMP, GIF, JPEG hoặc PNG, bất kỳ 'image/bmp' , 'image/gif' , 'image/jpeg' hoặc 'image/png' nào cũng đều hợp lệ. Đối với tài liệu Google Tài liệu, 'text/markdown' cũng hợp lệ. |
Cầu thủ trả bóng
Blob
– Dữ liệu dưới dạng blob.
get Bandings()
Trả về tất cả các dải trong bảng tính này.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets an array of the bandings in the spreadsheet. const bandings = ss.getBandings(); // Logs the range of the first banding in the spreadsheet to the console. console.log(bandings[0].getRange().getA1Notation());
Cầu thủ trả bóng
Banding[]
– Các dải trong bảng tính này.
Ủ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 Blob()
Trả về dữ liệu bên trong đối tượng này dưới dạng blob.
Cầu thủ trả bóng
Blob
– Dữ liệu dưới dạng blob.
get Column Width(columnPosition)
Lấy chiều rộng tính bằng pixel của cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Tham số
Tên | Loại | Mô tả |
---|---|---|
column | Integer | Vị trí của cột cần kiểm tra. |
Cầu thủ trả bóng
Integer
– chiều rộng cột tính bằng pixel
Ủ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 Current Cell()
Trả về ô hiện tại trong trang tính đang hoạt động hoặc null
nếu không có ô hiện tại. Ô hiện tại là ô có tiêu điểm trong giao diện người dùng Google Trang tính và được làm nổi bật bằng đường viền màu tối. Không bao giờ có nhiều hơn một ô hiện tại. Khi người dùng chọn một hoặc nhiều dải ô, một trong các ô trong vùng chọn sẽ là ô hiện tại.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Cầu thủ trả bóng
Range
– ô hiện tạ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
get Data Range()
Trả về một Range
tương ứng với các phương diện có dữ liệu.
Việc này tương đương về mặt chức năng với việc tạo một Dải ô được giới hạn bởi A1 và (Sheet.getLastColumn(), Sheet.getLastRow()).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
Cầu thủ trả bóng
Range
– một dải ô bao gồm tất cả dữ liệu trong bảng tính
Ủ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 Data Source Formulas()
Lấy tất cả công thức nguồn dữ liệu.
// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets // file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source formulas on Sheet1. // To get an array of data source formulas for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceFormulas = sheet.getDataSourceFormulas(); // Logs the first data source formula in the array. console.log(dataSourceFormulas[0].getFormula());
Cầu thủ trả bóng
Data
– Danh sách công thức nguồn dữ liệu.
Ủ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 Data Source Pivot Tables()
Lấy tất cả bảng tổng hợp nguồn dữ liệu.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source pivot tables on Sheet1. // To get an array of data source pivot tables for the entire // spreadsheet, replace 'sheet' with 'ss'. const dataSourcePivotTables = sheet.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
Cầu thủ trả bóng
Data
– Danh sách bảng tổng hợp nguồn dữ liệu.
Ủ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 Data Source Refresh Schedules()
Lấy lịch làm mới của bảng tính này.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates BigQuery operations for the connected spreadsheet. SpreadsheetApp.enableBigQueryExecution(); // Gets the frequency type of the first referesh schedule in the array. const frequencyType = ss.getDataSourceRefreshSchedules()[0] .getFrequency() .getFrequencyType() .toString(); // Logs the frequency type to the console. console.log(frequencyType);
Cầu thủ trả bóng
Data
– Lịch làm mới của bảng tính này.
Ủ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 Data Source Sheets()
Trả về tất cả các trang tính nguồn dữ liệu trong bảng tính.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the first data source sheet in the spreadsheet. const dataSource = ss.getDataSourceSheets()[0]; // Gets the name of the data source sheet. console.log(dataSource.asSheet().getName());
Cầu thủ trả bóng
Data
– Một mảng gồm tất cả các trang tính nguồn dữ liệu.
Ủ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 Data Source Tables()
Lấy tất cả bảng nguồn dữ liệu.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of data source tables on Sheet1. // To get an array of data source tables for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceTables = sheet.getDataSourceTables(); // Logs the last completed data execution time on the first data source table. console.log(dataSourceTables[0].getStatus().getLastExecutionTime());
Cầu thủ trả bóng
Data
– Danh sách các bảng nguồn dữ liệu.
Ủ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 Data Sources()
Trả về tất cả nguồn dữ liệu trong bảng tính.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the data sources on the spreadsheet. const dataSources = ss.getDataSources(); // Logs the name of the first column on the first data source. console.log(dataSources[0].getColumns()[0].getName());
Cầu thủ trả bóng
Data
– Một mảng gồm tất cả các nguồn dữ liệu.
Ủ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 Developer Metadata()
Lấy siêu dữ liệu nhà phát triển được liên kết với bảng tính cấp cao nhất.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds 'Google' as a key to the spreadsheet metadata. ss.addDeveloperMetadata('Google'); // Gets the spreadsheet's metadata. const ssMetadata = ss.getDeveloperMetadata(); // Gets the first set of the spreadsheet's metadata and logs the key to the console. console.log(ssMetadata[0].getKey());
Cầu thủ trả bóng
Developer
– Siêu dữ liệu nhà phát triển liên kết với phạm vi này.
Ủ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 Editors()
Lấy danh sách trình chỉnh sửa cho Spreadsheet
này.
Cầu thủ trả bóng
User[]
– Mảng người dùng có quyền chỉnh sửa.
Ủ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 Form Url()
Trả về URL của biểu mẫu gửi phản hồi đến bảng tính này hoặc null
nếu bảng tính này không có biểu mẫu liên kết. Nếu nhiều biểu mẫu gửi phản hồi đến bảng tính này, thì URL của biểu mẫu được trả về sẽ không xác định. Ngoài ra, bạn có thể truy xuất các mối liên kết URL của biểu mẫu trên mỗi trang tính thông qua phương thức Sheet.getFormUrl()
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the form URL from the spreadsheet. const formUrl = ss.getFormUrl(); // Logs the form URL to the console. console.log(formUrl);
Cầu thủ trả bóng
String
– URL của biểu mẫu đặt các câu trả lời trong bảng tính này hoặc null
nếu bảng tính này không có biểu mẫu được liên kết.
Ủ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 Frozen Columns()
Trả về số lượng cột được cố định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Cầu thủ trả bóng
Integer
– số lượng cột được cố định
Ủ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 Frozen Rows()
Trả về số lượng hàng được cố định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Cầu thủ trả bóng
Integer
– số lượng hàng được cố định
Ủ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 Id()
Lấy giá trị nhận dạng duy nhất cho bảng tính này. Bạn có thể trích xuất mã nhận dạng bảng tính từ URL của bảng tính đó. Ví dụ: mã nhận dạng bảng tính trong URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 là "abc1234567".
// The code below logs the ID for the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());
Cầu thủ trả bóng
String
– Mã nhận dạng (hoặc khoá) duy nhất của bảng tính.
get Images()
Trả về tất cả hình ảnh nằm ngoài lưới trên trang tính.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the over-the-grid images from Sheet1. // To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead. const images = sheet.getImages(); // For each image, logs the anchor cell in A1 notation. for (const image of images) { console.log(image.getAnchorCell().getA1Notation()); }
Cầu thủ trả bóng
Over
– Một mảng gồm các hình ảnh đè lên lướ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
get Iterative Calculation Convergence Threshold()
Trả về giá trị ngưỡng được sử dụng trong quá trình tính toán lặp lại. Khi kết quả của các lần tính toán liên tiếp khác nhau ít hơn giá trị này, quá trình tính toán lặp lại sẽ dừng.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the iterative calculation convergence threshold for the spreadsheet. ss.setIterativeCalculationConvergenceThreshold(2); // Logs the threshold to the console. console.log(ss.getIterativeCalculationConvergenceThreshold());
Cầu thủ trả bóng
Number
– Ngưỡng hội tụ.
Ủ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 Last Column()
Trả về vị trí của cột cuối cùng có nội dung.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Cầu thủ trả bóng
Integer
– cột cuối cùng của trang tính chứa nội dung
Ủ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 Last Row()
Trả về vị trí của hàng cuối cùng có nội dung.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Cầu thủ trả bóng
Integer
– hàng cuối cùng của trang tính chứa nội dung
Ủ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 Max Iterative Calculation Cycles()
Trả về số lần lặp tối đa để sử dụng trong quá trình tính toán lặp.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the max iterative calculation cycles for the spreadsheet. ss.setMaxIterativeCalculationCycles(10); // Logs the max iterative calculation cycles to the console. console.log(ss.getMaxIterativeCalculationCycles());
Cầu thủ trả bóng
Integer
– Số lần lặp lại tính toán tối đa.
Ủ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 Name()
Lấy tên của tài liệu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getName());
Cầu thủ trả bóng
String
– Tên của bảng tính.
Ủ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 Named Ranges()
Lấy tất cả các dải ô có tên trong bảng tính này.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { Logger.log(namedRanges[i].getName()); }
Cầu thủ trả bóng
Named
– Mảng gồm tất cả các dải ô có tên trong bảng tính.
Ủ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 Num Sheets()
Trả về số lượng trang tính trong bảng tính này.
// The code below logs the number of sheets in the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());
Cầu thủ trả bóng
Integer
– Số trang tính trong bảng tính.
get Owner()
Trả về chủ sở hữu của tài liệu hoặc null
đối với tài liệu trong bộ nhớ dùng chung.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var owner = ss.getOwner(); Logger.log(owner.getEmail());
Cầu thủ trả bóng
User
– Chủ sở hữu tài liệu hoặc null
nếu tài liệu nằm trong bộ nhớ dùng chung.
Ủ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 Predefined Spreadsheet Themes()
Trả về danh sách các giao diện được xác định trước.
// The code below returns the list of predefined themes. var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet() .getPredefinedSpreadsheetThemes();
Cầu thủ trả bóng
Spreadsheet
– Danh sách giao diện được xác định 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 Protections(type)
Lấy một mảng đối tượng đại diện cho tất cả các dải ô hoặc trang tính được bảo vệ trong bảng tính.
// Remove all range protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove all sheet protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
Tham số
Tên | Loại | Mô tả |
---|---|---|
type | Protection | Loại khu bảo tồn, Spreadsheet hoặc Spreadsheet . |
Cầu thủ trả bóng
Protection[]
– Một mảng đối tượng đại diện cho tất cả các dải ô hoặc trang tính được bảo vệ trong bảng tính.
Ủ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 Range(a1Notation)
Trả về dải ô được chỉ định theo ký hiệu A1 hoặc ký hiệu R1C1.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
Tham số
Tên | Loại | Mô tả |
---|---|---|
a1Notation | String | Dải ô cần trả về, được chỉ định theo ký hiệu A1 hoặc ký hiệu R1C1. |
Cầu thủ trả bóng
Range
– dải ô tại vị trí được chỉ định
Ủ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 Range By Name(name)
Trả về một dải ô được đặt tên hoặc null
nếu không tìm thấy dải ô có tên đã cho. Nếu nhiều trang tính của bảng tính sử dụng cùng một tên dải ô, hãy chỉ định tên trang tính mà không cần thêm dấu ngoặc kép – ví dụ: get
hoặc get
, nhưng không phải get
.
// Log the number of columns for the range named 'TaxRates' in the active spreadsheet. var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates'); if (range != null) { Logger.log(range.getNumColumns()); }
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên của dải ô cần lấy. |
Cầu thủ trả bóng
Range
– Dải ô có tên đã cho.
get Range List(a1Notations)
Trả về tập hợp Range
đại diện cho các dải ô trong cùng một trang tính được chỉ định bằng danh sách không trống gồm các ký hiệu A1 hoặc R1C1.
// Get a list of ranges A1:D4, F1:H4. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
Tham số
Tên | Loại | Mô tả |
---|---|---|
a1Notations | String[] | Danh sách các dải ô cần trả về, được chỉ định theo ký hiệu A1 hoặc ký hiệu R1C1. |
Cầu thủ trả bóng
Range
– danh sách dải ô tại vị trí được chỉ định
Ủ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 Recalculation Interval()
Trả về khoảng thời gian tính toán cho bảng tính này.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Logs the calculation interval for the spreadsheet to the console. console.log(ss.getRecalculationInterval().toString());
Cầu thủ trả bóng
Recalculation
– Khoảng thời gian tính toán cho bảng tính này.
Ủ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 Row Height(rowPosition)
Lấy chiều cao tính bằng pixel của hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Tham số
Tên | Loại | Mô tả |
---|---|---|
row | Integer | Vị trí của hàng cần kiểm tra. |
Cầu thủ trả bóng
Integer
– chiều cao hàng tính bằng pixel
Ủ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 Selection()
Trả về Selection
hiện tại trong bảng tính.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Cầu thủ trả bóng
Selection
– lựa chọn hiện tạ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
get Sheet By Name(name)
Trả về một trang tính có tên đã cho.
Nếu nhiều trang tính có cùng tên, thì trang tính ở ngoài cùng bên trái sẽ được trả về. Trả về null
nếu không có trang tính nào có tên đã cho.
// The code below logs the index of a sheet named "Expenses" var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses"); if (sheet != null) { Logger.log(sheet.getIndex()); }
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên của trang tính cần lấy. |
Cầu thủ trả bóng
Sheet
– Trang tính có tên đã cho.
get Sheet Id()
Trả về mã nhận dạng của trang tính do đối tượng này biểu thị.
Đây là mã nhận dạng duy nhất của trang tính. Mã nhận dạng là một số nguyên tăng dần được chỉ định tại thời điểm tạo trang tính, độc lập với vị trí của trang tính. Điều này rất hữu ích khi kết hợp với các phương thức như Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
lấy tham số grid
thay vì thực thể Sheet
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Cầu thủ trả bóng
Integer
– mã nhận dạng duy nhất của trang tính trong bảng tính
Ủ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 Sheet Name()
Trả về tên trang tính.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Cầu thủ trả bóng
String
– tên của trang tính
Ủ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 Sheet Values(startRow, startColumn, numRows, numColumns)
Trả về lưới hình chữ nhật gồm các giá trị cho dải ô này, bắt đầu từ toạ độ đã cho. Giá trị -1 được cung cấp dưới dạng vị trí hàng hoặc cột tương đương với việc lấy hàng hoặc cột cuối cùng có dữ liệu trong trang tính.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Tham số
Tên | Loại | Mô tả |
---|---|---|
start | Integer | Vị trí của hàng bắt đầu. |
start | Integer | Vị trí của cột bắt đầu. |
num | Integer | Số hàng cần trả về giá trị. |
num | Integer | Số lượng cột cần trả về giá trị. |
Cầu thủ trả bóng
Object[][]
– một mảng hai chiều gồm các giá trị
Ủ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 Sheets()
Lấy tất cả các trang tính trong bảng tính này.
// The code below logs the name of the second sheet var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets(); if (sheets.length > 1) { Logger.log(sheets[1].getName()); }
Cầu thủ trả bóng
Sheet[]
– Mảng gồm tất cả các trang tính trong bảng tính.
get Spreadsheet Locale()
Lấy ngôn ngữ của bảng tính.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the spreadsheet locale. const ssLocale = ss.getSpreadsheetLocale(); // Logs the locale to the console. console.log(ssLocale);
Cầu thủ trả bóng
String
– Ngôn ngữ của bảng tính.
Ủ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 Spreadsheet Theme()
Trả về giao diện hiện tại của bảng tính hoặc null
nếu không áp dụng giao diện nào.
// The code below returns the current theme of the spreadsheet. var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();
Cầu thủ trả bóng
Spreadsheet
– Giao diện hiện đang được áp dụng.
Ủ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 Spreadsheet Time Zone()
Lấy múi giờ cho bảng tính.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the time zone of the spreadsheet. ss.setSpreadsheetTimeZone('America/New_York'); // Gets the time zone of the spreadsheet. const ssTimeZone = ss.getSpreadsheetTimeZone(); // Logs the time zone to the console. console.log(ssTimeZone);
Cầu thủ trả bóng
String
– Múi giờ, được chỉ định ở định dạng "dài" (ví dụ: "Hoa Kỳ/New_York", như được liệt kê bởi Joda.org).
Ủ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 Url()
Trả về URL cho bảng tính đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getUrl());
Cầu thủ trả bóng
String
– URL của bảng tính đã cho.
Ủ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 Viewers()
Lấy danh sách người xem và người nhận xét cho Spreadsheet
này.
Cầu thủ trả bóng
User[]
– Mảng người dùng có quyền xem hoặc bình luận.
Ủ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
hide Column(column)
Ẩn cột hoặc các cột trong dải ô đã cho.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
Tham số
Tên | Loại | Mô tả |
---|---|---|
column | Range | Dải ô cần ẩn. |
Ủ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
hide Row(row)
Ẩn các hàng trong dải ô đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
Tham số
Tên | Loại | Mô tả |
---|---|---|
row | Range | Dải ô cần ẩn. |
Ủ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
insert Column After(afterPosition)
Chèn một cột sau vị trí cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
after | Integer | Cột mà bạn muốn thêm cột mới vào sau đó. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
insert Column Before(beforePosition)
Chèn một cột trước vị trí cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
before | Integer | Cột trước cột mới cần thêm. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
insert Columns After(afterPosition, howMany)
Chèn một số lượng cột nhất định sau vị trí cột đã cho.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Inserts two columns after the first column on the first sheet of the spreadsheet. sheet.insertColumnsAfter(1,2);
Tham số
Tên | Loại | Mô tả |
---|---|---|
after | Integer | Cột mà bạn muốn thêm cột mới vào sau đó. |
how | Integer | Số lượng cột cần chèn. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
insert Columns Before(beforePosition, howMany)
Chèn một số cột trước vị trí cột đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Tham số
Tên | Loại | Mô tả |
---|---|---|
before | Integer | Cột trước cột mới cần thêm. |
how | Integer | Số lượng cột cần chèn. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
insert Data Source Sheet(spec)
Chèn một Data
mới vào bảng tính và bắt đầu thực thi dữ liệu. Đây cũng là một hiệu ứng phụ, khiến trang tính mới trở thành trang tính đang hoạt động.
Gửi một ngoại lệ nếu loại nguồn dữ liệu không được bật. Sử dụng các phương thức Spreadsheet
để cho phép thực thi dữ liệu cho một loại nguồn dữ liệu cụ thể.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Builds a data source specification. // TODO (developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setTableProjectId('bigquery-public-data') .setDatasetId('ncaa_basketball') .setTableId('mbb_historical_teams_games') .build(); // Adds the data source and its data to the spreadsheet. ss.insertDataSourceSheet(dataSourceSpec);
Tham số
Tên | Loại | Mô tả |
---|---|---|
spec | Data | Thông số nguồn dữ liệu để chèn. |
Cầu thủ trả bóng
Data
– Trang tính nguồn dữ liệu mớ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
insert Image(blobSource, column, row)
Chèn Spreadsheet
dưới dạng hình ảnh trong tài liệu ở một hàng và cột nhất định. Kích thước hình ảnh được truy xuất từ nội dung blob. Kích thước blob tối đa được hỗ trợ là 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
blob | Blob | Blob chứa nội dung hình ảnh, loại MIME và tên (không bắt buộc). |
column | Integer | Vị trí cột. |
row | Integer | Vị trí hàng. |
Cầu thủ trả bóng
Over
– Hình ảnh đã chèn.
Ủ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
insert Image(blobSource, column, row, offsetX, offsetY)
Chèn Spreadsheet
dưới dạng hình ảnh trong tài liệu ở một hàng và cột nhất định, với độ dời pixel. Kích thước hình ảnh được truy xuất từ nội dung blob. Kích thước tối đa của blob được hỗ trợ là 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Tham số
Tên | Loại | Mô tả |
---|---|---|
blob | Blob | Blob chứa nội dung hình ảnh, loại MIME và tên (không bắt buộc). |
column | Integer | Vị trí cột. |
row | Integer | Vị trí hàng. |
offsetX | Integer | Độ lệch theo chiều ngang từ góc ô tính bằng pixel. |
offsetY | Integer | Độ lệch dọc từ góc ô tính bằng pixel. |
Cầu thủ trả bóng
Over
– Hình ảnh đã chèn.
Ủ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
insert Image(url, column, row)
Chèn hình ảnh vào tài liệu ở một hàng và cột nhất định.
URL được cung cấp phải có thể truy cập công khai.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
url | String | URL của hình ảnh. |
column | Integer | Vị trí cột lưới. |
row | Integer | Vị trí hàng lưới. |
Cầu thủ trả bóng
Over
– Hình ảnh đã chèn.
Ủ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
insert Image(url, column, row, offsetX, offsetY)
Chèn hình ảnh vào tài liệu ở một hàng và cột nhất định, với độ lệch pixel.
URL được cung cấp phải có thể truy cập công khai.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
Tham số
Tên | Loại | Mô tả |
---|---|---|
url | String | URL của hình ảnh. |
column | Integer | Vị trí cột. |
row | Integer | Vị trí hàng. |
offsetX | Integer | Độ lệch theo chiều ngang từ góc ô tính bằng pixel. |
offsetY | Integer | Độ lệch dọc từ góc ô tính bằng pixel. |
Cầu thủ trả bóng
Over
– Hình ảnh đã chèn.
Ủ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
insert Row After(afterPosition)
Chèn một hàng sau vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
after | Integer | Hàng mà sau đó hàng mới sẽ được thêm vào. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
insert Row Before(beforePosition)
Chèn một hàng trước vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
before | Integer | Hàng trước hàng mới cần thêm. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
insert Rows After(afterPosition, howMany)
Chèn một số hàng sau vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Tham số
Tên | Loại | Mô tả |
---|---|---|
after | Integer | Hàng mà sau đó các hàng mới sẽ được thêm vào. |
how | Integer | Số hàng cần chèn. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
insert Rows Before(beforePosition, howMany)
Chèn một số hàng trước vị trí hàng đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Tham số
Tên | Loại | Mô tả |
---|---|---|
before | Integer | Hàng trước hàng cần thêm. |
how | Integer | Số hàng cần chèn. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
insert Sheet()
Chèn một trang tính mới vào bảng tính, sử dụng tên trang tính mặc định. Trang tính mới sẽ trở thành trang tính đang hoạt động.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet();
Cầu thủ trả bóng
Sheet
– Trang tính mớ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
insert Sheet(sheetIndex)
Chèn một trang tính mới vào bảng tính tại chỉ mục đã cho. Trang tính mới sẽ trở thành trang tính đang hoạt động.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | Integer | Chỉ mục của trang tính mới tạo. Để chèn một trang tính làm trang tính đầu tiên trong bảng tính, hãy đặt giá trị này thành 0. |
Cầu thủ trả bóng
Sheet
– Trang tính mớ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
insert Sheet(sheetIndex, options)
Chèn một trang tính mới vào bảng tính tại chỉ mục đã cho và sử dụng các đối số nâng cao không bắt buộc. Trang tính mới sẽ trở thành trang tính đang hoạt động.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet(1, {template: templateSheet});
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | Integer | Chỉ mục của trang tính mới tạo. Để chèn một trang tính làm trang tính đầu tiên trong bảng tính, hãy đặt giá trị này thành 0. |
options | Object | Đối số nâng cao không bắt buộc của JavaScript. |
Thông số nâng cao
Tên | Loại | Mô tả |
---|---|---|
template | Sheet | Tất cả dữ liệu từ đối tượng trang tính mẫu sẽ được sao chép sang trang tính mới. Mẫu trang tính phải là một trong các trang tính của đối tượng Bảng tính. |
Cầu thủ trả bóng
Sheet
– Trang tính mớ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
insert Sheet(options)
Chèn một trang tính mới vào bảng tính, sử dụng tên trang tính mặc định và các đối số nâng cao không bắt buộc. Trang tính mới sẽ trở thành trang tính đang hoạt động.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet({template: templateSheet});
Tham số
Tên | Loại | Mô tả |
---|---|---|
options | Object | Các đối số nâng cao không bắt buộc của JavaScript, được liệt kê bên dưới. |
Thông số nâng cao
Tên | Loại | Mô tả |
---|---|---|
template | Sheet | Tất cả dữ liệu từ đối tượng trang tính mẫu sẽ được sao chép sang trang tính mới. Mẫu trang tính phải là một trong các trang tính của đối tượng Bảng tính này. |
Cầu thủ trả bóng
Sheet
– Trang tính mớ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
insert Sheet(sheetName)
Chèn một trang tính mới vào bảng tính có tên đã cho. Trang tính mới sẽ trở thành trang tính đang hoạt động.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet');
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | String | Tên của trang tính mới. |
Cầu thủ trả bóng
Sheet
– Trang tính mớ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
insert Sheet(sheetName, sheetIndex)
Chèn một trang tính mới vào bảng tính có tên đã cho tại chỉ mục đã cho. Trang tính mới sẽ trở thành trang tính đang hoạt động.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet', 1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | String | Tên của trang tính mới. |
sheet | Integer | Chỉ mục của trang tính mới tạo. Để chèn một trang tính làm trang tính đầu tiên trong bảng tính, hãy đặt giá trị này thành 0. |
Cầu thủ trả bóng
Sheet
– Trang tính mớ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
insert Sheet(sheetName, sheetIndex, options)
Chèn một trang tính mới vào bảng tính có tên đã cho tại chỉ mục đã cho và sử dụng các đối số nâng cao không bắt buộc. Trang tính mới sẽ trở thành trang tính đang hoạt động.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', 1, {template: templateSheet});
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | String | Tên của trang tính mới. |
sheet | Integer | Chỉ mục của trang tính mới được chèn. Để chèn một trang tính làm trang tính đầu tiên trong bảng tính, hãy đặt giá trị này thành 0. |
options | Object | Đối số nâng cao không bắt buộc của JavaScript. |
Thông số nâng cao
Tên | Loại | Mô tả |
---|---|---|
template | Sheet | Tất cả dữ liệu từ đối tượng trang tính mẫu sẽ được sao chép sang trang tính mới. Mẫu trang tính phải là một trong các trang tính của đối tượng Bảng tính. |
Cầu thủ trả bóng
Sheet
– Trang tính mớ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
insert Sheet(sheetName, options)
Chèn một trang tính mới vào bảng tính có tên đã cho và sử dụng các đối số nâng cao không bắt buộc. Trang tính mới sẽ trở thành trang tính đang hoạt động.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', {template: templateSheet});
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | String | Tên của trang tính mới. |
options | Object | Đối số nâng cao không bắt buộc của JavaScript. |
Thông số nâng cao
Tên | Loại | Mô tả |
---|---|---|
template | Sheet | Tất cả dữ liệu từ đối tượng trang tính mẫu sẽ được sao chép sang trang tính mới. Mẫu trang tính phải là một trong các trang tính của đối tượng Bảng tính. |
Cầu thủ trả bóng
Sheet
– Trang tính mớ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
insert Sheet With Data Source Table(spec)
Chèn một trang tính mới vào bảng tính, tạo một Data
trải dài trên toàn bộ trang tính với thông số kỹ thuật nguồn dữ liệu đã cho và bắt đầu thực thi dữ liệu. Hiệu ứng phụ là đặt trang tính mới làm trang tính đang hoạt động.
Gửi một ngoại lệ nếu loại nguồn dữ liệu không được bật. Sử dụng các phương thức Spreadsheet
để cho phép thực thi dữ liệu cho một loại nguồn dữ liệu cụ thể.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds a sheet and sets cell A1 as the parameter cell. const parameterCell = ss.insertSheet('parameterSheet').getRange('A1'); // Sets the value of the parameter cell to 'Duke'. parameterCell.setValue('Duke'); const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' + '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL'; // Adds a data source with a query parameter. // TODO(developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setRawQuery(query) .setParameterFromCell('SCHOOL', 'parameterSheet!A1') .build(); // Adds sheets for the data source and data source table to the spreadsheet. ss.insertSheetWithDataSourceTable(dataSourceSpec);
Tham số
Tên | Loại | Mô tả |
---|---|---|
spec | Data | Thông số nguồn dữ liệu để chèn. |
Cầu thủ trả bóng
Sheet
– Trang tính mớ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
is Column Hidden By User(columnPosition)
Trả về kết quả cho biết người dùng có ẩn cột đã cho hay không.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
Tham số
Tên | Loại | Mô tả |
---|---|---|
column | Integer | Vị trí của cột cần kiểm tra. |
Cầu thủ trả bóng
Boolean
– true
nếu cột bị ẩn, false
nếu không.
Ủ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
is Iterative Calculation Enabled()
Trả về kết quả cho biết tính năng tính toán lặp có được kích hoạt trong bảng tính này hay không.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates iterative calculation on the spreadsheet. ss.setIterativeCalculationEnabled(true); // Logs whether iterative calculation is activated for the spreadsheet. console.log(ss.isIterativeCalculationEnabled());
Cầu thủ trả bóng
Boolean
– true
nếu tính toán lặp được kích hoạt, false
nếu không.
Ủ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
is Row Hidden By Filter(rowPosition)
Trả về giá trị cho biết liệu một bộ lọc (không phải chế độ xem bộ lọc) có ẩn hàng đã cho hay không.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Tham số
Tên | Loại | Mô tả |
---|---|---|
row | Integer | Vị trí của hàng cần kiểm tra. |
Cầu thủ trả bóng
Boolean
– true
nếu hàng bị ẩn, false
nếu không.
Ủ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
is Row Hidden By User(rowPosition)
Trả về kết quả cho biết người dùng có ẩn hàng đã cho hay không.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByUser(1));
Tham số
Tên | Loại | Mô tả |
---|---|---|
row | Integer | Vị trí của hàng cần kiểm tra. |
Cầu thủ trả bóng
Boolean
– true
nếu hàng bị ẩn, false
nếu không.
Ủ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
move Active Sheet(pos)
Di chuyển trang tính đang hoạt động đến vị trí đã cho trong danh sách trang tính. Gửi một ngoại lệ nếu vị trí âm hoặc lớn hơn số lượng trang tính.
// This example assumes that there are 2 sheets in the current // active spreadsheet: one named "first" in position 1 and another named "second" // in position 2. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Gets the "first" sheet and activates it. var sheet = spreadsheet.getSheetByName("first").activate(); // Logs 'Current index of sheet: 1' console.log("Current index of sheet: %s", sheet.getIndex()); spreadsheet.moveActiveSheet(2); // Logs 'New index of sheet: 2' console.log("New index of sheet: %s", sheet.getIndex());
Tham số
Tên | Loại | Mô tả |
---|---|---|
pos | Integer | Vị trí chỉ mục 1 để di chuyển trang tính đang hoạt động trong danh sách trang tính. |
Ủ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
move Chart To Object Sheet(chart)
Tạo một trang tính Sheet
mới và di chuyển biểu đồ được cung cấp vào trang tính đó. Nếu biểu đồ đã có trên trang tính riêng, thì trang tính đó sẽ được trả về mà không cần tạo trang tính mới.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.newChart().setPosition(1, 1, 0, 0).build(); sheet.insertChart(chart); var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);
Tham số
Tên | Loại | Mô tả |
---|---|---|
chart | Embedded | Biểu đồ cần di chuyển. |
Cầu thủ trả bóng
Sheet
– Trang tính chứa biểu đồ.
Ủ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
refresh All Data Sources()
Làm mới tất cả nguồn dữ liệu được hỗ trợ và các đối tượng nguồn dữ liệu được liên kết của chúng, bỏ qua các đối tượng nguồn dữ liệu không hợp lệ.
Sử dụng các phương thức Spreadsheet
để cho phép thực thi dữ liệu cho một loại nguồn dữ liệu cụ thể.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the first data source sheet on the spreadsheet. const dataSheet = ss.getDataSourceSheets()[0]; // Refreshes all data sources on the spreadsheet. ss.refreshAllDataSources(); // Logs the last refreshed time of the first data source sheet. console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);
Ủ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
remove Editor(emailAddress)
Xoá người dùng đã cho khỏi danh sách trình chỉnh sửa cho Spreadsheet
. Phương thức này không chặn người dùng truy cập vào Spreadsheet
nếu họ thuộc một lớp người dùng có quyền truy cập chung, ví dụ: nếu Spreadsheet
được chia sẻ với toàn bộ miền của người dùng hoặc nếu Spreadsheet
nằm trong một ổ đĩa dùng chung mà người dùng có thể truy cập.
Đối với tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người xem.
Tham số
Tên | Loại | Mô tả |
---|---|---|
email | String | Địa chỉ email của người dùng cần xoá. |
Cầu thủ trả bóng
Spreadsheet
— Spreadsheet
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
remove Editor(user)
Xoá người dùng đã cho khỏi danh sách trình chỉnh sửa cho Spreadsheet
. Phương thức này không chặn người dùng truy cập vào Spreadsheet
nếu họ thuộc một lớp người dùng có quyền truy cập chung, ví dụ: nếu Spreadsheet
được chia sẻ với toàn bộ miền của người dùng hoặc nếu Spreadsheet
nằm trong một ổ đĩa dùng chung mà người dùng có thể truy cập.
Đối với tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người xem.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Thông tin đại diện cho người dùng cần xoá. |
Cầu thủ trả bóng
Spreadsheet
— Spreadsheet
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
remove Menu(name)
Xoá một trình đơn do add
thêm. Đối số name
phải có cùng giá trị với lệnh gọi tương ứng đến add
.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"}, {name: "foo", functionName: "foo"}]); } function removeBadMenu() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.removeMenu("badMenu"); // name must match the name used when added the menu } function foo(){ // Do nothing }
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên của trình đơn cần xoá. |
Ủ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
remove Named Range(name)
Xoá một dải ô được đặt tên có tên đã cho. Gửi một ngoại lệ nếu không tìm thấy dải ô có tên đã cho trong bảng tính.
// The code below creates a new named range "foo", and then remove it. var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.setNamedRange("foo", ss.getActiveRange()); ss.removeNamedRange("foo");
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên dả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
remove Viewer(emailAddress)
Xoá người dùng đã cho khỏi danh sách người xem và người bình luận cho Spreadsheet
. Phương thức này không có hiệu lực nếu người dùng là người chỉnh sửa, chứ không phải người xem hoặc người bình luận. Phương thức này cũng không chặn người dùng truy cập vào Spreadsheet
nếu họ thuộc một lớp người dùng có quyền truy cập chung, ví dụ: nếu Spreadsheet
được chia sẻ với toàn bộ miền của người dùng hoặc nếu Spreadsheet
nằm trong một bộ nhớ dùng chung mà người dùng có thể truy cập.
Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người chỉnh sửa.
Tham số
Tên | Loại | Mô tả |
---|---|---|
email | String | Địa chỉ email của người dùng cần xoá. |
Cầu thủ trả bóng
Spreadsheet
– Spreadsheet
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
remove Viewer(user)
Xoá người dùng đã cho khỏi danh sách người xem và người bình luận cho Spreadsheet
. Phương thức này không có hiệu lực nếu người dùng là người chỉnh sửa, chứ không phải người xem. Phương thức này cũng không chặn người dùng truy cập vào Spreadsheet
nếu họ thuộc một lớp người dùng có quyền truy cập chung, ví dụ: nếu Spreadsheet
được chia sẻ với toàn bộ miền của người dùng hoặc nếu Spreadsheet
nằm trong một ổ đĩa dùng chung mà người dùng có thể truy cập.
Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người chỉnh sửa.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Thông tin đại diện cho người dùng cần xoá. |
Cầu thủ trả bóng
Spreadsheet
– Spreadsheet
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
rename(newName)
Đổi tên tài liệu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.rename("This is the new name");
Tham số
Tên | Loại | Mô tả |
---|---|---|
new | String | Tên mới cho tài liệu. |
Ủ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
rename Active Sheet(newName)
Đổi tên trang tính đang hoạt động hiện tại thành tên mới đã cho.
// The code below renames the active sheet to "Hello world" SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");
Tham số
Tên | Loại | Mô tả |
---|---|---|
new | String | Tên mới cho trang tính đang hoạt động hiện tạ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
reset Spreadsheet Theme()
Xoá giao diện đã áp dụng và đặt giao diện mặc định trên bảng tính.
// The code below applies default theme on the spreadsheet. SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();
Cầu thủ trả bóng
Spreadsheet
– Giao diện mặc định.
Ủ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
set Active Range(range)
Đặt dải ô được chỉ định làm active range
trong trang tính đang hoạt động, với ô trên cùng bên trái trong dải ô là current cell
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
Tham số
Tên | Loại | Mô tả |
---|---|---|
range | Range | Dải ô cần đặt làm dải ô đang hoạt động. |
Cầu thủ trả bóng
Range
– dải ô mới hoạt động
Ủ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
set Active Range List(rangeList)
Đặt danh sách dải ô đã chỉ định làm active ranges
trong trang tính đang hoạt động. Phạm vi cuối cùng trong danh sách được đặt thành active range
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Tham số
Tên | Loại | Mô tả |
---|---|---|
range | Range | Danh sách các dải ô cần chọn. |
Cầu thủ trả bóng
Range
– danh sách các dải ô mới được chọn
Ủ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
set Active Selection(range)
Đặt vùng lựa chọn đang hoạt động cho trang tính này.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
Tham số
Tên | Loại | Mô tả |
---|---|---|
range | Range | Phạm vi cần đặt làm lựa chọn đang hoạt động. |
Cầu thủ trả bóng
Range
– dải ô mới hoạt động
Ủ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
set Active Selection(a1Notation)
Đặt lựa chọn đang hoạt động, như được chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
Tham số
Tên | Loại | Mô tả |
---|---|---|
a1Notation | String | Dải ô cần đặt thành đang hoạt động, như được chỉ định trong ký hiệu A1 hoặc ký hiệu R1C1. |
Cầu thủ trả bóng
Range
– dải ô mới hoạt động
Ủ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
set Active Sheet(sheet)
Đặt trang tính đã cho làm trang tính đang hoạt động trong bảng tính. Giao diện người dùng của Google Trang tính sẽ hiển thị trang tính đã chọn, trừ phi trang tính đó thuộc một bảng tính khác.
// The code below makes the first sheet active in the active spreadsheet. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | Sheet | Trang tính cần đặt làm trang tính đang hoạt động. |
Cầu thủ trả bóng
Sheet
– Trang tính đang hoạt động.
Ủ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
set Active Sheet(sheet, restoreSelection)
Đặt trang tính đã cho làm trang tính đang hoạt động trong bảng tính, với tuỳ chọn khôi phục lựa chọn gần đây nhất trong trang tính đó. Giao diện người dùng của Google Trang tính sẽ hiển thị trang tính đã chọn, trừ phi trang tính đó thuộc một bảng tính khác.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var firstSheet = spreadsheet.getSheets()[0]; var secondSheet = spreadsheet.getSheets()[1]; // Set the first sheet as the active sheet and select the range D4:F4. spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate(); // Switch to the second sheet to do some work. spreadsheet.setActiveSheet(secondSheet); // Switch back to first sheet, and restore its selection. spreadsheet.setActiveSheet(firstSheet, true); // The selection of first sheet is restored, and it logs D4:F4 var range = spreadsheet.getActiveSheet().getSelection().getActiveRange(); Logger.log(range.getA1Notation());
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheet | Sheet | Trang tính mới đang hoạt động. |
restore | Boolean | Nếu true , lựa chọn gần đây nhất của trang tính mới đang hoạt động sẽ được chọn lại khi trang tính mới trở thành trang tính đang hoạt động; nếu false , trang tính mới sẽ trở thành trang tính đang hoạt động mà không thay đổi lựa chọn hiện tại. |
Cầu thủ trả bóng
Sheet
– Trang tính mới đang hoạt động.
Ủ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
set Column Width(columnPosition, width)
Đặt chiều rộng của cột đã cho tính bằng pixel.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Tham số
Tên | Loại | Mô tả |
---|---|---|
column | Integer | Vị trí của cột đã cho cần đặt. |
width | Integer | Chiều rộng tính bằng pixel để đặt chiều rộng. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
set Current Cell(cell)
Đặt ô được chỉ định làm current cell
.
Nếu ô được chỉ định nằm trong một dải ô đã chọn, thì dải ô đó sẽ trở thành dải ô đang hoạt động với ô đó là ô hiện tại.
Nếu ô được chỉ định không có trong bất kỳ dải ô nào đã chọn, thì mọi lựa chọn hiện có sẽ bị xoá và ô đó sẽ trở thành ô hiện tại và dải ô đang hoạt động.
Lưu ý: Range
được chỉ định phải bao gồm một ô, nếu không, hàm này sẽ gửi một ngoại lệ.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Tham số
Tên | Loại | Mô tả |
---|---|---|
cell | Range | Ô cần đặt làm ô hiện tại. |
Cầu thủ trả bóng
Range
– ô hiện tại mới được đặt
Ủ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
set Frozen Columns(columns)
Cố định số cột đã cho. Nếu bằng 0, thì không có cột nào bị khoá.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first column sheet.setFrozenColumns(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
columns | Integer | Số lượng cột cần cố định. |
Ủ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
set Frozen Rows(rows)
Khoá số hàng đã cho. Nếu bằng 0, thì không có hàng nào bị đóng băng.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
rows | Integer | Số hàng cần cố định. |
Ủ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
set Iterative Calculation Convergence Threshold(minThreshold)
Đặt giá trị ngưỡng tối thiểu cho phép tính toán lặp lại. Khi kết quả của các lần tính toán liên tiếp khác nhau ít hơn giá trị này, quá trình tính toán lặp lại sẽ dừng. Giá trị này phải là số không âm và mặc định là 0, 05.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the iterative calculation convergence threshold for the spreadsheet. ss.setIterativeCalculationConvergenceThreshold(2); // Logs the threshold to the console. console.log(ss.getIterativeCalculationConvergenceThreshold());
Tham số
Tên | Loại | Mô tả |
---|---|---|
min | Number | Ngưỡng hội tụ tối thiểu (phải là số không âm). |
Cầu thủ trả bóng
Spreadsheet
– Bảng tính 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
set Iterative Calculation Enabled(isEnabled)
Đặt xem tính năng tính toán lặp có được kích hoạt trong bảng tính này hay không. Nếu trước đó bạn chưa đặt số chu kỳ tính toán tối đa và ngưỡng hội tụ khi kích hoạt tính toán, thì các giá trị này sẽ lần lượt là 50 và 0,05 theo mặc định. Nếu đã được đặt trước đó, các giá trị này sẽ giữ nguyên giá trị trước đó.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates iterative calculation on the spreadsheet. ss.setIterativeCalculationEnabled(true); // Logs whether iterative calculation is activated for the spreadsheet. console.log(ss.isIterativeCalculationEnabled());
Tham số
Tên | Loại | Mô tả |
---|---|---|
is | Boolean | true nếu bạn nên bật tính năng tính toán lặp; false nếu không. |
Cầu thủ trả bóng
Spreadsheet
– Bảng tính 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
set Max Iterative Calculation Cycles(maxIterations)
Đặt số lần lặp lại phép tính tối đa cần thực hiện trong quá trình tính toán lặp lại. Giá trị này phải nằm trong khoảng từ 1 đến 10.000 (bao gồm cả hai giá trị này) và mặc định là 50.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the max iterative calculation cycles for the spreadsheet. ss.setMaxIterativeCalculationCycles(10); // Logs the max iterative calculation cycles to the console. console.log(ss.getMaxIterativeCalculationCycles());
Tham số
Tên | Loại | Mô tả |
---|---|---|
max | Integer | Số lần lặp lại tính toán tối đa (từ 1 đến 10.000). |
Cầu thủ trả bóng
Spreadsheet
– Bảng tính 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
set Named Range(name, range)
Đặt tên cho một dải ô.
// The code below creates a new named range "TaxRates" in the active spreadsheet var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên để đặt cho dải ô. |
range | Range | Thông số kỹ thuật của phạm vi. |
Ủ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
set Recalculation Interval(recalculationInterval)
Đặt tần suất bảng tính này tính toán lại.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the calculation interval for the spreadsheet to 'ON_CHANGE'. const interval = ss.setRecalculationInterval(SpreadsheetApp.RecalculationInterval.ON_CHANGE); // Logs the calculation interval to the console. console.log(interval);
Tham số
Tên | Loại | Mô tả |
---|---|---|
recalculation | Recalculation | Khoảng thời gian tính toán lại mới. |
Cầu thủ trả bóng
Spreadsheet
– Bảng tính 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
set Row Height(rowPosition, height)
Đặt chiều cao của hàng cho hàng đã cho theo pixel. Theo mặc định, các hàng sẽ tăng lên để vừa với nội dung của ô. Nếu bạn muốn buộc các hàng có chiều cao được chỉ định, hãy sử dụng Sheet.setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first row to a height of 200 pixels sheet.setRowHeight(1, 200);
Tham số
Tên | Loại | Mô tả |
---|---|---|
row | Integer | Vị trí hàng cần thay đổi. |
height | Integer | Chiều cao tính bằng pixel để đặt chiều cao. |
Cầu thủ trả bóng
Sheet
– Trang tính, hữu ích cho việc tạo chuỗi phương thứ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
set Spreadsheet Locale(locale)
Đặt ngôn ngữ của bảng tính.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the spreadsheet locale. ss.setSpreadsheetLocale('fr'); // Gets the spreadsheet locale. const ssLocale = ss.getSpreadsheetLocale(); // Logs the locale to the console. console.log(ssLocale);
Tham số
Tên | Loại | Mô tả |
---|---|---|
locale | String | Mã ngôn ngữ cần sử dụng (ví dụ: "en", "fr" hoặc "en_US"). |
Ủ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
set Spreadsheet Theme(theme)
Đặt giao diện trên bảng tính.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // The code below sets the second predefined theme as the current theme of the spreadsheet. var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes(); spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);
Tham số
Tên | Loại | Mô tả |
---|---|---|
theme | Spreadsheet | Giao diện cần áp dụng. |
Cầu thủ trả bóng
Spreadsheet
– Giao diện hiện tại mớ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
set Spreadsheet Time Zone(timezone)
Đặt múi giờ cho bảng tính.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the time zone of the spreadsheet. ss.setSpreadsheetTimeZone('America/New_York'); // Gets the time zone of the spreadsheet. const ssTimeZone = ss.getSpreadsheetTimeZone(); // Logs the time zone to the console. console.log(ssTimeZone);
Tham số
Tên | Loại | Mô tả |
---|---|---|
timezone | String | Múi giờ, được chỉ định ở định dạng "dài" (ví dụ: "Hoa Kỳ/New_York", như được Joda.org liệt kê). |
Ủ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
show(userInterface)
Hiển thị một thành phần giao diện người dùng tuỳ chỉnh trong hộp thoại nằm ở giữa khung nhìn của trình duyệt của người dùng. Quá trình thực thi tập lệnh phía máy chủ không bị tạm ngưng. Để giao tiếp với bên máy chủ, thành phần giao diện người dùng phải thực hiện lệnh gọi lại không đồng bộ đến tập lệnh bên máy chủ.
Nếu trước đó tập lệnh phía máy chủ đã hiển thị một hộp thoại chưa bị đóng, thì hộp thoại hiện có sẽ được thay thế bằng giao diện người dùng của hộp thoại mới được yêu cầu.
Đoạn mã sau đây hiển thị một ứng dụng Html
đơn giản trong hộp thoại có tiêu đề, chiều cao và chiều rộng được chỉ định:
var htmlApp = HtmlService .createHtmlOutput('<p>A change of speed, a change of style...</p>') .setTitle('My HtmlService Application') .setWidth(250) .setHeight(300); SpreadsheetApp.getActiveSpreadsheet().show(htmlApp); // The script resumes execution immediately after showing the dialog.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | Object | Html . |
Ủ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/script.container.ui
sort(columnPosition)
Sắp xếp trang tính theo cột, tăng dần.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
Tham số
Tên | Loại | Mô tả |
---|---|---|
column | Integer | Cột để sắp xếp. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
sort(columnPosition, ascending)
Sắp xếp trang tính theo cột. Nhận một tham số để chỉ định tăng dần hoặc giảm dần.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Tham số
Tên | Loại | Mô tả |
---|---|---|
column | Integer | Cột để sắp xếp. |
ascending | Boolean | true để sắp xếp tăng dần, false để sắp xếp giảm dần. |
Cầu thủ trả bóng
Sheet
– trang tính, hữu ích cho việc tạo chuỗi phương thứ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
toast(msg)
Hiển thị một cửa sổ bật lên ở góc dưới bên phải của bảng tính kèm theo thông báo đã cho.
// Show a popup with the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started');
Tham số
Tên | Loại | Mô tả |
---|---|---|
msg | String | Thông báo sẽ xuất hiện trong thông báo ngắn. |
Ủ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
toast(msg, title)
Hiển thị một cửa sổ bật lên ở góc dưới bên phải của bảng tính với thông báo và tiêu đề đã cho.
// Show a popup with the title "Status" and the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');
Tham số
Tên | Loại | Mô tả |
---|---|---|
msg | String | Thông báo sẽ xuất hiện trong thông báo ngắn. |
title | String | Tiêu đề không bắt buộc của thông báo ngắn. |
Ủ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
toast(msg, title, timeoutSeconds)
Hiển thị một cửa sổ bật lên ở góc dưới bên phải của bảng tính với tiêu đề và thông báo nhất định, cửa sổ này sẽ hiển thị trong một khoảng thời gian nhất định.
// Show a 3-second popup with the title "Status" and the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);
Tham số
Tên | Loại | Mô tả |
---|---|---|
msg | String | Thông báo sẽ xuất hiện trong thông báo ngắn. |
title | String | Tiêu đề không bắt buộc của thông báo ngắn. |
timeout | Number | Thời gian chờ tính bằng giây; nếu là null , thông báo ngắn sẽ có thời gian chờ mặc định là 5 giây; nếu là giá trị âm, thông báo ngắn sẽ vẫn hiển thị cho đến khi bị đóng. |
Ủ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
unhide Column(column)
Bỏ ẩn cột trong dải ô đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
Tham số
Tên | Loại | Mô tả |
---|---|---|
column | Range | Dải ô cần bỏ ẩn, nếu bị ẩn. |
Ủ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
unhide Row(row)
Bỏ ẩn hàng trong dải ô đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideRow(range);
Tham số
Tên | Loại | Mô tả |
---|---|---|
row | Range | Dải ô cần bỏ ẩn, nếu bị ẩn. |
Ủ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
update Menu(name, subMenus)
Cập nhật trình đơn do add
thêm. Hoạt động giống hệt như add
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; menuEntries.push({name: "Lone Menu Entry", functionName: "function1"}); ss.updateMenu("addMenuExample", menuEntries);
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên của trình đơn cần cập nhật. |
sub | Object[] | Một mảng bản đồ JavaScript có các tham số name và function . Bạn có thể sử dụng các hàm từ các thư viện đi kèm, chẳng hạn như
Library.libFunction1 . |
Ủ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
wait For All Data Executions Completion(timeoutInSeconds)
Chờ cho đến khi tất cả các lần thực thi hiện tại trong bảng tính hoàn tất, hết thời gian chờ sau số giây đã cung cấp. Gửi một ngoại lệ nếu quá trình thực thi không hoàn tất khi hết thời gian, nhưng không huỷ các quá trình thực thi dữ liệu.
Tham số
Tên | Loại | Mô tả |
---|---|---|
timeout | Integer | Thời gian chờ thực thi dữ liệu, tính bằng giây. Thời lượng tối đa là 300 giây. |
Ủ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