Class CellImage

CellImage

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

प्रॉपर्टी

प्रॉपर्टीTypeब्यौरा
valueTypeValueTypeइमेज की वैल्यू टाइप को दिखाने वाला फ़ील्ड, ValueType.IMAGE पर सेट है.

तरीके

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

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

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 का होस्ट किया गया यूआरएल दिखाता है. यह यूआरएल, अनुरोध करने वाले के खाते से टैग किया गया है, ताकि जिस व्यक्ति के पास यूआरएल हो उसे ओरिजनल अनुरोध करने वाले व्यक्ति के तौर पर ही ऐक्सेस किया जा सके. अगर स्प्रेडशीट को शेयर करने की सेटिंग बदल जाती हैं, तो हो सकता है कि इमेज को ऐक्सेस न किया जा सके. लौटाए गए यूआरएल की समयसीमा कुछ समय बाद खत्म हो जाती है.

रिटर्न

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


getUrl()

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

रिटर्न

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

अनुमति देना

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

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

toBuilder()

ऐसा बिल्डर बनाता है जो किसी इमेज को इमेज वैल्यू टाइप में बदल देता है, ताकि आप उसे सेल में रख सकें. इमेज को सेल में रखने से पहले, उसे इमेज की वैल्यू के टाइप के तौर पर बनाना ज़रूरी है. इसके बाद, Range.setValue(value) या Range.setValues(values) का इस्तेमाल करके, इसे किसी सेल में जोड़ा जा सकता है.

रिटर्न

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