तय जगह पर मौजूद इमेज को Paragraph से ऐंकर किया गया है. InlineImage के उलट, PositionedImage, Element नहीं है. इसमें कोई पैरंट या सिबलिंग Element नहीं है. इसके बजाय, इसे Paragraph या ListItem से जोड़ा जाता है. साथ ही, इसे उस ऐंकर से ऑफ़सेट के ज़रिए रखा जाता है. PositionedImage का एक आईडी होता है. इसका इस्तेमाल, इसे रेफ़र करने के लिए किया जा सकता है.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a new paragraph. const paragraph = body.appendParagraph('New paragraph to anchor the image to.'); // Get an image in Drive from its ID. const image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob(); // Add the PositionedImage with offsets (in points). const posImage = paragraph.addPositionedImage(image).setTopOffset(60).setLeftOffset(40);
तरीके
| तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
|---|---|---|
get | Blob | इस ऑब्जेक्ट में मौजूद डेटा को, बताए गए कॉन्टेंट टाइप में बदले गए ब्लॉब के तौर पर दिखाता है. |
get | Blob | इस ऑब्जेक्ट में मौजूद डेटा को blob के तौर पर दिखाओ. |
get | Integer | इस तरीके से, इमेज की ऊंचाई पिक्सेल में मिलती है. |
get | String | इससे इमेज का आईडी मिलता है. |
get | Positioned | यह एक ऐसी enum वैल्यू दिखाता है जिससे पता चलता है कि इमेज को कैसे लेआउट किया गया है. |
get | Number | यह पैराग्राफ़ की बाईं ओर से इमेज के ऑफ़सेट को पॉइंट में दिखाता है. |
get | Paragraph | इससे उस Paragraph का पता चलता है जिससे इमेज को ऐंकर किया गया है. |
get | Number | यह पैराग्राफ़ के सबसे ऊपर से इमेज के ऑफ़सेट को पॉइंट में दिखाता है. |
get | Integer | यह इमेज की चौड़ाई को पिक्सल में दिखाता है. |
set | Positioned | इस विकल्प का इस्तेमाल करके, इमेज की ऊंचाई को पिक्सल में सेट किया जाता है. |
set | Positioned | इससे इमेज के लेआउट की परिभाषा सेट होती है. |
set | Positioned | इससे पैराग्राफ़ की बाईं ओर से इमेज का ऑफ़सेट पॉइंट में सेट होता है. |
set | Positioned | यह विकल्प, इमेज के ऑफ़सेट को पॉइंट में सेट करता है. यह ऑफ़सेट, पैराग्राफ़ के सबसे ऊपर से होता है. |
set | Positioned | इससे इमेज की चौड़ाई पिक्सल में सेट होती है. |
ज़्यादा जानकारी वाला दस्तावेज़
getAs(contentType)
इस ऑब्जेक्ट में मौजूद डेटा को, बताए गए कॉन्टेंट टाइप में बदले गए ब्लॉब के तौर पर दिखाता है. इस तरीके से, फ़ाइल के नाम में सही एक्सटेंशन जुड़ जाता है. उदाहरण के लिए, "myfile.pdf". हालांकि, यह मानता है कि फ़ाइल नाम का वह हिस्सा जो आखिरी अवधि के बाद आता है (अगर कोई हो), एक मौजूदा एक्सटेंशन है जिसे बदला जाना चाहिए. इसलिए, "ShoppingList.12.25.2014" बदलकर "ShoppingList.12.25.pdf" हो जाता है.
कन्वर्ज़न के लिए रोज़ाना के कोटा देखने के लिए, Google की सेवाओं के लिए कोटा देखें. नए Google Workspace डोमेन पर, कुछ समय के लिए ज़्यादा पाबंदियां लागू हो सकती हैं.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
content | String | जिस MIME टाइप में बदलना है. ज़्यादातर ब्लॉब के लिए, 'application/pdf' ही मान्य विकल्प है. BMP, GIF, JPEG या PNG फ़ॉर्मैट में मौजूद इमेज के लिए, 'image/bmp', 'image/gif', 'image/jpeg' या 'image/png' में से कोई भी एक मान्य है. Google Docs दस्तावेज़ के लिए, 'text/markdown' भी मान्य है. |
वापसी का टिकट
Blob — डेटा को एक बड़े बाइनरी ऑब्जेक्ट के तौर पर दिखाया जाता है.
getBlob()
इस ऑब्जेक्ट में मौजूद डेटा को blob के तौर पर दिखाओ.
वापसी का टिकट
Blob — डेटा को एक बड़े बाइनरी ऑब्जेक्ट के तौर पर दिखाया जाता है.
getHeight()
इस तरीके से, इमेज की ऊंचाई पिक्सेल में मिलती है.
वापसी का टिकट
Integer — पिक्सल में इमेज की ऊंचाई
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getId()
इससे इमेज का आईडी मिलता है.
वापसी का टिकट
String — इमेज आईडी
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getLayout()
यह एक ऐसी enum वैल्यू दिखाता है जिससे पता चलता है कि इमेज को कैसे लेआउट किया गया है.
वापसी का टिकट
PositionedLayout — इमेज का लेआउट
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getLeftOffset()
यह पैराग्राफ़ की बाईं ओर से इमेज के ऑफ़सेट को पॉइंट में दिखाता है.
वापसी का टिकट
Number — इमेज को पैराग्राफ़ के बाईं ओर से ऑफ़सेट किया गया है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getParagraph()
इससे उस Paragraph का पता चलता है जिससे इमेज को ऐंकर किया गया है.
वापसी का टिकट
Paragraph — पैरंट पैराग्राफ़
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getTopOffset()
यह पैराग्राफ़ के सबसे ऊपर से इमेज के ऑफ़सेट को पॉइंट में दिखाता है.
वापसी का टिकट
Number — इमेज को पैराग्राफ़ के सबसे ऊपर बाईं ओर से ऑफ़सेट किया गया है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getWidth()
यह इमेज की चौड़ाई को पिक्सल में दिखाता है.
वापसी का टिकट
Integer — इमेज की चौड़ाई, पिक्सल में
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setHeight(height)
इस विकल्प का इस्तेमाल करके, इमेज की ऊंचाई को पिक्सल में सेट किया जाता है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
height | Integer | इमेज की ऊंचाई, पिक्सल में |
वापसी का टिकट
PositionedImage — मौजूदा ऑब्जेक्ट
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setLayout(layout)
इससे इमेज के लेआउट की परिभाषा सेट होती है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
layout | Positioned | लेआउट मोड दिखाने वाला enum |
वापसी का टिकट
PositionedImage — यह ऑब्जेक्ट, चेनिंग के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setLeftOffset(offset)
इससे पैराग्राफ़ की बाईं ओर से इमेज का ऑफ़सेट पॉइंट में सेट होता है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
offset | Number | पैराग्राफ़ के बाईं ओर से ऑफ़सेट |
वापसी का टिकट
PositionedImage — यह ऑब्जेक्ट, चेनिंग के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setTopOffset(offset)
यह विकल्प, इमेज के ऑफ़सेट को पॉइंट में सेट करता है. यह ऑफ़सेट, पैराग्राफ़ के सबसे ऊपर से होता है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
offset | Number | पैराग्राफ़ के सबसे ऊपर से ऑफ़सेट |
वापसी का टिकट
PositionedImage — यह ऑब्जेक्ट, चेनिंग के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setWidth(width)
इससे इमेज की चौड़ाई पिक्सल में सेट होती है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
width | Integer | इमेज की चौड़ाई, पिक्सल में |
वापसी का टिकट
PositionedImage — मौजूदा ऑब्जेक्ट
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents