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