Esta página foi traduzida pela API Cloud Translation.

Class CellImage

Representa uma imagem a ser adicionada a uma célula. Para adicionar uma imagem a uma célula, crie um novo valor de imagem usando SpreadsheetApp.newCellImage() e CellImageBuilder. Em seguida, use Range.setValue(value) ou Range.setValues(values) para adicionar o valor da imagem à célula.

Propriedades

Propriedade	Tipo	Descrição
`valueType`	`ValueType`	Um campo definido como `ValueType.IMAGE`, que representa o tipo de valor da imagem.

Métodos

Método	Tipo de retorno	Breve descrição
`getAltTextDescription()`	`String`	Retorna a descrição do texto alternativo para essa imagem.
`getAltTextTitle()`	`String`	Retorna o título do texto alternativo para essa imagem.
`getContentUrl()`	`String`	Retorna um URL hospedado pelo Google para a imagem.
`getUrl()`	`String`	Extrai o URL de origem da imagem e retorna `null` se o URL estiver indisponível.
`toBuilder()`	`CellImageBuilder`	Cria um builder que transforma uma imagem em um tipo de valor de imagem para que você possa colocá-la em uma célula.

Documentação detalhada

`getAltTextDescription()`

Retorna a descrição do texto alternativo para essa imagem.

Retornar

String: a descrição do texto alternativo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getAltTextTitle()`

Retorna o título do texto alternativo para essa imagem.

Retornar

String: o título do texto alternativo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getContentUrl()`

Retorna um URL hospedado pelo Google para a imagem. Esse URL é marcado com a conta do solicitante. Assim, qualquer pessoa com o URL acessa a imagem como o solicitante original. O acesso à imagem pode ser perdido se as configurações de compartilhamento da planilha mudarem. O URL retornado expira após um curto período.

Retornar

String: o URL da imagem hospedado pelo Google.

`getUrl()`

Extrai o URL de origem da imagem e retorna null se o URL estiver indisponível. Se a imagem foi inserida por URL usando uma API, esse método retorna o URL fornecido durante a inserção da imagem.

Retornar

String: o URL da imagem, se disponível. Retorna null se a imagem não estiver disponível ou não tiver um URL de origem.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`toBuilder()`

Cria um builder que transforma uma imagem em um tipo de valor de imagem para que você possa colocá-la em uma célula. Antes de colocar uma imagem em uma célula, ela precisa ser criada como um tipo de valor de imagem. Em seguida, adicione a uma célula usando Range.setValue(value) ou Range.setValues(values).

Retornar

CellImageBuilder: um builder que cria um tipo de valor de imagem com base nas propriedades de imagem fornecidas.