Method: spreadsheets.values.batchUpdate

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

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

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

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

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

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

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

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

JSON के काेड में दिखाना 
{
  "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 है.

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

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

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

JSON के काेड में दिखाना 
{
  "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

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