Class CellImage

HücreResim

Bir hücredeki resim değerini 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ülk	Tür	Açıklama
valueType	ValueType	Hücre resminin değer türü (ValueType.IMAGE).

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
getAltTextDescription()	String	Bu resmin alternatif metin açıklamasını döndürür.
getAltTextTitle()	String	Bu resmin 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.
toBuilder()	CellImageBuilder	Mevcut resim özelliklerine göre bir hücre resim oluşturucu oluşturur.

Kullanımdan kaldırılan yöntemler

Yöntem	Dönüş türü	Kısa açıklama
getUrl()	String	Resmin kaynak URL'sini alır.

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.

const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  console.log(value.getContentUrl());
}

Return

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

---

toBuilder()

Mevcut resim özelliklerine göre bir hücre resim oluşturucu oluşturur. Yeni resmin kaynak URL'sini ayarlamak için CellImageBuilder.setSourceUrl(url) kullanın. Ardından Range.setValue(value) veya Range.setValues(values) kullanarak bir hücreye ekleyebilirsiniz.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  const newImage =
      value.toBuilder()
          .setSourceUrl(
              'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',
              )
          .build();
  const newRange = ss.getRange("Sheet1!A2");
  newRange.setValue(newImage);
}

Return

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

Kullanımdan kaldırılan yöntemler

getUrl()

Kullanımdan kaldırıldı. Yeni eklenen resimlerin çoğunda kaynak URL kullanılamaz.

Resmin kaynak URL'sini alır. URL kullanılamıyorsa boş dize döndürülür. Yeni eklenen resimlerin çoğunda, resim nasıl eklenmiş olursa olsun kaynak URL kullanılamaz.

Return

String: Varsa resmin kaynak URL'si, yoksa boş bir dize 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