Method: spreadsheets.values.append

स्प्रेडशीट में वैल्यू जोड़ता है. इनपुट रेंज का इस्तेमाल, मौजूदा डेटा को खोजने और "टेबल" ढूंढने के लिए किया जाता है रेंज में शामिल करें. टेबल की अगली लाइन में वैल्यू जोड़ दी जाएंगी. इसकी शुरुआत टेबल के पहले कॉलम से होगी. टेबल का पता लगाने और डेटा जोड़ने के तरीके के बारे में खास जानकारी के लिए, गाइड और सैंपल कोड देखें.

कॉलर को स्प्रेडशीट आईडी, रेंज, और valueInputOption की जानकारी देनी होगी. valueInputOption से सिर्फ़ यह कंट्रोल किया जाता है कि इनपुट डेटा को शीट में कैसे जोड़ा जाएगा (कॉलम के हिसाब से या पंक्ति के हिसाब से). इससे इस बात पर कोई असर नहीं पड़ता कि डेटा किस सेल में लिखा जाना शुरू होगा.

एचटीटीपी अनुरोध

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

उस स्प्रेडशीट का आईडी जिसे अपडेट करना है.
range

string

डेटा की लॉजिकल टेबल खोजने के लिए, किसी रेंज का A1 नोटेशन. टेबल की आखिरी पंक्ति के बाद वैल्यू जोड़ी जाती हैं.

क्वेरी पैरामीटर

पैरामीटर
valueInputOption

enum (ValueInputOption)

इनपुट डेटा को कैसे समझा जाना चाहिए.
insertDataOption

enum (InsertDataOption)

इनपुट डेटा कैसे डाला जाना चाहिए.
includeValuesInResponse

boolean

यह तय करता है कि अपडेट रिस्पॉन्स में, जोड़ी गई सेल की वैल्यू शामिल होनी चाहिए या नहीं. डिफ़ॉल्ट रूप से, जवाबों में अपडेट की गई वैल्यू शामिल नहीं होती हैं.
responseValueRenderOption

enum (ValueRenderOption)

इससे यह तय होता है कि रिस्पॉन्स में वैल्यू कैसे रेंडर की जानी चाहिए. रेंडर करने का डिफ़ॉल्ट विकल्प FORMATTED_VALUE है.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

इससे तय होता है कि रिस्पॉन्स में तारीख, समय, और अवधि कैसे रेंडर की जानी चाहिए. अगर responseValueRenderOption, FORMATTED_VALUE है, तो इसे अनदेखा कर दिया जाता है. तारीख और समय के रेंडर होने का डिफ़ॉल्ट विकल्प SERIAL_NUMBER है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में ValueRange का उदाहरण है.

जवाब का मुख्य भाग

स्प्रेडशीट में वैल्यू की रेंज अपडेट करते समय मिलने वाला जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
फ़ील्ड
spreadsheetId

string

वह स्प्रेडशीट जिस पर अपडेट लागू किए गए थे.
tableRange

string

टेबल की वह रेंज (A1 नोटेशन में), जिसमें वैल्यू जोड़ी जा रही हैं (वैल्यू जोड़ने से पहले). अगर कोई टेबल नहीं मिलती, तो यह फ़ील्ड खाली हो जाएगा.
updates

object (UpdateValuesResponse)

लागू किए गए अपडेट के बारे में जानकारी.

अनुमति के दायरे

इनमें से किसी एक 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 नए डेटा के लिए पंक्तियां शामिल की जाती हैं.