Class CellImage

CellImage

Stellt ein Bild dar, das in 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) der Bildwert in die Zelle einfügen.

Attribute

PropertyTypBeschreibung
valueTypeValueTypeEin Feld mit dem Wert ValueType.IMAGE, das den Typ des Bildwerts darstellt.

Methoden

MethodeRückgabetypKurzbeschreibung
getAltTextDescription()StringGibt die Alt-Textbeschreibung für dieses Bild zurück.
getAltTextTitle()StringGibt den Alt-Texttitel für dieses Bild zurück.
getContentUrl()StringGibt eine von Google gehostete URL an das 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 verwandelt, sodass Sie es in eine Zelle einfügen können.

Detaillierte Dokumentation

getAltTextDescription()

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

Zurücksenden

String: Die Alt-Textbeschreibung.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getAltTextTitle()

Gibt den Alt-Texttitel für dieses Bild zurück.

Zurücksenden

String: Der Alt-Texttitel.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getContentUrl()

Gibt eine von Google gehostete URL an das Bild zurück. Diese URL ist mit dem Konto des Antragstellers getaggt, sodass jeder, der die URL hat, effektiv als ursprünglicher Antragsteller auf das Bild zugreifen kann. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen der Tabelle ändern. Die zurückgegebene URL läuft nach einem kurzen Zeitraum ab.

Zurücksenden

String: Die von Google gehostete URL des Bildes.


getUrl()

Ruft die Quell-URL des Bildes ab. Gibt null zurück, wenn die URL nicht verfügbar ist. Wenn das Bild mithilfe einer API mithilfe einer URL eingefügt wurde, wird mit dieser Methode die URL zurückgegeben, die beim Einfügen des Bildes angegeben wurde.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

toBuilder()

Erstellt einen Builder, der ein Bild in einen Bildwerttyp verwandelt, sodass Sie es in eine Zelle einfügen können. Bevor ein Bild in eine Zelle eingefügt wird, 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.

Zurücksenden

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