Class CellImage

CellImage

Representa un valor de imagen en una celda. Para agregar una imagen a una celda, debes crear un valor de imagen nuevo para la imagen con SpreadsheetApp.newCellImage() y CellImageBuilder. Luego, puedes usar Range.setValue(value) o Range.setValues(values) para agregar el valor de la imagen a la 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
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 a la imagen.
toBuilder()	CellImageBuilder	Crea un generador 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

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 a 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.

---

toBuilder()

Crea un generador de imágenes de celdas en función de las propiedades de imagen actuales. Usa CellImageBuilder.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 generador 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