Google Docs API की खास जानकारी

Google Docs API की मदद से, Google Docs में दस्तावेज़ बनाए जा सकते हैं और उनमें बदलाव किए जा सकते हैं.

ऐप्लिकेशन, Docs API के साथ इंटिग्रेट किए जा सकते हैं, ताकि उपयोगकर्ता और सिस्टम से मिले डेटा, दोनों से बेहतर दस्तावेज़ बनाए जा सकें. Docs API की मदद से:

  • प्रोसेस को ऑटोमेट करना
  • एक साथ कई दस्तावेज़ बनाना
  • दस्तावेज़ फ़ॉर्मैट करना
  • इनवॉइस या कॉन्ट्रैक्ट जनरेट करना
  • ऑब्जेक्ट के खास एट्रिब्यूट वापस पाना

Docs API में इस्तेमाल होने वाले सामान्य शब्दों की सूची यहां दी गई है:

दस्तावेज़ आईडी

दस्तावेज़ का यूनीक आइडेंटिफ़ायर. यह एक खास स्ट्रिंग होती है, जिसमें अक्षर, संख्याएं, और कुछ खास वर्ण होते हैं. ये वर्ण किसी दस्तावेज़ का रेफ़रंस देते हैं. साथ ही, इसे दस्तावेज़ के यूआरएल से लिया जा सकता है. दस्तावेज़ का नाम बदलने पर भी, दस्तावेज़ के आईडी में कोई बदलाव नहीं होता. आईडी ढूंढने के तरीके के बारे में ज़्यादा जानने के लिए, दस्तावेज़ आईडी देखें.

https://docs.google.com/document/d/DOCUMENT_ID/edit
एलिमेंट

दस्तावेज़ का स्ट्रक्चर. किसी दस्तावेज़ के टॉप-लेवल एलिमेंट में, Body, DocumentStyle, और List शामिल होते हैं.

Google Workspace दस्तावेज़

Google Docs जैसे Google Workspace ऐप्लिकेशन से बनाई गई फ़ाइल. Docs के लिए MIME टाइप का फ़ॉर्मैट application/vnd.google-apps.document है. MIME टाइप की सूची के लिए, Google Workspace और Google Drive के साथ काम करने वाले MIME टाइप देखें.

इंडेक्स

कॉन्टेंट बॉडी में मौजूद ज़्यादातर एलिमेंट में startIndex और endIndex प्रॉपर्टी होती हैं. ये एलिमेंट के शुरू और खत्म होने के ऑफ़सेट की जानकारी देते हैं. यह जानकारी, एलिमेंट को घेरे हुए सेगमेंट के शुरू होने के हिसाब से दी जाती है.

इनलाइन इमेज

दस्तावेज़ में टेक्स्ट के फ़्लो में दिखने वाली इमेज. यह कोई अटैचमेंट नहीं है.

नाम वाली रेंज

टेक्स्ट की एक सीधी रेंज. NamedRange, एक ही namedRangeId वाली रेंज का कलेक्शन होता है. नाम वाली रेंज की मदद से, डेवलपर किसी दस्तावेज़ के हिस्सों को, उपयोगकर्ता के तय किए गए किसी भी लेबल से जोड़ सकते हैं. इससे, बाद में उनके कॉन्टेंट को प्रोग्राम के हिसाब से पढ़ा जा सकता है या उनमें बदलाव किया जा सकता है. किसी दस्तावेज़ में, एक ही नाम वाली कई नाम वाली रेंज हो सकती हैं. हालांकि, हर नाम वाली रेंज का एक यूनीक आईडी होता है.

Segment

Body, Header, Footer या Footnote, जिनमें स्ट्रक्चरल या कॉन्टेंट एलिमेंट शामिल हों. किसी सेगमेंट में मौजूद एलिमेंट के इंडेक्स, उस सेगमेंट की शुरुआत से मेल खाते हैं.

सुझाव

ओरिजनल टेक्स्ट में बदलाव किए बिना, दस्तावेज़ में बदलाव करना. अगर दस्तावेज़ का मालिक आपके सुझावों को स्वीकार करता है, तो वे ओरिजनल टेक्स्ट को बदल देंगे.

  • Google Workspace के एपीआई का इस्तेमाल करके ऐप्लिकेशन डेवलप करने के बारे में जानने के लिए, Google Workspace पर ऐप्लिकेशन डेवलप करना लेख पढ़ें. इसमें पुष्टि करने और अनुमति देने की सुविधा के बारे में भी बताया गया है.

  • किसी दस्तावेज़ के बारे में खास जानकारी पाने के लिए, दस्तावेज़ देखें.

  • Docs API ऐप्लिकेशन को कॉन्फ़िगर और चलाने का तरीका जानने के लिए, JavaScript के लिए शुरुआती निर्देश देखें.