- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- 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
ज़्यादा जानकारी के लिए, अनुमति देने के लिए गाइड देखें.
InsertData विकल्प
इससे यह तय होता है कि नया डेटा डालने पर, मौजूदा डेटा कैसे बदला जाता है.
Enums | |
---|---|
OVERWRITE |
नया डेटा मौजूदा इलाकों के डेटा को ओवरराइट कर देता है. (ध्यान दें: शीट के आखिर में डेटा जोड़ने पर भी नई पंक्तियां या कॉलम जुड़ जाएंगे, ताकि डेटा लिखा जा सके.) |
INSERT_ROWS |
नए डेटा के लिए पंक्तियां शामिल की जाती हैं. |