Class CellImageBuilder

CellImageBuilder

CellImage के लिए बिल्डर. यह बिल्डर, सेल में इमेज जोड़ने के लिए ज़रूरी इमेज वैल्यू बनाता है.

प्रॉपर्टी

प्रॉपर्टी	टाइप	ब्यौरा
valueType	ValueType	सेल इमेज की वैल्यू का टाइप, जो ValueType.IMAGE है.

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
build()	CellImage	यह फ़ंक्शन, इमेज वैल्यू टाइप बनाता है. इसकी मदद से, किसी सेल में इमेज जोड़ी जा सकती है.
getAltTextDescription()	String	यह फ़ंक्शन, इस इमेज के लिए वैकल्पिक लेख का ब्यौरा दिखाता है.
getAltTextTitle()	String	इस इमेज के लिए, वैकल्पिक लेख का टाइटल दिखाता है.
getContentUrl()	String	यह फ़ंक्शन, Google पर होस्ट की गई इमेज का यूआरएल दिखाता है.
setAltTextDescription(description)	CellImage	इस इमेज के लिए वैकल्पिक लेख की जानकारी सेट करता है.
setAltTextTitle(title)	CellImage	इस इमेज के लिए, वैकल्पिक लेख का टाइटल सेट करता है.
setSourceUrl(url)	CellImageBuilder	इससे इमेज के सोर्स का यूआरएल सेट होता है.
toBuilder()	CellImageBuilder	यह मौजूदा इमेज प्रॉपर्टी के आधार पर, सेल इमेज बिल्डर बनाता है.

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
getUrl()	String	इससे इमेज का सोर्स यूआरएल मिलता है.

ज़्यादा जानकारी वाला दस्तावेज़

build()

यह फ़ंक्शन, इमेज वैल्यू टाइप बनाता है. इसकी मदद से, किसी सेल में इमेज जोड़ी जा सकती है. इमेज की वैल्यू, बिल्डर में जोड़ी गई इमेज प्रॉपर्टी से बनती है. जैसे, सोर्स यूआरएल.

वापसी का टिकट

CellImage — किसी सेल में जोड़ने के लिए इमेज का प्रतिनिधित्व.

---

getAltTextDescription()

यह फ़ंक्शन, इस इमेज के लिए वैकल्पिक लेख का ब्यौरा दिखाता है.

वापसी का टिकट

String — वैकल्पिक टेक्स्ट की जानकारी.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

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

---

getAltTextTitle()

इस इमेज के लिए, वैकल्पिक लेख का टाइटल दिखाता है.

वापसी का टिकट

String — वैकल्पिक लेख का टाइटल.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

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

---

getContentUrl()

यह फ़ंक्शन, Google पर होस्ट की गई इमेज का यूआरएल दिखाता है. इस यूआरएल को अनुरोध करने वाले व्यक्ति के खाते से टैग किया जाता है. इसलिए, जिसके पास भी यह यूआरएल होता है वह इमेज को उसी तरह से ऐक्सेस करता है जैसे अनुरोध करने वाला व्यक्ति करता है. स्प्रेडशीट को शेयर करने की सेटिंग बदलने पर, इमेज का ऐक्सेस हट सकता है. यह यूआरएल, कुछ समय बाद काम नहीं करता.

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

वापसी का टिकट

String — Google पर होस्ट की गई इमेज का यूआरएल.

---

setAltTextDescription(description)

इस इमेज के लिए वैकल्पिक लेख की जानकारी सेट करता है.

पैरामीटर

नाम	टाइप	ब्यौरा
description	String	इमेज के लिए नया वैकल्पिक लेख.

वापसी का टिकट

CellImage — This image, for chaining.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

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

---

setAltTextTitle(title)

इस इमेज के लिए, वैकल्पिक लेख का टाइटल सेट करता है.

पैरामीटर

नाम	टाइप	ब्यौरा
title	String	इमेज के लिए नया वैकल्पिक लेख.

वापसी का टिकट

CellImage — This image, for chaining.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

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

---

setSourceUrl(url)

इससे इमेज के सोर्स का यूआरएल सेट होता है.

पैरामीटर

नाम	टाइप	ब्यौरा
url	String	इमेज का यूआरएल.

वापसी का टिकट

CellImageBuilder — यह बिल्डर, चेनिंग के लिए है.

---

toBuilder()

यह मौजूदा इमेज प्रॉपर्टी के आधार पर, सेल इमेज बिल्डर बनाता है. नई इमेज का सोर्स यूआरएल सेट करने के लिए, setSourceUrl(url) का इस्तेमाल करें. इसके बाद, Range.setValue(value) या Range.setValues(values) का इस्तेमाल करके, इसे किसी सेल में जोड़ा जा सकता है.

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);
}

वापसी का टिकट

CellImageBuilder — यह एक बिल्डर है. यह दी गई इमेज प्रॉपर्टी के आधार पर, इमेज वैल्यू टाइप बनाता है.

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता

getUrl()

अब सेवा में नहीं है. हाल ही में जोड़ी गई ज़्यादातर इमेज के लिए, सोर्स यूआरएल उपलब्ध नहीं है.

इससे इमेज का सोर्स यूआरएल मिलता है. अगर यूआरएल उपलब्ध नहीं है, तो यह फ़ंक्शन एक खाली स्ट्रिंग दिखाता है. नई जोड़ी गई ज़्यादातर इमेज के लिए, सोर्स यूआरएल उपलब्ध नहीं होता. इससे कोई फ़र्क़ नहीं पड़ता कि इमेज कैसे जोड़ी गई है.

वापसी का टिकट

String — अगर इमेज का सोर्स यूआरएल उपलब्ध है, तो उसे दिखाता है. अगर उपलब्ध नहीं है, तो एक खाली स्ट्रिंग दिखाता है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

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