Trả về URL do Google lưu trữ cho hình ảnh. 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 này đều có thể truy cập vào hình ảnh dưới vai trò là 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 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.
CellImageBuilder – Một 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 đã cho.
Các phương thức ngừng hoạt động
getUrl()
Không dùng nữa. Đối với hầu hết hình ảnh mới chèn, URL nguồn không có sẵn.
Lấy URL nguồn của hình ảnh. Trả về một chuỗi trống nếu không có URL. Đối với hầu hết hình ảnh mới được chèn, URL nguồn sẽ không có sẵn bất kể hình ảnh được chèn theo cách nào.
Cầu thủ trả bóng
String – URL nguồn của hình ảnh (nếu có); trả về một chuỗi trống nếu không 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:
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003eCellImage\u003c/code\u003e allows you to add images to spreadsheet cells using \u003ccode\u003eSpreadsheetApp.newCellImage()\u003c/code\u003e and \u003ccode\u003eCellImageBuilder\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can set an image to a cell using \u003ccode\u003eRange.setValue()\u003c/code\u003e or \u003ccode\u003eRange.setValues()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eCellImage\u003c/code\u003e provides methods to access image properties like alt text, content URL, and source URL.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etoBuilder()\u003c/code\u003e creates an image value type, necessary for placing images into cells.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eCellImage\u003c/code\u003e has a single property, \u003ccode\u003evalueType\u003c/code\u003e, which is always \u003ccode\u003eValueType.IMAGE\u003c/code\u003e.\u003c/p\u003e\n"]]],["To incorporate images into spreadsheet cells, create a new image value using `SpreadsheetApp.newCellImage()` and `CellImageBuilder`. Add the image to a cell via `Range.setValue()` or `Range.setValues()`. Key methods include: `getAltTextDescription()`, `getAltTextTitle()`, `getContentUrl()`, and `toBuilder()`. The method `getUrl()` is deprecated. `getContentUrl()` returns a Google-hosted URL to the image. `toBuilder()` creates a `CellImageBuilder` to modify image properties. `valueType` property is `ValueType.IMAGE`.\n"],null,["CellImage\n\nRepresents an image value in a cell. To add an image to a cell, you must create a new image value\nfor the image using [SpreadsheetApp.newCellImage()](/apps-script/reference/spreadsheet/spreadsheet-app#newCellImage()) and [CellImageBuilder](/apps-script/reference/spreadsheet/cell-image-builder). Then you can use [Range.setValue(value)](/apps-script/reference/spreadsheet/range#setValue(Object)) or [Range.setValues(values)](/apps-script/reference/spreadsheet/range#setValues(Object)) to\nadd the image value to the cell. \n\nProperties\n\n| Property | Type | Description |\n|---------------|------------------------------------------------------------|-----------------------------------------------------------------|\n| `value``Type` | [ValueType](/apps-script/reference/spreadsheet/value-type) | The value type of the cell image, which is `Value``Type.IMAGE`. |\n\nMethods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------|---------------------------------------------------------------------------|---------------------------------------------------------------------|\n| [getAltTextDescription()](#getAltTextDescription()) | `String` | Returns the alt text description for this image. |\n| [getAltTextTitle()](#getAltTextTitle()) | `String` | Returns the alt text title for this image. |\n| [getContentUrl()](#getContentUrl()) | `String` | Returns a Google-hosted URL to the image. |\n| [toBuilder()](#toBuilder()) | [CellImageBuilder](/apps-script/reference/spreadsheet/cell-image-builder) | Creates a cell image builder based on the current image properties. |\n\nDeprecated methods\n\n| Method | Return type | Brief description |\n|-----------------------|-------------|------------------------------|\n| [getUrl()](#getUrl()) | `String` | Gets the image's source URL. |\n\nDetailed documentation \n\n`get``Alt``Text``Description()` \nReturns the alt text description for this image.\n\nReturn\n\n\n`String` --- The alt text description.\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/spreadsheets.currentonly`\n- `https://www.googleapis.com/auth/spreadsheets`\n\n*** ** * ** ***\n\n`get``Alt``Text``Title()` \nReturns the alt text title for this image.\n\nReturn\n\n\n`String` --- The alt text title.\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/spreadsheets.currentonly`\n- `https://www.googleapis.com/auth/spreadsheets`\n\n*** ** * ** ***\n\n`get``Content``Url()` \nReturns a Google-hosted URL to the image. This URL is tagged with the account of the requester,\nso anyone with the URL effectively accesses the image as the original requester. Access to the\nimage might be lost if the spreadsheet's sharing settings change. The returned URL expires\nafter a short period of time.\n\n```javascript\nconst range = SpreadsheetApp.getActiveSpreadsheet().getRange(\"Sheet1!A1\");\nconst value = range.getValue();\nif (value.valueType == SpreadsheetApp.ValueType.IMAGE) {\n console.log(value.getContentUrl());\n}\n```\n\nReturn\n\n\n`String` --- The Google-hosted URL of the image.\n\n*** ** * ** ***\n\n`to``Builder()` \nCreates a cell image builder based on the current image properties. Use [CellImageBuilder.setSourceUrl(url)](/apps-script/reference/spreadsheet/cell-image-builder#setSourceUrl(String)) to set the source URL of the new image. Then you can add it to a\ncell using [Range.setValue(value)](/apps-script/reference/spreadsheet/range#setValue(Object)) or [Range.setValues(values)](/apps-script/reference/spreadsheet/range#setValues(Object)).\n\n```javascript\nconst ss = SpreadsheetApp.getActiveSpreadsheet();\nconst range = ss.getRange(\"Sheet1!A1\");\nconst value = range.getValue();\nif (value.valueType == SpreadsheetApp.ValueType.IMAGE) {\n const newImage =\n value.toBuilder()\n .setSourceUrl(\n 'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',\n )\n .build();\n const newRange = ss.getRange(\"Sheet1!A2\");\n newRange.setValue(newImage);\n}\n```\n\nReturn\n\n\n[CellImageBuilder](/apps-script/reference/spreadsheet/cell-image-builder) --- A builder that creates an image value type based on the given image properties.\n\nDeprecated methods \n\n`get``Url()` \n\n**Deprecated.** For most newly inserted images, the source URL is unavailable.\n\nGets the image's source URL. Returns an empty string if the URL is unavailable. For most newly\ninserted images, the source URL is unavailable regardless how the image is inserted.\n\nReturn\n\n\n`String` --- The image's source URL if available; returns an empty string otherwise.\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/spreadsheets.currentonly`\n- `https://www.googleapis.com/auth/spreadsheets`"]]
