Class CellImage

HücreResim

Bir hücreye eklenecek resmi temsil eder. Bir hücreye resim eklemek için SpreadsheetApp.newCellImage() ve CellImageBuilder kullanarak resim için yeni bir resim değeri oluşturmanız gerekir. Ardından, resim değerini hücreye eklemek için Range.setValue(value) veya Range.setValues(values)'ü kullanabilirsiniz.

Özellikler

MülkTürAçıklama
valueTypeValueTypeResim değeri türünü temsil eden ValueType.IMAGE olarak ayarlanmış bir alan.

Yöntemler

YöntemDönüş türüKısa açıklama
getAltTextDescription()StringBu resmin alternatif metin açıklamasını döndürür.
getAltTextTitle()StringBu resmin alternatif metin başlığını döndürür.
getContentUrl()StringResmin Google tarafından barındırılan URL'sini döndürür.
getUrl()StringResmin kaynak URL'sini alır. URL mevcut değilse null döndürür.
toBuilder()CellImageBuilderBir resmi hücreye yerleştirebilmeniz için resmi resim değeri türüne dönüştüren bir oluşturucu oluşturur.

Ayrıntılı dokümanlar

getAltTextDescription()

Bu resmin alternatif metin açıklamasını döndürür.

Return

String: Alternatif metnin açıklaması.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getAltTextTitle()

Bu resmin alternatif metin başlığını döndürür.

Return

String: Alternatif metin başlığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getContentUrl()

Resmin Google tarafından barındırılan URL'sini döndürür. Bu URL, istek sahibinin hesabıyla etiketlenir. Böylece, URL'ye sahip olan herkes resme orijinal istek sahibi olarak erişebilir. E-tablonun paylaşım ayarları değişirse resme erişim kaybedilebilir. Döndürülen URL'nin süresi kısa bir süre sonra dolar.

Return

String: Resmin Google tarafından barındırılan URL'si.


getUrl()

Resmin kaynak URL'sini alır. URL mevcut değilse null döndürür. Resim, API kullanılarak URL ile eklendiyse bu yöntem, resim ekleme sırasında sağlanan URL'yi döndürür.

Return

String: Mevcutsa resim URL'si; resim mevcut değilse veya kaynak URL'si yoksa null döndürülür.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

toBuilder()

Bir resmi hücreye yerleştirebilmeniz için resmi resim değeri türüne dönüştüren bir oluşturucu oluşturur. Bir resmin hücreye yerleştirilmeden önce resim değeri türü olarak oluşturulması gerekir. Ardından Range.setValue(value) veya Range.setValues(values) kullanarak bir hücreye ekleyebilirsiniz.

Return

CellImageBuilder: Belirtilen resim özelliklerine göre bir resim değeri türü oluşturan bir oluşturucu.