किसी सेल में जोड़ने के लिए इमेज दिखाता है. किसी सेल में इमेज जोड़ने के लिए, आपको SpreadsheetApp.newCellImage() और CellImageBuilder का इस्तेमाल करके इमेज के लिए नई वैल्यू बनानी होगी. इसके बाद, सेल में इमेज की वैल्यू जोड़ने के लिए Range.setValue(value) या Range.setValues(values) का इस्तेमाल करें.
प्रॉपर्टी
| प्रॉपर्टी | Type | ब्यौरा |
|---|---|---|
valueType | ValueType | इमेज की वैल्यू टाइप को दिखाने वाला फ़ील्ड, 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 — ऐसा बिल्डर जो इमेज की दी गई प्रॉपर्टी के आधार पर, इमेज की वैल्यू का टाइप बनाता है.