इस सेक्शन में, Google Docs API का इस्तेमाल करके दस्तावेज़ों में बदलाव करने के दौरान, आपको उन व्यवहारों और सीमाओं के बारे में जानकारी मिलती है जिन्हें समझना ज़रूरी है.
आम तौर पर, ऐसे बदलाव नहीं किए जा सकते जिनकी वजह से दस्तावेज़ में एलिमेंट का स्ट्रक्चर अमान्य हो जाए. अनुरोधों पर लागू होने वाली पाबंदियों और नियमों के लिए, documents.batchUpdate
के हर अनुरोध के तरीके की समीक्षा करें.
इन तरीकों के लिए, नीचे दिए गए सेक्शन में मुख्य नियमों के बारे में बताया गया है.
टेक्स्ट डालें
- इंप्लिसिट रूप से न्यूलाइन वाला वर्ण शामिल करने से, उस इंडेक्स पर
Paragraph
बन जाता है. नए पैराग्राफ़ की पैराग्राफ़ स्टाइल, मौजूदा इंसर्शन इंडेक्स में मौजूद पैराग्राफ़ से कॉपी की जाती है. इसमें सूचियां और बुलेट भी शामिल हैं. - टेक्स्ट को किसी मौजूदा
Paragraph
की सीमाओं के अंदर डाला जाना चाहिए. उदाहरण के लिए, टेबल के स्टार्ट इंडेक्स में टेक्स्ट नहीं डाला जा सकता. टेक्स्ट को पिछले पैराग्राफ़ में डाला जाना चाहिए. - यूनिकोड ग्राफ़ेम क्लस्टर में इंसर्शन को रोकने के लिए, एपीआई जगह की जानकारी में अपने-आप बदलाव कर सकता है. ऐसा होने पर, टेक्स्ट ग्राफ़ीम क्लस्टर के तुरंत बाद शामिल कर दिया जाता है.
- डाले गए टेक्स्ट के लिए टेक्स्ट स्टाइल अपने-आप तय होते हैं. आम तौर पर, आस-पास के टेक्स्ट की स्टाइल को बनाए रखा जाता है. आम तौर पर, डाले गए टेक्स्ट का टेक्स्ट स्टाइल, डालने के इंडेक्स से ठीक पहले के टेक्स्ट से मेल खाता है.
- डाले गए टेक्स्ट से कुछ कंट्रोल वर्ण (
U+0000-U+0008, U+000C-U+001F
) और यूनिकोड बेसिक मल्टीलिंगुअल प्लेन प्राइवेट यूज़ एरिया (U+E000-U+F8FF
) के वर्ण हटा दिए जाते हैं. - ज़्यादा जानकारी के लिए, टेक्स्ट डालना, मिटाना, और उसे एक जगह से दूसरी जगह ले जाना लेख पढ़ें.
इनलाइन इमेज डालना
- इमेज का साइज़ 50 एमबी से कम होना चाहिए. साथ ही, इमेज का रिज़ॉल्यूशन 25 मेगापिक्सल से ज़्यादा नहीं होना चाहिए. इमेज का फ़ॉर्मैट PNG, JPEG या GIF में होना चाहिए.
- दिया गया यूआरआई सार्वजनिक तौर पर उपलब्ध होना चाहिए. साथ ही, यह ज़्यादा से ज़्यादा 2 केबी का होना चाहिए.
- इमेज को किसी मौजूदा
Paragraph
की सीमाओं के अंदर डाला जाना चाहिए. उदाहरण के लिए, टेबल के स्टार्ट इंडेक्स में टेक्स्ट नहीं डाला जा सकता. - फ़ुटनोट या समीकरण में इमेज नहीं डाली जा सकतीं.
- ज़्यादा जानकारी के लिए, इनलाइन इमेज डालना लेख पढ़ें.
टेक्स्ट फ़ॉर्मैट करना
- जब किसी रेंज पर पैराग्राफ़-लेवल की फ़ॉर्मैटिंग लागू की जाती है, तो फ़ॉर्मैटिंग ऐसे किसी भी पैराग्राफ़ पर लागू होती है जो उस सीमा से कुछ हद तक या पूरी तरह ओवरलैप करता है.
- आस-पास की नई लाइनें शामिल करने के लिए, रेंज को बड़ा किया जा सकता है.
- अगर रेंज में पूरी तरह से सूची का पैराग्राफ़ है, तो पैराग्राफ़ के बिंदु को भी मैच करने वाली टेक्स्ट स्टाइल के साथ अपडेट किया जाता है.
- ज़्यादा जानकारी के लिए, टेक्स्ट फ़ॉर्मैट करना लेख पढ़ें.
पैराग्राफ में बुलेट बनाना
- यह उन सभी पैराग्राफ़ के लिए बुलेट बनाता है जो दी गई रेंज से ओवरलैप होते हैं.
- हर पैराग्राफ का नेस्टिंग लेवल, हर पैराग्राफ के पहले मौजूद लीडिंग टैब की संख्या से तय होता है.
- बुलेट बनाते समय सबसे आगे मौजूद टैब हटा दिए जाते हैं. इससे टेक्स्ट के हिस्सों के इंडेक्स बदल सकते हैं.
- अगर टारगेट पैराग्राफ़ से ठीक पहले, सूची से मैच करने वाले पैराग्राफ़ बुलेट जोड़े जाते हैं, तो पैराग्राफ़ को सूची में शामिल कर दिया जाता है.
- ज़्यादा जानकारी के लिए, सूची के साथ काम करना लेख पढ़ें.
टेक्स्ट मिटाएं
पैराग्राफ़ की सीमा को पार करने वाले टेक्स्ट को मिटाने से, पैराग्राफ़ की स्टाइल, सूचियों, पोज़िशन किए गए ऑब्जेक्ट, और बुकमार्क में बदलाव हो सकते हैं. ऐसा इसलिए, क्योंकि दो पैराग्राफ़ को मर्ज किया जाता है.
दस्तावेज़ के स्ट्रक्चर को अमान्य बनाने वाले डेटा को मिटाने की अनुमति नहीं है. मिटाने के अमान्य अनुरोधों के कुछ उदाहरण:
सरोगेट जोड़े की एक कोड यूनिट को मिटाना.
Body
,Header
,Footer
,Footnote
,TableCell
याTableOfContents
के आखिरी न्यू लाइन वर्ण को मिटाना.पूरे एलिमेंट को मिटाए बिना,
Table
,TableOfContents
याEquation
के शुरू या आखिर में मौजूद टेक्स्ट को मिटाना.एलिमेंट को मिटाए बिना,
Table
,TableOfContents
याSectionBreak
से पहले न्यूलाइन वाले वर्ण को मिटाना.टेबल की अलग-अलग पंक्तियां या सेल मिटाना. टेबल सेल में मौजूद कॉन्टेंट को मिटाया जा सकता है.
ज़्यादा जानकारी के लिए, टेक्स्ट डालना, मिटाना, और उसे एक जगह से दूसरी जगह ले जाना लेख पढ़ें.