अनुरोध में दिए गए शीर्षक का इस्तेमाल करके, एक खाली दस्तावेज़ बनाता है. अनुरोध के अन्य फ़ील्ड को अनदेखा कर दिया जाता है. इनमें, उपलब्ध कराया गया कॉन्टेंट भी शामिल होता है.
बनाया गया दस्तावेज़ दिखाता है.
एचटीटीपी अनुरोध
POST https://docs.googleapis.com/v1/documents
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में यह डेटा होता है:
JSON के काेड में दिखाना |
---|
{ "documentId": string, "title": string, "tabs": [ { object ( |
फ़ील्ड | |
---|---|
documentId |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ का आईडी. |
title |
दस्तावेज़ का टाइटल. |
tabs[] |
दस्तावेज़ के हिस्से के तौर पर मौजूद टैब. टैब में चाइल्ड टैब हो सकते हैं. ये ऐसे टैब होते हैं जो किसी दूसरे टैब में नेस्ट किए जाते हैं. चाइल्ड टैब, |
revisionId |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ का रिविज़न आईडी. इसका इस्तेमाल, अपडेट के अनुरोधों में किया जा सकता है. इससे यह तय किया जा सकता है कि किसी दस्तावेज़ के किस वर्शन में अपडेट लागू करने हैं. साथ ही, यह भी तय किया जा सकता है कि अगर उस वर्शन के बाद दस्तावेज़ में बदलाव किया गया है, तो अनुरोध का क्या होगा. यह जानकारी सिर्फ़ तब दिखती है, जब उपयोगकर्ता के पास दस्तावेज़ में बदलाव करने का ऐक्सेस हो. संशोधन आईडी कोई आनुक्रमिक संख्या नहीं, बल्कि एक ओपेक स्ट्रिंग है. संशोधन आईडी का फ़ॉर्मैट समय के साथ बदल सकता है. इस बात की गारंटी है कि वापस किया गया वर्शन आईडी, वापस करने के 24 घंटे बाद तक ही मान्य रहेगा. साथ ही, इसे अन्य उपयोगकर्ताओं के साथ शेयर नहीं किया जा सकता. अगर कॉल के बीच में बदलाव आईडी नहीं बदला है, तो इसका मतलब है कि दस्तावेज़ में कोई बदलाव नहीं हुआ है. इसके उलट, एक ही दस्तावेज़ और उपयोगकर्ता के लिए बदले गए आईडी का मतलब है कि दस्तावेज़ अपडेट कर दिया गया है. हालांकि, आईडी फ़ॉर्मैट में बदलाव जैसी अंदरूनी वजहों से भी आईडी बदल सकता है. |
suggestionsViewMode |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ पर सुझावों का व्यू मोड लागू किया गया. ध्यान दें: किसी दस्तावेज़ में बदलाव करते समय, बदलाव |
body |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ का मुख्य हिस्सा. लेगसी फ़ील्ड: इसके बजाय, |
headers |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ में मौजूद हेडर, जिन्हें हेडर आईडी के हिसाब से क्रम में लगाया गया है. लेगसी फ़ील्ड: इसके बजाय, |
footers |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ में फ़ुटर, जिन्हें फ़ुटर आईडी के साथ लिखा जाता है. लेगसी फ़ील्ड: इसके बजाय, |
footnotes |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ में मौजूद फ़ुटनोट, जिन्हें फ़ुटनोट आईडी के हिसाब से क्रम में लगाया गया है. लेगसी फ़ील्ड: इसके बजाय, |
documentStyle |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ का स्टाइल. लेगसी फ़ील्ड: इसके बजाय, |
suggestedDocumentStyleChanges |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ की स्टाइल में सुझाए गए बदलाव, जिन्हें सुझाव आईडी के साथ दिखाया जाता है. लेगसी फ़ील्ड: इसके बजाय, |
namedStyles |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ की नाम वाली स्टाइल. लेगसी फ़ील्ड: इसके बजाय, |
suggestedNamedStylesChanges |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ के नाम वाले स्टाइल में सुझाए गए बदलाव, सुझाव आईडी के हिसाब से. लेगसी फ़ील्ड: इसके बजाय, |
lists |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ में मौजूद सूचियों को सूची आईडी से जोड़ा जाता है. लेगसी फ़ील्ड: इसके बजाय, |
namedRanges |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ में नाम वाली रेंज, जिन्हें नाम से जोड़ा जाता है. लेगसी फ़ील्ड: इसके बजाय, |
inlineObjects |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ में इनलाइन ऑब्जेक्ट, जिन्हें ऑब्जेक्ट आईडी के हिसाब से लिखा जाता है. लेगसी फ़ील्ड: इसके बजाय, |
positionedObjects |
सिर्फ़ आउटपुट के लिए. दस्तावेज़ में मौजूद ऑब्जेक्ट, जिन्हें ऑब्जेक्ट आईडी के हिसाब से लिखा जाता है. लेगसी फ़ील्ड: इसके बजाय, |
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Document
का नया इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.