Method: spreadsheets.values.batchGetByDataFilter

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

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

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

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

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

पैरामीटर
spreadsheetId

string

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "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 है, तो इसे अनदेखा कर दिया जाता है. तारीख और समय के लिए, रेंडर करने का डिफ़ॉल्ट विकल्प SERIAL_NUMBER है.

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

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

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

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

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

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

object (ValueRange)

DataFilter से मेल खाने वाले मान.
dataFilters[]

object (DataFilter)

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