Representa una imagen que se agregará a 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 | Un campo establecido en ValueType.IMAGE, que representa el tipo de valor de la imagen. |
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
|---|---|---|
getAltTextDescription() | String | Muestra la descripción de texto alternativo de esta imagen. |
getAltTextTitle() | String | Muestra el título de texto alternativo de esta imagen. |
getContentUrl() | String | Muestra una URL alojada en Google a la imagen. |
getUrl() | String | Obtiene la URL de origen de la imagen y muestra null si la URL no está disponible. |
toBuilder() | CellImageBuilder | Crea un compilador que convierte una imagen en un tipo de valor de imagen para que puedas colocarla en una celda. |
Documentación detallada
getAltTextDescription()
Muestra la descripción de texto alternativo de esta imagen.
Devolvedor
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 alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
Muestra el título de texto alternativo de esta imagen.
Devolvedor
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 alcances:
-
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 se etiqueta con la cuenta del solicitante, por lo que cualquier persona con la URL acceda de manera efectiva a la imagen como el solicitante original. El acceso a la imagen se puede perder si se 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.
Devolvedor
String: Es la URL de la imagen alojada en Google.
getUrl()
Obtiene la URL de origen de la imagen y muestra null si la URL no está disponible. Si la imagen se insertó mediante una API con una API, este método muestra la URL proporcionada durante la inserción de la imagen.
Devolvedor
String: Es la URL de la imagen, si está disponible. Muestra null si la imagen no está disponible o no tiene una URL de origen.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
toBuilder()
Crea un compilador que convierte una imagen en un tipo de valor de imagen para que puedas colocarla en una celda. Antes de colocar una imagen en una celda, se debe crear como un tipo de valor de imagen.
Luego, podrás agregarlo a una celda con Range.setValue(value) o Range.setValues(values).
Devolvedor
CellImageBuilder: Es un compilador que crea un tipo de valor de imagen según las propiedades de la imagen determinadas.