Rappresenta un'immagine da aggiungere a una cella. Per aggiungere un'immagine a una cella, devi creare un nuovo valore immagine per l'immagine utilizzando SpreadsheetApp.newCellImage() e CellImageBuilder. Poi puoi usare Range.setValue(value) o Range.setValues(values)
per aggiungere il valore dell'immagine alla cella.
Proprietà
| Proprietà | Tipo | Descrizione |
|---|---|---|
valueType | ValueType | Un campo impostato su ValueType.IMAGE, che rappresenta il tipo di valore dell'immagine. |
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
getAltTextDescription() | String | Restituisce la descrizione del testo alternativo dell'immagine. |
getAltTextTitle() | String | Restituisce il titolo del testo alternativo dell'immagine. |
getContentUrl() | String | Restituisce un URL ospitato da Google per l'immagine. |
getUrl() | String | Restituisce l'URL di origine dell'immagine; restituisce null se l'URL non è disponibile. |
toBuilder() | CellImageBuilder | Crea un generatore che trasforma un'immagine in un tipo di valore dell'immagine per poterla inserire in una cella. |
Documentazione dettagliata
getAltTextDescription()
Restituisce la descrizione del testo alternativo dell'immagine.
Ritorni
String: la descrizione del testo alternativo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
Restituisce il titolo del testo alternativo dell'immagine.
Ritorni
String: il titolo del testo alternativo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getContentUrl()
Restituisce un URL ospitato da Google per l'immagine. Questo URL è codificato con l'account del richiedente, pertanto chiunque abbia l'URL accede di fatto all'immagine come richiedente originale. Se le impostazioni di condivisione del foglio di lavoro vengono modificate, l'accesso all'immagine potrebbe andare perso. L'URL restituito scade dopo un breve periodo di tempo.
Ritorni
String: l'URL dell'immagine ospitato da Google.
getUrl()
Restituisce l'URL di origine dell'immagine; restituisce null se l'URL non è disponibile. Se l'immagine è stata inserita da un URL utilizzando un'API, questo metodo restituisce l'URL fornito durante l'inserimento dell'immagine.
Ritorni
String: l'URL dell'immagine se disponibile; restituisce null se l'immagine non è disponibile o non ha un URL di origine.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
toBuilder()
Crea un generatore che trasforma un'immagine in un tipo di valore dell'immagine per poterla inserire in una cella. Prima di poter inserire un'immagine in una cella, devi crearla come tipo di valore dell'immagine.
Dopodiché puoi aggiungerlo a una cella utilizzando Range.setValue(value) o Range.setValues(values).
Ritorni
CellImageBuilder: un generatore che crea un tipo di valore dell'immagine in base alle proprietà dell'immagine specificate.