Method: spreadsheets.getByDataFilter

दिए गए आईडी पर स्प्रेडशीट दिखाता है. कॉलर को स्प्रेडशीट आईडी बताना होगा.

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

डिफ़ॉल्ट रूप से, ग्रिड में मौजूद डेटा नहीं दिखता. ग्रिड डेटा को इन दो में से किसी एक तरीके से शामिल किया जा सकता है:

  • एचटीटीपी में fields यूआरएल पैरामीटर का इस्तेमाल करके, अपने पसंदीदा फ़ील्ड दिखाने वाला फ़ील्ड मास्क तय करें

  • includeGridData पैरामीटर को 'सही' पर सेट करें. अगर फ़ील्ड मास्क सेट किया गया है, तो includeGridData पैरामीटर को अनदेखा कर दिया जाता है

बड़ी स्प्रेडशीट के लिए, सबसे सही तरीका यह है कि आप अपनी पसंद के स्प्रेडशीट फ़ील्ड ही चुनें.

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

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

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

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

अनुरोध की जाने वाली स्प्रेडशीट.

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

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

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

object (DataFilter)

DataFilters का इस्तेमाल करके यह चुना जाता है कि स्प्रेडशीट से किन रेंज को वापस पाना है.
includeGridData

boolean

अगर ग्रिड डेटा दिया जाना चाहिए, तो सही है. अगर अनुरोध में फ़ील्ड मास्क सेट किया गया था, तो इस पैरामीटर को अनदेखा कर दिया जाता है.

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में Spreadsheet का एक इंस्टेंस शामिल किया जाता है.

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

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

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

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