Class CellImageBuilder

CellImageBuilder

Compilador para CellImage. Este compilador crea el valor de imagen necesario para agregar una imagen a una celda.

Propiedades

Propiedad	Tipo	Descripción
valueType	ValueType	El tipo de valor de la imagen de la celda, que es ValueType.IMAGE.

Métodos

Método	Tipo de datos que se devuelve	Descripción breve
build()	CellImage	Crea el tipo de valor de imagen necesario para agregar una imagen a una celda.
getAltTextDescription()	String	Muestra la descripción del texto alternativo de esta imagen.
getAltTextTitle()	String	Muestra el título del texto alternativo de esta imagen.
getContentUrl()	String	Muestra una URL alojada en Google para la imagen.
setAltTextDescription(description)	CellImage	Establece la descripción del texto alternativo de esta imagen.
setAltTextTitle(title)	CellImage	Establece el título del texto alternativo de esta imagen.
setSourceUrl(url)	CellImageBuilder	Establece la URL de origen de la imagen.
toBuilder()	CellImageBuilder	Crea un compilador de imágenes de celdas en función de las propiedades de imagen actuales.

Métodos obsoletos

Método	Tipo de datos que se devuelve	Descripción breve
getUrl()	String	Obtiene la URL de origen de la imagen.

Documentación detallada

build()

Crea el tipo de valor de imagen necesario para agregar una imagen a una celda. El valor de la imagen se compila a partir de las propiedades de la imagen agregadas al compilador, como la URL de origen.

Volver

CellImage: Una representación de la imagen que se agregará a una celda.

---

getAltTextDescription()

Muestra la descripción del texto alternativo de esta imagen.

Volver

String: La descripción del texto alternativo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

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

---

getAltTextTitle()

Muestra el título del texto alternativo de esta imagen.

Volver

String: El título del texto alternativo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

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

---

getContentUrl()

Muestra una URL alojada en Google para la imagen. Esta URL está etiquetada con la cuenta del solicitante, por lo que cualquier persona que tenga la URL accede a la imagen como el solicitante original. Es posible que se pierda el acceso a la imagen si cambia la configuración de uso compartido de la hoja de cálculo. La URL que se muestra vence después de un período corto.

const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  console.log(value.getContentUrl());
}

Volver

String: La URL de la imagen alojada en Google.

---

setAltTextDescription(description)

Establece la descripción del texto alternativo de esta imagen.

Parámetros

Nombre	Tipo	Descripción
description	String	La nueva descripción del texto alternativo de la imagen.

Volver

CellImage: Esta imagen, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

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

---

setAltTextTitle(title)

Establece el título del texto alternativo de esta imagen.

Parámetros

Nombre	Tipo	Descripción
title	String	El nuevo título del texto alternativo de la imagen.

Volver

CellImage: Esta imagen, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

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

---

setSourceUrl(url)

Establece la URL de origen de la imagen.

Parámetros

Nombre	Tipo	Descripción
url	String	La URL de la imagen.

Volver

CellImageBuilder: Este compilador, para el encadenamiento.

---

toBuilder()

Crea un compilador de imágenes de celdas en función de las propiedades de imagen actuales. Usa setSourceUrl(url) para establecer la URL de origen de la imagen nueva. Luego, puedes agregarla a una celda con Range.setValue(value) o Range.setValues(values).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  const newImage =
      value.toBuilder()
          .setSourceUrl(
              'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',
              )
          .build();
  const newRange = ss.getRange("Sheet1!A2");
  newRange.setValue(newImage);
}

Volver

CellImageBuilder: Un compilador que crea un tipo de valor de imagen en función de las propiedades de imagen proporcionadas.

Métodos obsoletos

getUrl()

Obsoleto. Para la mayoría de las imágenes insertadas recientemente, la URL de origen no está disponible.

Obtiene la URL de origen de la imagen. Muestra una cadena vacía si la URL no está disponible. Para la mayoría de las imágenes insertadas recientemente, la URL de origen no está disponible, independientemente de cómo se inserte la imagen.

Volver

String: La URL de origen de la imagen si está disponible; de lo contrario, muestra una cadena vacía.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

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