Class CellImage

सेलइमेज

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

प्रॉपर्टी

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

अब काम न करने वाले तरीके

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

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

वापसी का टिकट

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

अनुमति देना

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

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