Class CellImageBuilder

CellImageBuilder

Compilador para CellImage. Este compilador crea el valor de imagen necesario para agregar una imagen a una 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
build()CellImageCrea el tipo de valor de imagen necesario para agregar una imagen a una celda.
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.
setAltTextDescription(description)CellImageEstablece la descripción del texto alternativo para esta imagen.
setAltTextTitle(title)CellImageEstablece el título del texto alternativo para esta imagen.
setSourceUrl(url)CellImageBuilderEstablece la URL de la fuente de la imagen.
toBuilder()CellImageBuilderCrea un compilador de imágenes de celdas según las propiedades de la imagen actual.

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 imagen que se agregaron al compilador, como la URL de origen.

Volver

CellImage: Es 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: 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.


setAltTextDescription(description)

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

Parámetros

NombreTipoDescripción
descriptionStringLa nueva descripción del texto alternativo de la imagen.

Volver

CellImage: Esta imagen, para encadenar.

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

setAltTextTitle(title)

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

Parámetros

NombreTipoDescripción
titleStringEs el nuevo título del texto alternativo de la imagen.

Volver

CellImage: Esta imagen, para encadenar.

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

setSourceUrl(url)

Establece la URL de la fuente de la imagen.

Parámetros

NombreTipoDescripción
urlStringEs la URL de la imagen.

Volver

CellImageBuilder: Este compilador, para encadenar.


toBuilder()

Crea un compilador de imágenes de celdas según las propiedades de la imagen actual. Usa 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