Đại diện cho một hình ảnh để thêm vào ô. Để thêm hình ảnh vào một ô, bạn phải tạo giá trị mới cho hình ảnh đó bằng cách sử dụng SpreadsheetApp.newCellImage() và CellImageBuilder. Sau đó, bạn có thể sử dụng Range.setValue(value) hoặc Range.setValues(values) để thêm giá trị hình ảnh vào ô.
Thuộc tính
| Tài sản | Loại | Nội dung mô tả |
|---|---|---|
valueType | ValueType | Một trường được đặt thành ValueType.IMAGE, đại diện cho loại giá trị hình ảnh. |
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
getAltTextDescription() | String | Trả về nội dung mô tả văn bản thay thế cho hình ảnh này. |
getAltTextTitle() | String | Trả về tiêu đề của văn bản thay thế cho hình ảnh này. |
getContentUrl() | String | Trả về hình ảnh một URL do Google lưu trữ. |
getUrl() | String | Lấy URL nguồn của hình ảnh; trả về null nếu URL không có sẵn. |
toBuilder() | CellImageBuilder | Tạo một trình tạo có thể chuyển hình ảnh thành loại giá trị hình ảnh để bạn có thể đặt hình ảnh đó vào một ô. |
Tài liệu chi tiết
getAltTextDescription()
Trả về nội dung mô tả văn bản thay thế cho hình ảnh này.
Cầu thủ trả bóng
String – Mô tả văn bản thay thế.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getAltTextTitle()
Trả về tiêu đề của văn bản thay thế cho hình ảnh này.
Cầu thủ trả bóng
String – Tiêu đề của văn bản thay thế.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getContentUrl()
Trả về hình ảnh một URL do Google lưu trữ. URL này được gắn thẻ với tài khoản của người yêu cầu, vì vậy, bất kỳ ai có URL đều có thể truy cập hình ảnh một cách hiệu quả như người yêu cầu ban đầu. Bạn có thể mất quyền truy cập vào hình ảnh nếu chế độ cài đặt cách chia sẻ của bảng tính thay đổi. URL được trả về sẽ hết hạn sau một khoảng thời gian ngắn.
Cầu thủ trả bóng
String – URL của hình ảnh do Google lưu trữ.
getUrl()
Lấy URL nguồn của hình ảnh; trả về null nếu URL không có sẵn. Nếu hình ảnh được chèn bằng URL thông qua API, thì phương thức này sẽ trả về URL được cung cấp trong quá trình chèn hình ảnh.
Cầu thủ trả bóng
String – URL hình ảnh nếu có; trả về null nếu hình ảnh không truy cập được hoặc không có URL nguồn.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
toBuilder()
Tạo một trình tạo có thể chuyển hình ảnh thành loại giá trị hình ảnh để bạn có thể đặt hình ảnh đó vào một ô. Trước khi đặt hình ảnh vào một ô, bạn cần tạo hình ảnh dưới dạng loại giá trị hình ảnh.
Sau đó, bạn có thể thêm đối tượng này vào một ô bằng cách sử dụng Range.setValue(value) hoặc Range.setValues(values).
Cầu thủ trả bóng
CellImageBuilder – Trình tạo tạo loại giá trị hình ảnh dựa trên các thuộc tính hình ảnh nhất định.