Class CellImage

CellImage

यह किसी सेल में मौजूद इमेज वैल्यू को दिखाता है. किसी सेल में इमेज जोड़ने के लिए, आपको SpreadsheetApp.newCellImage() और CellImageBuilder का इस्तेमाल करके, इमेज के लिए नई इमेज वैल्यू बनानी होगी. इसके बाद, सेल में इमेज की वैल्यू जोड़ने के लिए, Range.setValue(value) या Range.setValues(values) का इस्तेमाल किया जा सकता है.

प्रॉपर्टी

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

तरीके

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

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

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

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

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 पर होस्ट की गई इमेज का यूआरएल.

---

toBuilder()

यह मौजूदा इमेज प्रॉपर्टी के आधार पर, सेल इमेज बिल्डर बनाता है. नई इमेज का सोर्स यूआरएल सेट करने के लिए, CellImageBuilder.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