Class CellImageBuilder

CellImageBuilder

CellImage için derleyiciler. Bu oluşturucu, bir hücreye resim eklemek için gereken resim değerini oluşturur.

Ö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
build()	CellImage	Bir hücreye resim eklemek için gereken resim değeri türünü oluşturur.
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.
setAltTextDescription(description)	CellImage	Bu resmin alternatif metin açıklamasını ayarlar.
setAltTextTitle(title)	CellImage	Bu resmin alternatif metin başlığını ayarlar.
setSourceUrl(url)	CellImageBuilder	Resim kaynağı URL'sini ayarlar.
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

build()

Bir hücreye resim eklemek için gereken resim değeri türünü oluşturur. Resim değeri, oluşturucuya eklenen resim özelliklerinden (ör. kaynak URL) oluşturulur.

Return

CellImage: Bir hücreye eklenecek resmin temsili.

---

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.

---

setAltTextDescription(description)

Bu resmin alternatif metin açıklamasını ayarlar.

Parametreler

Ad	Tür	Açıklama
description	String	Resmin yeni alternatif metin açıklaması.

Return

CellImage: Zincirleme için bu resim.

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

---

setAltTextTitle(title)

Bu resmin alternatif metin başlığını ayarlar.

Parametreler

Ad	Tür	Açıklama
title	String	Resmin yeni alternatif metin başlığı.

Return

CellImage: Zincirleme için bu resim.

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

---

setSourceUrl(url)

Resim kaynağı URL'sini ayarlar.

Parametreler

Ad	Tür	Açıklama
url	String	Resmin URL'si.

Return

CellImageBuilder: Zincirleme için kullanılan bu oluşturucu.

---

toBuilder()

Mevcut resim özelliklerine göre bir hücre resmi oluşturucu oluşturur. Yeni resmin kaynak URL'sini ayarlamak için 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