इस दस्तावेज़ में, स्प्रेडशीट में दिखने वाले डेटा को क्रम से लगाने और फ़िल्टर करने के लिए, फ़िल्टर इस्तेमाल करने के बारे में बताया गया है.
फ़िल्टर की मदद से, स्प्रेडशीट में दिखने वाले डेटा को क्रम से लगाया और फ़िल्टर किया जा सकता है. फ़िल्टर, स्प्रेडशीट में मौजूद डेटा की वैल्यू में बदलाव नहीं करते. फ़िल्टर का इस्तेमाल करके, जानकारी को कुछ समय के लिए छिपाया या क्रम से लगाया जा सकता है. फ़िल्टर चालू होने पर, तय किए गए फ़िल्टर के मानदंड से मेल खाने वाला डेटा नहीं दिखता. फ़िल्टर व्यू की मदद से, अलग-अलग नाम वाले फ़िल्टर सेव किए जा सकते हैं. साथ ही, ज़रूरत पड़ने पर उनके बीच स्विच किया जा सकता है.
Google Sheets API के अनुरोध में दिखाए गए डेटा को फ़िल्टर करने के लिए, DataFilter ऑब्जेक्ट का इस्तेमाल करें. ज़्यादा जानकारी के लिए, मेटाडेटा पढ़ना, लिखना, और खोजना लेख पढ़ें.
फ़िल्टर इस्तेमाल करने के उदाहरण
यहां फ़िल्टर इस्तेमाल करने के कुछ उदाहरण दिए गए हैं:
- किसी खास कॉलम के हिसाब से डेटा को क्रम से लगाना. उदाहरण के लिए, उपयोगकर्ता के रिकॉर्ड को उसके उपनाम के हिसाब से क्रम से लगाना.
- किसी खास शर्त को पूरा करने वाले डेटा को छिपाना. उदाहरण के लिए, दो साल से ज़्यादा पुराने सभी रिकॉर्ड को छिपाना.
- किसी खास वैल्यू से मेल खाने वाले डेटा को छिपाना. उदाहरण के लिए, "बंद" स्टेटस वाली सभी समस्याओं को छिपाना.
बेसिक फ़िल्टर
किसी स्प्रेडशीट के लिए
BasicFilter
ऑब्जेक्ट, डिफ़ॉल्ट फ़िल्टर होता है. यह फ़िल्टर, स्प्रेडशीट देखने वाले हर व्यक्ति के लिए लागू होता है. किसी स्प्रेडशीट की हर शीट के लिए, सिर्फ़ एक बेसिक फ़िल्टर हो सकता है
. बेसिक फ़िल्टर को साफ़ करके, उसे बंद किया जा सकता है. ऐसा करने से, स्प्रेडशीट से फ़िल्टर और उसकी सभी सेटिंग हट जाती हैं. अगर आपको वही फ़िल्टर फिर से चालू करना है, तो आपको मानदंड फिर से सेट करने होंगे.
बेसिक फ़िल्टर मैनेज करना
बेसिक फ़िल्टर सेट करने या उसे साफ़ करने के लिए, सही अनुरोध टाइप के साथ
spreadsheets.batchUpdate
तरीके का इस्तेमाल करें:
- बेसिक फ़िल्टर सेट करने के लिए,
SetBasicFilterRequestतरीके का इस्तेमाल करें. - बेसिक फ़िल्टर साफ़ करने के लिए,
ClearBasicFilterRequestतरीके का इस्तेमाल करें.
बेसिक फ़िल्टर की सूची देखने के लिए,
spreadsheets.get
तरीके का इस्तेमाल करें. साथ ही, fields यूआरएल पैरामीटर को sheets/basicFilter पर सेट करें. यह
spreadsheets.get कोड सैंपल, फ़ील्ड मास्क के साथ Google Sheets का यूआरएल दिखाता है:
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?fields=sheets/basicFilter
फ़िल्टर व्यू
A
FilterView
, नाम वाला एक फ़िल्टर होता है. इसे अपनी ज़रूरत के हिसाब से चालू और बंद किया जा सकता है. किसी शीट में, फ़िल्टर व्यू सेव किए जा सकते हैं. हालांकि, एक बार में सिर्फ़ एक फ़िल्टर व्यू लागू किया जा सकता है. किसी शीट में, बेसिक फ़िल्टर और कई फ़िल्टर व्यू, दोनों हो सकते हैं. हालांकि, एक ही डेटा रेंज पर दोनों को एक साथ लागू नहीं किया जा सकता.
फ़िल्टर व्यू इस्तेमाल करने के उदाहरण
यहां फ़िल्टर व्यू इस्तेमाल करने के कुछ उदाहरण दिए गए हैं:
- आपके पास कई अलग-अलग फ़िल्टर हैं और डेटा देखते समय, आपको उनके बीच स्विच करना है.
- आपके पास किसी स्प्रेडशीट को एडिट करने का ऐक्सेस नहीं है, लेकिन आपको उस पर फ़िल्टर लागू करना है. ऐसे में, कुछ समय के लिए इस्तेमाल किया जा सकने वाला एक फ़िल्टर व्यू बनाया जा सकता है. यह फ़िल्टर व्यू सिर्फ़ आपको दिखेगा.
आपको अपनी स्प्रेडशीट शेयर करने वाले हर व्यक्ति को डेटा अलग-अलग तरीके से दिखाना है. स्प्रेडशीट के यूआरएल में the
spreadsheetIdऔरfilterViewIdदेकर, यह तय किया जा सकता है कि कौनसा फ़िल्टर व्यू लागू करना है. इसके लिए, फ़िल्टर व्यू बनाते समय, रिस्पॉन्स में मिलेfilterViewIdका इस्तेमाल करें.यहां दिए गए कोड सैंपल में, फ़िल्टर व्यू के साथ Sheets का यूआरएल दिखाया गया है:
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0&fvid=FILTER_VIEW_ID
फ़िल्टर व्यू मैनेज करना
फ़िल्टर व्यू बनाने, डुप्लीकेट करने, उनमें बदलाव करने या उन्हें मिटाने के लिए, सही अनुरोध टाइप के साथ
spreadsheets.batchUpdate
तरीके का इस्तेमाल करें:
- फ़िल्टर व्यू बनाने के लिए,
AddFilterViewRequestतरीके का इस्तेमाल करें. - फ़िल्टर व्यू की कॉपी बनाने के लिए,
DuplicateFilterViewRequestतरीके का इस्तेमाल करें. - फ़िल्टर व्यू की प्रॉपर्टी में बदलाव करने के लिए,
UpdateFilterViewRequestतरीके का इस्तेमाल करें. - फ़िल्टर व्यू मिटाने के लिए,
DeleteFilterViewRequestतरीके का इस्तेमाल करें.
अपने सभी फ़िल्टर व्यू की सूची देखने के लिए,
spreadsheets.get
तरीके का इस्तेमाल करें. साथ ही, fields यूआरएल पैरामीटर को sheets/filterViews पर सेट करें. यह
spreadsheets.get कोड सैंपल, फ़ील्ड
मास्क के साथ Sheets का यूआरएल दिखाता है:
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?fields=sheets/filterViews
फ़िल्टर को JSON फ़ॉर्मैट में दिखाना
यहां दिए गए कोड सैंपल में,
FilterView
ऑब्जेक्ट को JSON फ़ॉर्मैट में दिखाया गया है.
BasicFilter
ऑब्जेक्ट भी इसी तरह का होता है. हालांकि, इसमें filterViewId और title फ़ील्ड नहीं होते.
साथ ही, इसमें नाम वाली रेंज का इस्तेमाल नहीं किया जा सकता.
{
"filterViewId": number,
"title": string,
"range": {
object(GridRange)
},
"namedRangeId": string,
"sortSpecs": [
{
object(SortSpec)
}
],
"criteria": {
string: {
object(FilterCriteria)
},
...
}
}
बिक्री के डेटा का सैंपल
इस दस्तावेज़ के बाकी हिस्से में, बिक्री के डेटा के इस सैंपल टेबल का रेफ़रंस दिया गया है:
| A | B | C | D | E | F | G | |
| 1 | आइटम की कैटगरी | मॉडल नंबर | लागत | मात्रा | क्षेत्र | सेल्सपर्सन | भेजने की तारीख |
| 2 | पहिया | W-24 | 20.50 डॉलर | 4 | पश्चिम | Beth | 1/3/2016 |
| 3 | दरवाज़ा | D-01X | 15.00 डॉलर | 2 | दक्षिण | Amir | 15/3/2016 |
| 4 | फ़्रेम | FR-0B1 | 34.00 डॉलर | 8 | पूर्व | Hannah | 12/3/2016 |
| 5 | पैनल | P-034 | 6.00 डॉलर | 4 | उत्तर | Devyn | 15/3/2016 |
| 6 | पैनल | P-052 | 11.50 डॉलर | 7 | पूर्व | Erik | 16/5/2016 |
| 7 | पहिया | W-24 | 20.50 डॉलर | 11 | दक्षिण | Sheldon | 30/4/2016 |
| 8 | इंजन | ENG-0161 | 330.00 डॉलर | 2 | उत्तर | Jessie | 2/7/2016 |
क्रम से लगाने की खास जानकारी
किसी फ़िल्टर में, क्रम से लगाने की कई खास जानकारी हो सकती हैं. इन खास जानकारी से यह तय होता है कि डेटा को कैसे क्रम से लगाना है. साथ ही, इन्हें तय किए गए क्रम में लागू किया जाता है.
SortSpec.dimensionIndex
एट्रिब्यूट, कॉलम का वह इंडेक्स तय करता है जिस पर क्रम से लगाने की सुविधा लागू की जानी चाहिए.
यहां दिए गए कोड सैंपल में, क्रम से लगाने की खास जानकारी दिखाई गई है:
[
{
"dimensionIndex": 3,
"sortOrder": "ASCENDING"
},
{
"dimensionIndex": 6,
"sortOrder": "ASCENDING"
}
]
बिक्री के डेटा के सैंपल पर यह खास जानकारी लागू करने पर, डेटा को पहले "मात्रा" कॉलम के हिसाब से क्रम से लगाया जाता है. इसके बाद, अगर दो लाइनों में मात्रा एक जैसी है, तो "भेजने की तारीख" के हिसाब से क्रम से लगाया जाता है.
| A | B | C | D | E | F | G | |
| 1 | आइटम की कैटगरी | मॉडल नंबर | लागत | मात्रा | क्षेत्र | सेल्सपर्सन | भेजने की तारीख |
| 2 | दरवाज़ा | D-01X | 15.00 डॉलर | 2 | दक्षिण | Amir | 15/3/2016 |
| 3 | इंजन | ENG-0161 | 330.00 डॉलर | 2 | उत्तर | Jessie | 2/7/2016 |
| 4 | पहिया | W-24 | 20.50 डॉलर | 4 | पश्चिम | Beth | 1/3/2016 |
| 5 | पैनल | P-034 | 6.00 डॉलर | 4 | उत्तर | Devyn | 15/3/2016 |
| 6 | पैनल | P-052 | 11.50 डॉलर | 7 | पूर्व | Erik | 16/5/2016 |
| 7 | फ़्रेम | FR-0B1 | 34.00 डॉलर | 8 | पूर्व | Hannah | 12/3/2016 |
| 8 | पहिया | W-24 | 20.50 डॉलर | 11 | दक्षिण | Sheldon | 30/4/2016 |
फ़िल्टर के मानदंड
FilterCriteria
ऑब्जेक्ट से यह तय होता है कि बेसिक फ़िल्टर या
फ़िल्टर व्यू में, स्प्रेडशीट का कौनसा डेटा दिखाना है या कौनसा डेटा छिपाना है. हर मानदंड, किसी खास कॉलम में मौजूद वैल्यू पर निर्भर करता है. फ़िल्टर के मानदंड, मैप के तौर पर दिए जाते हैं. इसमें कुंजियां, कॉलम के इंडेक्स होती हैं और वैल्यू, मानदंड होती हैं.
बूलियन
condition का इस्तेमाल करके तय किए गए मानदंडों के लिए,
वैल्यू दिखाने के लिए शर्त true होनी चाहिए. शर्त,
ओवरराइड
hiddenValues नहीं करती.
अगर कोई वैल्यू hiddenValues में शामिल है, तो उस वैल्यू से मेल खाने वाला सारा डेटा छिपा रहता है.
यहां दिए गए कोड सैंपल में, फ़िल्टर के मानदंडों का मैप दिखाया गया है:
{
0: {
'hiddenValues': ['Panel']
},
6: {
'condition': {
'type': 'DATE_BEFORE',
'values': {
'userEnteredValue': '4/30/2016'
}
}
}
}
बिक्री के डेटा के सैंपल पर यह मानदंड लागू करने पर, सिर्फ़ वे लाइनें दिखती हैं जिनमें "आइटम की कैटगरी" कॉलम की वैल्यू "पैनल" नहीं है. साथ ही, "भेजने की तारीख" कॉलम की वैल्यू "30 अप्रैल, 2016" से पहले की है.
| A | B | C | D | E | F | G | |
| 1 | आइटम की कैटगरी | मॉडल नंबर | लागत | मात्रा | क्षेत्र | सेल्सपर्सन | भेजने की तारीख |
| 2 | पहिया | W-24 | 20.50 डॉलर | 4 | पश्चिम | Beth | 1/3/2016 |
| 3 | दरवाज़ा | D-01X | 15.00 डॉलर | 2 | दक्षिण | Amir | 15/3/2016 |
| 4 | फ़्रेम | FR-0B1 | 34.00 डॉलर | 8 | पूर्व | Hannah | 12/3/2016 |
फ़िल्टर व्यू का कोड सैंपल
यहां दिए गए कोड सैंपल में, फ़िल्टर व्यू बनाने, उसे डुप्लीकेट करने, और फिर बिक्री के डेटा के सैंपल का इस्तेमाल करके, डुप्लीकेट किए गए वर्शन को अपडेट करने का तरीका बताया गया है.