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

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

मेल खाने वाली वैल्यू रेंज

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

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

object (ValueRange)

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

object (DataFilter)

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