DataFilter

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

जेएसओएन के काेड में दिखाना
{

  // 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 से मिली रेंज से मेल खाने वाला डेटा चुनता है.

डेवलपर मेटाडेटा लुकअप

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

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

enum (DeveloperMetadataLocationType)

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

metadataLocation

object (DeveloperMetadataLocation)

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

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

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

metadataId

integer

चुने गए डेवलपर मेटाडेटा को उस DeveloperMetadata.metadata_id तक सीमित करता है जिससे मेल खाता है.

metadataKey

string

चुने गए डेवलपर मेटाडेटा को उस DeveloperMetadata.metadata_key तक सीमित करता है जिससे मेल खाता है.

metadataValue

string

चुने गए डेवलपर मेटाडेटा को उस DeveloperMetadata.metadata_value तक सीमित करता है जिससे मेल खाता है.

visibility

enum (DeveloperMetadataVisibility)

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

डेवलपर मेटाडेटा स्थान मिलान रणनीति

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

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