Class CellImage

CellImage

Bir hücredeki resim değerini gösterir. 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, Range.setValue(value) veya Range.setValues(values) kullanarak hücreye resim değeri ekleyebilirsiniz.

Ö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'da barındırılan URL'sini döndürür.
toBuilder()	CellImageBuilder	Mevcut resim özelliklerine göre bir hücre resmi 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ı belgeler

getAltTextDescription()

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

Return

String: Alternatif metin açıklaması.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

• 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

---

getContentUrl()

Resmin Google'da barındırılan URL'sini döndürür. Bu URL, istekte bulunan kullanıcının hesabıyla etiketlenir. Bu nedenle, URL'ye sahip olan herkes, resme istekte bulunan kullanıcı olarak erişir. E-tablonun paylaşım ayarları değişirse resme erişim kaybedilebilir. Döndürülen URL kısa bir süre sonra sona erer.

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'da barındırılan URL'si.

---

toBuilder()

Mevcut resim özelliklerine göre bir hücre resmi 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 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: Belirli resim özelliklerine göre 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ş bir dize döndürür. Yeni eklenen çoğu resimde, resmin nasıl eklendiğine bakılmaksızın kaynak URL kullanılamaz.

Return

String: Varsa resmin kaynak URL'si; aksi takdirde boş bir dize döndürür.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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