Class CellImage

CeldaImagen

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

PropiedadTipoDescripción
valueTypeValueTypeEs el tipo de valor de la imagen de la celda, que es ValueType.IMAGE.

Métodos

MétodoTipo de datos que se muestraDescripción breve
getAltTextDescription()StringMuestra la descripción del texto alternativo de esta imagen.
getAltTextTitle()StringMuestra el título del texto alternativo de esta imagen.
getContentUrl()StringMuestra una URL alojada por Google a la imagen.
toBuilder()CellImageBuilderCrea un compilador de imágenes de celdas según las propiedades de la imagen actual.

Documentación detallada

getAltTextDescription()

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

Volver

String: Es 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 ámbitos:

  • 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: Es 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 ámbitos:

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

getContentUrl()

Muestra una URL alojada por 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 breve. 

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

Volver

String: Es la URL alojada por Google de la imagen.

toBuilder()

Crea un compilador de imágenes de celdas según las propiedades de la imagen actual. Usa CellImageBuilder.setSourceUrl(url) para establecer la URL de origen de la imagen nueva. Luego, puedes agregarlo 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: Es un compilador que crea un tipo de valor de imagen según las propiedades de imagen determinadas.

Métodos obsoletos