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