इस गाइड में, अनुरोध और रिस्पॉन्स के मुख्य तरीकों के बारे में बताया गया है. ये तरीके, Google Docs API का हिस्सा हैं. साथ ही, इसमें यह भी बताया गया है कि किसी दस्तावेज़ को एक साथ कई दस्तावेज़ों में कैसे अपडेट किया जा सकता है.
Google Docs API को एचटीटीपी अनुरोध का इस्तेमाल करके या किसी भाषा के हिसाब से बनाई गई क्लाइंट लाइब्रेरी में, किसी तरीके को शुरू करके चालू किया जा सकता है. ये दोनों एक जैसे हैं.
Google Docs API, एचटीटीपी रिस्पॉन्स दिखाता है. आम तौर पर, इसमें अनुरोध के ट्रिगर होने का नतीजा शामिल होता है. अनुरोध करने के लिए क्लाइंट लाइब्रेरी का इस्तेमाल करते समय, जवाब एक भाषा के हिसाब से दिखाए जाते हैं.
अनुरोध करने के तरीके
Docs API में ये तरीके काम करते हैं:
documents.create
: Google Docs में एक खाली दस्तावेज़ बनाएं.documents.get
: दिए गए दस्तावेज़ का पूरा इंस्टेंस दिखाता है. दस्तावेज़ का कॉन्टेंट, फ़ॉर्मैटिंग, और अन्य सुविधाएं निकालने के लिए, दिखाए गए JSON को पार्स किया जा सकता है.documents.batchUpdate
: दस्तावेज़ में एक साथ बदलाव करने के लिए, बदलाव के अनुरोधों की सूची सबमिट करें और फिर बदलावों की सूची दिखाएं.
टारगेट दस्तावेज़ की जानकारी देने के लिए, documents.get
और documents.batchUpdate
तरीकों में पैरामीटर के तौर पर documentId
की ज़रूरत होती है. documents.create
तरीका, बनाए गए दस्तावेज़ का एक इंस्टेंस दिखाता है, जिसमें से documentId
को पढ़ा जा सकता है. documentId
के बारे में ज़्यादा जानकारी के लिए, दस्तावेज़ का आईडी देखें.
एक साथ कई अपडेट करना
documents.batchUpdate
तरीका, request
ऑब्जेक्ट की सूची लेता है. हर ऑब्जेक्ट में, एक अनुरोध करने के बारे में बताया जाता है. उदाहरण के लिए, किसी पैराग्राफ़ को फ़ॉर्मैट करें और फिर एक इनलाइन इमेज जोड़ें. हर अनुरोध को लागू किए जाने से पहले उसकी पुष्टि की जाती है.
साथ ही, अनुरोधों को उसी क्रम में प्रोसेस किया जाता है जिस क्रम में वे बैच रिक्वेस्ट में दिखते हैं.
एक साथ कई बदलाव करने के अनुरोध, एक साथ लागू किए जाते हैं. इसका मतलब है कि अगर कोई अनुरोध मान्य नहीं है, तो पूरा अपडेट पूरा नहीं होता और कोई भी (संभावित निर्भर) बदलाव लागू नहीं किए जाते.
documents.batchUpdate
के कुछ तरीके, लागू किए गए अनुरोधों के बारे में जानकारी के साथ जवाब देते हैं. ये मेथड, response
body दिखाते हैं. इसमें response
ऑब्जेक्ट की सूची होती है. अन्य अनुरोधों को जानकारी लौटाने और खाली
जवाब दिखाने की ज़रूरत नहीं होती. जवाब सूची में मौजूद ऑब्जेक्ट, संबंधित अनुरोध की तरह ही इंडेक्स क्रम का इस्तेमाल करते हैं.
एक साथ कई अनुरोध करने का एक लोकप्रिय पैटर्न कुछ ऐसा दिखता है:
requests = []
requests.append(first request)
requests.append(second request)
...
body = ... & requests & ...
...batchUpdate(body)
Docs API कॉल को एक साथ करने के तरीके से जुड़ी पूरी जानकारी पाने के लिए, बैच के अनुरोध के सबसे सही तरीके देखें. साथ ही, अनुरोध और जवाब के टाइप से जुड़े दस्तावेज़ documents.batchUpdate
देखें.
एक साथ कई आइटम अपडेट करने की कार्रवाइयां
बैच अपडेट करने के अनुरोध कई तरह के होते हैं. यहां अनुरोध के टाइप के बारे में बताया गया है. साथ ही, इन्हें अलग-अलग कैटगरी में बांटा गया है.
मिलते-जुलते विषय
- Google Docs दस्तावेज़ का स्ट्रक्चर
- स्ट्रक्चर में बदलाव करने के नियम और व्यवहार
- एक साथ कई अनुरोध करना