Method: spreadsheets.getByDataFilter

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

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

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

  • कोई फ़ील्ड मास्क डालें, जिसमें एचटीटीपी में fields यूआरएल पैरामीटर का इस्तेमाल करके, आपकी पसंद के फ़ील्ड शामिल हों

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

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

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

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

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

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

पैरामीटर
spreadsheetId

string

अनुरोध करने के लिए स्प्रेडशीट.

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

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

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

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