Class CellImage

CellImage

Stellt ein Bild dar, das einer Zelle hinzugefügt werden soll. Wenn Sie einer Zelle ein Bild hinzufügen möchten, müssen Sie mit SpreadsheetApp.newCellImage() und CellImageBuilder einen neuen Bildwert für das Bild erstellen. Anschließend können Sie Range.setValue(value) oder Range.setValues(values) verwenden, um den Bildwert in die Zelle einzufügen.

Attribute

PropertyTypBeschreibung
valueTypeValueTypeEin auf ValueType.IMAGE festgelegtes Feld, das den Bildwerttyp darstellt.

Methoden

MethodeRückgabetypKurzbeschreibung
getAltTextDescription()StringGibt die Beschreibung des alternativen Texts für dieses Bild zurück.
getAltTextTitle()StringGibt den Titel des alternativen Texts für dieses Bild zurück.
getContentUrl()StringGibt eine von Google gehostete URL zum Bild zurück.
getUrl()StringRuft die Quell-URL des Bildes ab. Gibt null zurück, wenn die URL nicht verfügbar ist.
toBuilder()CellImageBuilderErstellt einen Builder, der ein Bild in einen Bildwerttyp umwandelt, sodass Sie es in eine Zelle einfügen können.

Detaillierte Dokumentation

getAltTextDescription()

Gibt die Beschreibung des alternativen Texts für dieses Bild zurück.

Return

String: Die Beschreibung des alternativen Texts.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getAltTextTitle()

Gibt den Titel des alternativen Texts für dieses Bild zurück.

Return

String: Der Titel des alternativen Texts.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getContentUrl()

Gibt eine von Google gehostete URL zum Bild zurück. Diese URL ist mit dem Konto des Anforderers getaggt, sodass jeder mit der URL effektiv auf das Bild als ursprünglicher Anforderer zugreift. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen der Tabelle ändern. Die zurückgegebene URL läuft nach kurzer Zeit ab.

Return

String: Die von Google gehostete Bild-URL.


getUrl()

Ruft die Quell-URL des Bildes ab. Gibt null zurück, wenn die URL nicht verfügbar ist. Wenn das Bild per URL mithilfe einer API eingefügt wurde, gibt diese Methode die beim Einfügen des Bildes angegebene URL zurück.

Return

String: Die Bild-URL, falls verfügbar. Gibt null zurück, wenn das Bild nicht verfügbar ist oder keine Quell-URL hat.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

toBuilder()

Erstellt einen Builder, der ein Bild in einen Bildwerttyp umwandelt, sodass Sie es in eine Zelle einfügen können. Bevor ein Bild in eine Zelle eingefügt werden kann, muss es als Bildwerttyp erstellt werden. Anschließend können Sie ihn mit Range.setValue(value) oder Range.setValues(values) in eine Zelle einfügen.

Return

CellImageBuilder: Ein Builder, der einen Bildwerttyp basierend auf den angegebenen Bildeigenschaften erstellt.