Class CellImageBuilder

CellImageBuilder

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

प्रॉपर्टी

प्रॉपर्टीटाइपब्यौरा
valueTypeValueTypeसेल इमेज की वैल्यू का टाइप, जो 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)

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

पैरामीटर

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

वापसी का टिकट

CellImage — चेन बनाने के लिए यह इमेज.

अनुमति देना

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

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

setAltTextTitle(title)

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

पैरामीटर

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

वापसी का टिकट

CellImage — चेन बनाने के लिए यह इमेज.

अनुमति देना

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

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

setSourceUrl(url)

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

पैरामीटर

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

वापसी का टिकट

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

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

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

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

वापसी का टिकट

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

अनुमति देना

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

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