Class PictureFill
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
內容詳盡的說明文件
getAs(contentType)
將此物件內的資料傳回為轉換為指定內容類型的 Blob。這個方法會在檔案名稱中加入適當的副檔名，例如「myfile.pdf」。不過，這會假設檔案名稱中最後一個句點 (如有) 後面的部分是應取代的現有副檔名。因此，「ShoppingList.12.25.2014」會變成「ShoppingList.12.25.pdf」。
如要查看轉換的每日配額，請參閱「Google 服務的配額」。新建立的 Google Workspace 網域可能會暫時受到較嚴格的配額限制。
參數
| 名稱 | 類型 | 說明 |
contentType | String | 要轉換的 MIME 類型。對於大多數 Blob 而言，'application/pdf' 是唯一有效的選項。如果是 BMP、GIF、JPEG 或 PNG 格式的圖片，'image/bmp'、'image/gif'、'image/jpeg' 或 'image/png' 皆可用。如果是 Google 文件，'text/markdown' 也是有效的。 |
回攻員
Blob：資料為 Blob。
getBlob()
將此物件內的資料以 blob 格式傳回。
回攻員
Blob：資料為 Blob。
getContentUrl()
取得圖片的網址。
這個網址會標記要求者的帳戶，因此任何擁有該網址的使用者都能以原始要求者的身分存取圖片。如果簡報的共用設定有所變更，您可能會失去圖片存取權。網址會在短時間內失效。
回攻員
String
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourceUrl()
取得圖片的來源網址 (如有)。
透過網址插入圖片時，會傳回插入圖片時提供的網址。
回攻員
String：圖片網址，如果圖片沒有來源網址，則為 null
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003ePictureFill is a tool that stretches an image to fit the dimensions of its container.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods like \u003ccode\u003egetAs\u003c/code\u003e, \u003ccode\u003egetBlob\u003c/code\u003e, \u003ccode\u003egetContentUrl\u003c/code\u003e, and \u003ccode\u003egetSourceUrl\u003c/code\u003e to manipulate the image data and URLs.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetContentUrl\u003c/code\u003e and \u003ccode\u003egetSourceUrl\u003c/code\u003e methods require specific authorization scopes for use.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003egetContentUrl\u003c/code\u003e provides a temporary, access-controlled image URL, \u003ccode\u003egetSourceUrl\u003c/code\u003e retrieves the original URL if the image was inserted via URL.\u003c/p\u003e\n"]]],["PictureFill renders an image stretched to its container's dimensions. Key actions include: `getAs(contentType)` returning blob data converted to a specified type, with filename adjustments; `getBlob()` returning data as a blob; `getContentUrl()` retrieving a URL to the image, expiring after a short time and tied to the requester's account. Lastly, `getSourceUrl()` fetches the original image's source URL, if available, otherwise returning null. These method are accessible if authorized by the correct scopes.\n"],null,["# Class PictureFill\n\nPictureFill\n\nA fill that renders an image that's stretched to the dimensions of its container. \n\n### Methods\n\n| Method | Return type | Brief description |\n|--------------------------------------|---------------------------|---------------------------------------------------------------------------------------|\n| [getAs(contentType)](#getAs(String)) | [Blob](../base/blob.html) | Return the data inside this object as a blob converted to the specified content type. |\n| [getBlob()](#getBlob()) | [Blob](../base/blob.html) | Return the data inside this object as a blob. |\n| [getContentUrl()](#getContentUrl()) | `String` | Gets a URL to the image. |\n| [getSourceUrl()](#getSourceUrl()) | `String` | Gets the image's source URL, if available. |\n\nDetailed documentation\n----------------------\n\n### `get``As(contentType)`\n\nReturn the data inside this object as a blob converted to the specified content type. This\nmethod adds the appropriate extension to the filename---for example, \"myfile.pdf\". However, it\nassumes that the part of the filename that follows the last period (if any) is an existing\nextension that should be replaced. Consequently, \"ShoppingList.12.25.2014\" becomes\n\"ShoppingList.12.25.pdf\".\n\nTo view the daily quotas for conversions, see [Quotas for Google\nServices](https://developers.google.com/apps-script/guides/services/quotas). Newly created Google Workspace domains might be temporarily subject to stricter\nquotas.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `content``Type` | `String` | The MIME type to convert to. For most blobs, `'application/pdf'` is the only valid option. For images in BMP, GIF, JPEG, or PNG format, any of `'image/bmp'`, `'image/gif'`, `'image/jpeg'`, or `'image/png'` are also valid. For a Google Docs document, `'text/markdown'` is also valid. |\n\n#### Return\n\n\n[Blob](../base/blob.html) --- The data as a blob.\n\n*** ** * ** ***\n\n### `get``Blob()`\n\nReturn the data inside this object as a blob.\n\n#### Return\n\n\n[Blob](../base/blob.html) --- The data as a blob.\n\n*** ** * ** ***\n\n### `get``Content``Url()`\n\nGets a URL to the image.\n\nThis URL is tagged with the account of the requester, so anyone with the URL effectively\naccesses the image as the original requester. Access to the image may be lost if the\npresentation's sharing settings change. The URL expires after a short period of time.\n\n#### Return\n\n\n`String`\n\n#### Authorization\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/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Source``Url()`\n\nGets the image's source URL, if available.\n\nWhen an image is inserted by URL, returns the URL provided during image insertion.\n\n#### Return\n\n\n`String` --- the image URL or `null` if the image does not have a source URL\n\n#### Authorization\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/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`"]]
