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

ज़्यादा जानकारी के लिए, अनुमति देने के लिए गाइड देखें.

InsertData विकल्प

इससे यह तय होता है कि नया डेटा डालने पर, मौजूदा डेटा कैसे बदला जाता है.

Enums
OVERWRITE नया डेटा मौजूदा इलाकों के डेटा को ओवरराइट कर देता है. (ध्यान दें: शीट के आखिर में डेटा जोड़ने पर भी नई पंक्तियां या कॉलम जुड़ जाएंगे, ताकि डेटा लिखा जा सके.)
INSERT_ROWS नए डेटा के लिए पंक्तियां शामिल की जाती हैं.