Method: spreadsheets.values.batchUpdate

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
spreadsheetId

string

अपडेट करने के लिए स्प्रेडशीट का आईडी.

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

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "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)

अनुरोध की गई हर रेंज के लिए, एक UpdateValuesResponse, उसी क्रम में जिस क्रम में अनुरोध किए गए थे.

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

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

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

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