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. Sonra resim değerini hücreye eklemek için Range.setValue(value) veya Range.setValues(values) kullanabilirsiniz.
Özellikler
| Özellik | Tür | Açıklama |
|---|---|---|
valueType | ValueType | Resim değer türünü temsil eden ValueType.IMAGE olarak ayarlanmış bir alan. |
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
getAltTextDescription() | String | Bu görselin alternatif metin açıklamasını döndürür. |
getAltTextTitle() | String | Bu görselin alternatif metin başlığını döndürür. |
getContentUrl() | String | Resmin Google tarafından barındırılan URL'sini döndürür. |
getUrl() | String | Resmin kaynak URL'sini alır; URL kullanılamıyorsa null değerini döndürür. |
toBuilder() | CellImageBuilder | Bir resmi hücreye yerleştirebilmeniz için resim değeri türüne dönüştüren bir oluşturucu oluşturur. |
Ayrıntılı belgeler
getAltTextDescription()
Bu görselin alternatif metin açıklamasını döndürür.
Return
String: Alternatif metnin açıklaması.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
Bu görselin alternatif metin başlığını döndürür.
Return
String: Alternatif metnin başlığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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 herkes, resme orijinal istek sahibi olarak etkili bir şekilde erişir. 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 kullanılamıyorsa null değerini döndürür. Resim, API kullanılarak URL aracılığıyla eklendiyse bu yöntem, resim ekleme sırasında sağlanan URL'yi döndürür.
Return
String — Varsa resmin URL'si. Resim kullanılamıyorsa veya kaynak URL'si yoksa null değerini döndürür.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
toBuilder()
Bir resmi hücreye yerleştirebilmeniz için resim değeri türüne dönüştüren bir oluşturucu oluşturur. Bir resmin hücreye yerleştirilmeden önce bir resim değer türü olarak oluşturulması gerekir.
Daha sonra, Range.setValue(value) veya Range.setValues(values) kullanarak bu dosyayı bir hücreye ekleyebilirsiniz.
Return
CellImageBuilder: Belirtilen resim özelliklerine göre resim değeri türü oluşturan bir oluşturucu.