इस पेज का अनुवाद Cloud Translation API से किया गया है.

Method: spreadsheets.values.batchUpdate

एचटीटीपी अनुरोध
पाथ पैरामीटर
अनुरोध का मुख्य हिस्सा
- JSON फ़ॉर्मैट में दिखाना
जवाब का मुख्य हिस्सा
- JSON फ़ॉर्मैट में दिखाना
अनुमति के दायरे
इसे आज़माएं!

स्प्रेडशीट की एक या इससे ज़्यादा रेंज में वैल्यू सेट करता है. कॉल करने वाले को स्प्रेडशीट आईडी, valueInputOption या एक या उससे ज़्यादा ValueRanges की जानकारी देनी होगी.

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

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

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

पाथ पैरामीटर

पैरामीटर

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

spreadsheetId

string

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

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

अनुरोध के मुख्य हिस्से में, नीचे दिए गए स्ट्रक्चर का डेटा शामिल है:

जेएसओएन के काेड में दिखाना

जेएसओएन के काेड में दिखाना
{ "valueInputOption": enum (`ValueInputOption`), "data": [ { object (`ValueRange`) } ], "includeValuesInResponse": boolean, "responseValueRenderOption": enum (`ValueRenderOption`), "responseDateTimeRenderOption": enum (`DateTimeRenderOption`) }

{
  "valueInputOption": enum (ValueInputOption),
  "data": [
    {
      object (ValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}

फ़ील्ड
`valueInputOption`	`enum (ValueInputOption)` इनपुट डेटा को कैसे समझना चाहिए.
`data[]`	`object (ValueRange)` स्प्रेडशीट में लागू की जाने वाली नई वैल्यू.
`includeValuesInResponse`	`boolean` तय करें कि अपडेट के रिस्पॉन्स में अपडेट किए गए सेल के मान शामिल होने चाहिए या नहीं. डिफ़ॉल्ट रूप से, जवाबों में अपडेट की गई वैल्यू शामिल नहीं होती हैं. `BatchUpdateValuesResponse.responses` के हर `updatedData` फ़ील्ड में अपडेट की गई वैल्यू होती हैं. यह रेंज, असल में लिखी गई रेंज से बड़ी थी. इसलिए, रिस्पॉन्स में अनुरोध की गई रेंज के साथ-साथ खाली पंक्तियों और कॉलम को छोड़कर, सभी वैल्यू शामिल होती हैं.
`responseValueRenderOption`	`enum (ValueRenderOption)` तय करता है कि रिस्पॉन्स में वैल्यू कैसे रेंडर की जानी चाहिए. रेंडर करने का डिफ़ॉल्ट विकल्प `FORMATTED_VALUE` है.
`responseDateTimeRenderOption`	`enum (DateTimeRenderOption)` तय करें कि जवाब में तारीख, समय, और कुल समय को कैसे रेंडर किया जाना चाहिए. अगर `responseValueRenderOption` `FORMATTED_VALUE` है, तो इस पर ध्यान नहीं दिया जाता. तारीख का डिफ़ॉल्ट समय `SERIAL_NUMBER` रेंडर करने का विकल्प है.

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

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

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

जेएसओएन के काेड में दिखाना

जेएसओएन के काेड में दिखाना
{ "spreadsheetId": string, "totalUpdatedRows": integer, "totalUpdatedColumns": integer, "totalUpdatedCells": integer, "totalUpdatedSheets": integer, "responses": [ { object (`UpdateValuesResponse`) } ] }

{
  "spreadsheetId": string,
  "totalUpdatedRows": integer,
  "totalUpdatedColumns": integer,
  "totalUpdatedCells": integer,
  "totalUpdatedSheets": integer,
  "responses": [
    {
      object (UpdateValuesResponse)
    }
  ]
}

फ़ील्ड
`spreadsheetId`	`string` वह स्प्रेडशीट जिस पर अपडेट लागू किए गए थे.
`totalUpdatedRows`	`integer` पंक्तियों की कुल संख्या, जहां पंक्ति में कम से कम एक सेल अपडेट किया गया था.
`totalUpdatedColumns`	`integer` कॉलम की कुल संख्या, जहां कॉलम में कम से कम एक सेल अपडेट किया गया था.
`totalUpdatedCells`	`integer` अपडेट किए गए सेल की कुल संख्या.
`totalUpdatedSheets`	`integer` शीट की कुल संख्या, जहां शीट में कम से कम एक सेल अपडेट किया गया था.
`responses[]`	`object (UpdateValuesResponse)` अनुरोध की गई रेंज के हिसाब से एक UpdateValuesResponse, अनुरोध के क्रम में.

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

इनमें से किसी एक OAuth दायरे की ज़रूरत होती है:

https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets

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