Class PictureFill
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
BildFüllung
Eine Füllung, die ein Bild rendert, das auf die Abmessungen des Containers ausgedehnt wird.
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
getAs(contentType) | Blob | Gibt die Daten in diesem Objekt als Blob zurück, der in den angegebenen Inhaltstyp konvertiert wurde. |
getBlob() | Blob | Gibt die Daten in diesem Objekt als Blob zurück. |
getContentUrl() | String | Ruft eine URL zum Bild ab. |
getSourceUrl() | String | Die Quell-URL des Bilds, falls verfügbar. |
Detaillierte Dokumentation
getAs(contentType)
Gibt die Daten in diesem Objekt als Blob zurück, der in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meinedatei.pdf“. Es wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden soll. Daraus wird „Einkaufsliste.25.12.2014“ zu „Einkaufsliste.25.12.pdf“.
Die täglichen Kontingente für Conversions finden Sie unter Kontingente für Google-Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.
Parameter
| Name | Typ | Beschreibung |
contentType | String | Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf' die einzige gültige Option. Bei Bildern im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' zulässig. Für ein Google Docs-Dokument ist auch 'text/markdown' zulässig. |
Rückflug
Blob – die Daten als Blob.
getBlob()
Gibt die Daten in diesem Objekt als Blob zurück.
Rückflug
Blob – die Daten als Blob.
getContentUrl()
Ruft eine URL zum Bild ab.
Diese URL ist mit dem Konto des Anfragenden getaggt. Jeder, der die URL hat, kann also auf das Bild zugreifen, als wäre er der ursprüngliche Anfragende. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen der Präsentation ändern. Die URL läuft nach kurzer Zeit ab.
Rückflug
String
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourceUrl()
Die Quell-URL des Bilds, falls verfügbar.
Wenn ein Bild per URL eingefügt wird, wird die beim Einfügen des Bilds angegebene URL zurückgegeben.
Rückflug
String: die Bild-URL oder null, wenn das Bild keine Quell-URL hat
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\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`"]]
