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 के लिए क्विकस्टार्ट आज़माएं.