Method: spreadsheets.values.batchGetByDataFilter

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

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

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

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

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

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

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

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

JSON के काेड में दिखाना 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "majorDimension": enum (Dimension),
  "valueRenderOption": enum (ValueRenderOption),
  "dateTimeRenderOption": enum (DateTimeRenderOption)
}
फ़ील्ड
dataFilters[]

object (DataFilter)

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

enum (Dimension)

नतीजों के लिए इस्तेमाल किया जाने वाला मुख्य डाइमेंशन.

उदाहरण के लिए, अगर स्प्रेडशीट का डेटा: A1=1,B1=2,A2=3,B2=4 है, तो उस रेंज को चुनने और majorDimension=ROWS सेट करने पर [[1,2],[3,4]] दिखता है. वहीं, majorDimension=COLUMNS सेट करने पर [[1,3],[2,4]] दिखता है.
valueRenderOption

enum (ValueRenderOption)

आउटपुट में वैल्यू को कैसे दिखाया जाना चाहिए. रेंडर करने का डिफ़ॉल्ट विकल्प FORMATTED_VALUE है.
dateTimeRenderOption

enum (DateTimeRenderOption)

आउटपुट में तारीखों, समयों, और अवधियों को कैसे दिखाया जाना चाहिए. अगर valueRenderOption FORMATTED_VALUE है, तो इसे अनदेखा कर दिया जाता है. dateTime के लिए, रेंडर करने का डिफ़ॉल्ट विकल्प SERIAL_NUMBER है.

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

DataFilters से चुनी गई स्प्रेडशीट में, वैल्यू की एक से ज़्यादा रेंज वापस पाने पर मिलने वाला जवाब.

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

JSON के काेड में दिखाना 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (MatchedValueRange)
    }
  ]
}
फ़ील्ड
spreadsheetId

string

उस स्प्रेडशीट का आईडी जिससे डेटा वापस पाया गया था.
valueRanges[]

object (MatchedValueRange)

अनुरोध की गई वैल्यू और उनसे मैच होने वाले डेटा फ़िल्टर की सूची.

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

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

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

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

MatchedValueRange

वैल्यू की वह रेंज जो एक या उससे ज़्यादा डेटा फ़िल्टर से मैच हुई.

JSON के काेड में दिखाना 
{
  "valueRange": {
    object (ValueRange)
  },
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
फ़ील्ड
valueRange

object (ValueRange)

DataFilter से मैच होने वाली वैल्यू.
dataFilters[]

object (DataFilter)

वैल्यू की रेंज से मैच करने वाले अनुरोध का DataFilters.