DataFilter

यह फ़िल्टर बताता है कि अनुरोध करने पर कौनसा डेटा चुना जाना चाहिए या कौनसा डेटा वापस करना चाहिए.

JSON के काेड में दिखाना
{

  // Union field filter can be only one of the following:
  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
  // End of list of possible types for union field filter.
}
फ़ील्ड
यूनियन फ़ील्ड filter. ऐसे फ़िल्टर जो चुने गए डेटा को सीमित कर सकते हैं. filter इनमें से सिर्फ़ एक हो सकता है:
developerMetadataLookup

object (DeveloperMetadataLookup)

डेवलपर मेटाडेटा से जुड़ा ऐसा डेटा चुना जाता है जो इस DeveloperMetadataLookup में बताई गई शर्तों से मेल खाता हो.

a1Range

string

वह डेटा चुनता है जो बताई गई A1 रेंज से मेल खाता है.

gridRange

object (GridRange)

वह डेटा चुनता है जो GridRange में बताई गई रेंज से मेल खाता है.

DeveloperMetadataLookup

ऐसा DeveloperMetadata चुनता है जो बताए गए सभी फ़ील्ड से मेल खाता है. उदाहरण के लिए, अगर सिर्फ़ मेटाडेटा आईडी दिया गया है, तो यह उस खास आईडी वाले DeveloperMetadata के हिसाब से काम करता है. अगर मेटाडेटा कुंजी के बारे में बताया गया है, तो इसमें उस कुंजी वाले सभी डेवलपर मेटाडेटा को ध्यान में रखा जाता है. अगर कोई कुंजी, किसको दिखे, और जगह के टाइप जैसी सभी जानकारी दी जाती है, तो इस कुंजी के साथ-साथ उस तरह की जगह से जुड़े सभी डेवलपर मेटाडेटा को ध्यान में रखा जाता है. आम तौर पर, इसमें वे सभी DeveloperMetadata चुने जाते हैं, जो दिए गए सभी फ़ील्ड के इंटरसेक्शन से मेल खाते हैं; किसी भी फ़ील्ड या फ़ील्ड के कॉम्बिनेशन को तय किया जा सकता है.

JSON के काेड में दिखाना
{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}
फ़ील्ड
locationType

enum (DeveloperMetadataLocationType)

यह चुने गए डेवलपर मेटाडेटा को सिर्फ़ उन एंट्री तक सीमित करता है जो बताई गई जगहों से जुड़ी हैं. उदाहरण के लिए, जब इस फ़ील्ड को ROW के तौर पर बताया जाता है, तो यह लुकअप सिर्फ़ पंक्तियों से जुड़े डेवलपर मेटाडेटा के हिसाब से काम करता है. अगर फ़ील्ड को साफ़ तौर पर नहीं बताया गया है, तो सभी तरह की जगहों को ध्यान में रखा जाता है. इस फ़ील्ड को SPREADSHEET के तौर पर तब नहीं बताया जा सकता, जब locationMatchingStrategy को INTERSECTING के तौर पर बताया गया हो या जब metadataLocation को बिना स्प्रेडशीट की जगह के तौर पर बताया गया हो: स्प्रेडशीट मेटाडेटा, डेवलपर मेटाडेटा की किसी भी अन्य जगह को इंटरसेक्ट नहीं कर सकता. जब locationMatchingStrategy को EXACT के तौर पर दिया गया है, तो इस फ़ील्ड को भी नहीं बताना चाहिए.

metadataLocation

object (DeveloperMetadataLocation)

चुने गए डेवलपर मेटाडेटा को, बताई गई जगह से जुड़ी एंट्री तक सीमित करता है. यह फ़ील्ड, दिए गए locationMatchingStrategy के हिसाब से जगहों की सटीक जानकारी से मेल खाता है या उन सभी जगहों से मेल खाता है जो एक-दूसरे को काटती हैं.

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

तय करता है कि यह लुकअप, जगह से कैसे मेल खाता है. अगर इस फ़ील्ड को EXACT के तौर पर दिया गया है, तो सिर्फ़ बताई गई जगह से जुड़े डेवलपर के मेटाडेटा को ही मैच किया जाता है. अगर इस फ़ील्ड को INTERSECTING के लिए तय किया गया है, तो इंटरसेक्ट करने वाली जगहों से जुड़े डेवलपर मेटाडेटा को भी मैच किया जाता है. अगर फ़ील्ड को सेट नहीं किया जाता है, तो यह INTERSECTING की डिफ़ॉल्ट वैल्यू मान लेता है. अगर इस फ़ील्ड की जानकारी दी गई है, तो एक metadataLocation भी तय करना ज़रूरी है.

metadataId

integer

यह चुने गए डेवलपर मेटाडेटा को उस मेटाडेटा तक सीमित करता है जिसमें मिलता-जुलता DeveloperMetadata.metadata_id मौजूद है.

metadataKey

string

यह चुने गए डेवलपर मेटाडेटा को उस मेटाडेटा तक सीमित करता है जिसमें मिलता-जुलता DeveloperMetadata.metadata_key मौजूद है.

metadataValue

string

यह चुने गए डेवलपर मेटाडेटा को उस मेटाडेटा तक सीमित करता है जिसमें मिलता-जुलता DeveloperMetadata.metadata_value मौजूद है.

visibility

enum (DeveloperMetadataVisibility)

यह चुने गए डेवलपर मेटाडेटा को उस मेटाडेटा तक सीमित करता है जिसमें मिलता-जुलता DeveloperMetadata.visibility मौजूद है. अगर इसकी जानकारी नहीं दी जाती है, तो अनुरोध करने वाले प्रोजेक्ट से जुड़े सभी डेवलपर मेटाडेटा को ध्यान में रखा जाता है.

DeveloperMetadataLocationMatchingStrategy

डेवलपर मेटाडेटा की जगहों का मिलान करने के लिए रणनीतियों की सूची.

Enums
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया जाना चाहिए.
EXACT_LOCATION यह बताता है कि दी गई जगह का पूरी तरह से मेल खाना चाहिए. उदाहरण के लिए, अगर तीसरी पंक्ति को जगह के तौर पर दिखाया गया था, तो मैच करने की यह रणनीति सिर्फ़ पंक्ति तीसरी से जुड़े डेवलपर मेटाडेटा से मेल खाएगी. दूसरी जगहों से जुड़े मेटाडेटा पर विचार नहीं किया जाएगा.
INTERSECTING_LOCATION इससे पता चलता है कि किसी जगह की जानकारी, उस जगह से पूरी तरह मैच होनी चाहिए. साथ ही, वह जगह भी एक-दूसरे से मेल खानी चाहिए. उदाहरण के लिए, अगर तीसरी पंक्ति को जगह के तौर पर दिखाया गया था, तो मिलान करने की यह रणनीति, तीसरी पंक्ति से जुड़े डेवलपर मेटाडेटा से मेल खाएगी. साथ ही, यह पंक्ति तीसरी पंक्ति को काटने वाली जगहों से जुड़े मेटाडेटा से भी मेल खाएगी. उदाहरण के लिए, अगर कॉलम B में डेवलपर मेटाडेटा जुड़ा था, तो मैच करने की यह रणनीति उस जगह से भी मैच करेगी, क्योंकि कॉलम B, तीन पंक्ति को काटता है.