- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- InsertDataOption
- इसे आज़माएं!
स्प्रेडशीट में वैल्यू जोड़ता है. इनपुट रेंज का इस्तेमाल, मौजूदा डेटा को खोजने और उस रेंज में किसी "टेबल" को ढूंढने के लिए किया जाता है. वैल्यू, टेबल की अगली पंक्ति में जोड़ दी जाएंगी. ये वैल्यू, टेबल के पहले कॉलम से शुरू होंगी. टेबल का पता लगाने और डेटा जोड़ने के तरीके से जुड़ी खास जानकारी के लिए, गाइड और सैंपल कोड देखें.
कॉलर को स्प्रेडशीट आईडी, रेंज, और valueInputOption
की जानकारी देनी होगी. valueInputOption
सिर्फ़ यह कंट्रोल करता है कि इनपुट डेटा को शीट में कैसे जोड़ा जाएगा (कॉलम के हिसाब से या पंक्ति के हिसाब से). इससे इस बात पर कोई असर नहीं पड़ता कि डेटा किस सेल में लिखा जा रहा है.
एचटीटीपी अनुरोध
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
spreadsheetId |
अपडेट करने के लिए स्प्रेडशीट का आईडी. |
range |
डेटा की लॉजिकल टेबल खोजने के लिए, किसी रेंज का A1 नोटेशन. वैल्यू को टेबल की आखिरी लाइन के बाद जोड़ा जाता है. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
valueInputOption |
इनपुट डेटा को किस तरह इंटरप्रेट किया जाना चाहिए. |
insertDataOption |
इनपुट डेटा किस तरह डाला जाना चाहिए. |
includeValuesInResponse |
इससे तय होता है कि अपडेट के रिस्पॉन्स में, जोड़े गए सेल की वैल्यू शामिल होनी चाहिए या नहीं. डिफ़ॉल्ट रूप से, जवाबों में अपडेट की गई वैल्यू शामिल नहीं होती हैं. |
responseValueRenderOption |
इससे तय होता है कि रिस्पॉन्स में वैल्यू कैसे रेंडर की जानी चाहिए. रेंडर करने का डिफ़ॉल्ट विकल्प |
responseDateTimeRenderOption |
इससे तय होता है कि रिस्पॉन्स में मौजूद तारीख, समय, और कुल समय को कैसे रेंडर किया जाए. अगर |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में ValueRange
का उदाहरण है.
जवाब का मुख्य भाग
किसी स्प्रेडशीट में वैल्यू की रेंज अपडेट करते समय मिलने वाला रिस्पॉन्स.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
फ़ील्ड | |
---|---|
spreadsheetId |
वह स्प्रेडशीट जिस पर अपडेट लागू किए गए थे. |
tableRange |
टेबल की वह रेंज (A1 नोटेशन में) जिसमें वैल्यू जोड़ी जा रही हैं (वैल्यू जोड़ने से पहले). कोई टेबल न मिलने पर खाली है. |
updates |
लागू किए गए अपडेट के बारे में जानकारी. |
अनुमति के दायरे
इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.
InsertDataOption
यह नीति तय करती है कि नया डेटा इनपुट किए जाने पर, मौजूदा डेटा में कैसे बदलाव किया जाता है.
Enums | |
---|---|
OVERWRITE |
नया डेटा, मौजूदा डेटा की जगह ले लेता है. (ध्यान दें: शीट के आखिर में डेटा जोड़ने पर भी नई पंक्तियां या कॉलम शामिल होंगे, ताकि डेटा लिखा जा सके.) |
INSERT_ROWS |
नए डेटा के लिए लाइनें शामिल की जाती हैं. |