Method: spreadsheets.values.batchUpdateByDataFilter

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

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

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

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

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

पैरामीटर
spreadsheetId

string

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

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

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

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

enum (ValueInputOption)

इनपुट डेटा को किस तरह इंटरप्रेट किया जाना चाहिए.
data[]

object (DataFilterValueRange)

स्प्रेडशीट पर लागू करने के लिए नई वैल्यू. अगर बताए गए DataFilter से एक से ज़्यादा रेंज मेल खाती हैं, तो उन सभी रेंज पर तय की गई वैल्यू लागू हो जाती हैं.
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 (UpdateValuesByDataFilterResponse)
    }
  ]
}
फ़ील्ड
spreadsheetId

string

वह स्प्रेडशीट जिस पर अपडेट लागू किए गए थे.
totalUpdatedRows

integer

उन पंक्तियों की कुल संख्या जिनमें पंक्ति में कम से कम एक सेल अपडेट की गई थी.
totalUpdatedColumns

integer

उन कॉलम की कुल संख्या जहां कॉलम में कम से कम एक सेल अपडेट की गई थी.
totalUpdatedCells

integer

अपडेट की गई सेल की कुल संख्या.
totalUpdatedSheets

integer

उन शीट की कुल संख्या जिनमें शीट में कम से कम एक सेल अपडेट की गई थी.
responses[]

object (UpdateValuesByDataFilterResponse)

हर रेंज के लिए जवाब अपडेट किया गया.

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

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

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

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

DataFilterValueRange

उन मानों की श्रेणी जिनकी जगह को DataFilter के ज़रिए तय किया जाता है.

जेएसओएन के काेड में दिखाना 
{
  "dataFilter": {
    object (DataFilter)
  },
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
फ़ील्ड
dataFilter

object (DataFilter)

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

enum (Dimension)

वैल्यू का मुख्य डाइमेंशन.
values[]

array (ListValue format)

लिखा जाने वाला डेटा. अगर दी गई वैल्यू, डेटा फ़िल्टर से मैच होने वाली किसी भी रेंज से ज़्यादा है, तो अनुरोध स्वीकार नहीं किया जा सकता. अगर दी गई वैल्यू, मैच होने वाली रेंज से कम हैं और सिर्फ़ तय की गई वैल्यू लिखी गई हैं, तो मैच करने वाली रेंज में मौजूद वैल्यू पर कोई असर नहीं पड़ेगा.

UpdateValuesByDataFilterResponse

स्प्रेडशीट में डेटा फ़िल्टर की मदद से, वैल्यू की रेंज अपडेट करने पर मिलने वाला रिस्पॉन्स.

जेएसओएन के काेड में दिखाना 
{
  "updatedRange": string,
  "updatedRows": integer,
  "updatedColumns": integer,
  "updatedCells": integer,
  "dataFilter": {
    object (DataFilter)
  },
  "updatedData": {
    object (ValueRange)
  }
}
फ़ील्ड
updatedRange

string

वह रेंज (A1 नोटेशन में) जिस पर अपडेट लागू किए गए थे.
updatedRows

integer

उन पंक्तियों की संख्या जिनमें पंक्ति में कम से कम एक सेल अपडेट की गई थी.
updatedColumns

integer

उन कॉलम की संख्या जिनमें कॉलम में कम से कम एक सेल अपडेट की गई थी.
updatedCells

integer

अपडेट की गई सेल की संख्या.
dataFilter

object (DataFilter)

वह डेटा फ़िल्टर जिसने अपडेट की गई रेंज को चुना है.
updatedData

object (ValueRange)

सभी अपडेट लागू होने के बाद, चुनी गई रेंज में मौजूद सेल की वैल्यू, dataFilter से मेल खाती हैं. इसे सिर्फ़ तब शामिल किया जाता है, जब अनुरोध का includeValuesInResponse फ़ील्ड true हो.