Class CellImage

ZelleBild

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 mit Range.setValue(value) oder Range.setValues(values) den Bildwert der Zelle hinzufügen.

Attribute

AttributTypBeschreibung
valueTypeValueTypeEin Feld, das auf ValueType.IMAGE festgelegt ist und den Bildwerttyp darstellt.

Methoden

MethodeRückgabetypKurzbeschreibung
getAltTextDescription()StringGibt die Alt-Text-Beschreibung für dieses Bild zurück.
getAltTextTitle()StringGibt den Titel des Alt-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. Wenn die URL nicht verfügbar ist, wird null zurückgegeben.
toBuilder()CellImageBuilderErstellt einen Builder, der ein Bild in einen Bildwerttyp umwandelt, damit Sie es in eine Zelle einfügen können.

Detaillierte Dokumentation

getAltTextDescription()

Gibt die Alt-Text-Beschreibung für dieses Bild zurück.

Rückflug

String: Beschreibung des alternativen Texts.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getAltTextTitle()

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

Rückflug

String: Der Titel des Alt-Texts.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 Anfragenden getaggt, sodass alle Nutzer mit der URL auf das Bild zugreifen können, als wären sie der ursprüngliche Anfragende. 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.

Rückflug

String: Die von Google gehostete URL des Bilds.

getUrl()

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

Rückflug

String: Die Bild-URL, falls verfügbar. Es wird null zurückgegeben, wenn das Bild nicht verfügbar ist oder 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/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

toBuilder()

Erstellt einen Builder, der ein Bild in einen Bildwerttyp umwandelt, damit 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 sie mit Range.setValue(value) oder Range.setValues(values) einer Zelle hinzufügen.

Rückflug

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