Class PictureFill

  • PictureFill is a fill that renders an image stretched to its container's dimensions.

  • It provides methods to retrieve the image data as a Blob, a temporary content URL, or the original source URL.

  • ThegetAs method allows converting the image data to a specified content type before returning it as a Blob.

  • Accessing the content or source URL may require specific authorization scopes.

PictureFill

A fill that renders an image that's stretched to the dimensions of its container.

Methods

MethodReturn typeBrief description
getAs(contentType)BlobReturn the data inside this object as a blob converted to the specified content type.
getBlob()BlobReturn the data inside this object as a blob.
getContentUrl()StringGets a URL to the image.
getSourceUrl()String|nullGets the image's source URL, if available.

Detailed documentation

getAs(contentType)

Return the data inside this object as a blob converted to the specified content type. Thismethod adds the appropriate extension to the filename—for example, "myfile.pdf". However, itassumes that the part of the filename that follows the last period (if any) is an existingextension that should be replaced. Consequently, "ShoppingList.12.25.2014" becomes"ShoppingList.12.25.pdf".

To view the daily quotas for conversions, seeQuotas for GoogleServices. Newly created Google Workspace domains might be temporarily subject to stricterquotas.

Parameters

NameTypeDescription
contentTypeStringThe 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.

Return

Blob — The data as a blob.

getBlob()

Return the data inside this object as a blob.

Return

Blob — The data as a blob.

getContentUrl()

Gets a URL to the image.

This URL is tagged with the account of the requester, so anyone with the URL effectivelyaccesses the image as the original requester. Access to the image may be lost if thepresentation's sharing settings change. The URL expires after a short period of time.

Return

String

Authorization

Scripts that use this method require authorization with one or more of the followingscopes:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSourceUrl()

Gets the image's source URL, if available.

When an image is inserted by URL, returns the URL provided during image insertion.

Return

String|null — the image URL ornull if the image does not have a source URL

Authorization

Scripts that use this method require authorization with one or more of the followingscopes:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-11 UTC.