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 का उदाहरण है.

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "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 नए डेटा के लिए लाइनें शामिल की जाती हैं.