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 है, तो इसे अनदेखा कर दिया जाता है. dateTime के लिए रेंडर करने का डिफ़ॉल्ट विकल्प 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 नए डेटा के लिए लाइनें डाली जाती हैं.