सूची के जवाबों को फ़िल्टर करें

Display &Video 360 की ज़्यादातर सेवाएं एक साथ कई आइटम वापस पाने के लिए, Video 360 API में LIST तरीका उपलब्ध कराया जाता है संसाधन. इन LIST तरीकों में, आम तौर पर filter क्वेरी पैरामीटर. एपीआई के इस्तेमाल को सिर्फ़ ऑप्टिमाइज़ करने के लिए इस पैरामीटर का इस्तेमाल करें आपकी ज़रूरत की चीज़ें फ़ेच की जा रही है.

इस गाइड में, filter पैरामीटर को असरदार तरीके से इस्तेमाल करने का तरीका बताया गया है.

फ़िल्टर स्ट्रक्चर

filter पैरामीटर की वैल्यू ऐसी स्ट्रिंग होती है जिसमें एक या एक से ज़्यादा पाबंदियां होती हैं जिसे AND या OR ऑपरेटर के साथ जोड़ा जा सकता है और इनका इस्तेमाल करके ग्रुप किया जा सकता है ब्रैकेट.

पाबंदियां {field} {operator} {value} फ़ॉर्मैट में हैं. यह रही उदाहरण:

entityStatus="ENTITY_STATUS_ACTIVE"

फ़िल्टर स्ट्रिंग में 500 से ज़्यादा वर्ण नहीं हो सकते. अगर आपकी फ़िल्टर स्ट्रिंग 500 वर्णों से ज़्यादा है, तो इनमें से कोई एक काम करें:

  • लॉजिक को एक से ज़्यादा फ़िल्टर स्ट्रिंग में बांटें और इसका इस्तेमाल करके रिसॉर्स को फिर से पाएं LIST अनुरोध अलग करें.
  • फ़िल्टर स्ट्रिंग से कुछ लॉजिक हटाएं और इसका इस्तेमाल फ़िल्टर करने के लिए करें स्थानीय रूप से संसाधनों को फिर से प्राप्त किया है.

यह पक्का करने के लिए कि लॉजिक सही तरीके से लागू किया गया है, पाबंदी वैल्यू को कोट में रैप करें.

अगर सीधे बिना LIST कॉल किए जा रहे हैं, तो अपनी फ़िल्टर स्ट्रिंग के यूआरएल को कोड में बदलें पर जाकर संपर्क फ़ॉर्म भरें और उसमें दूसरे साइट की जानकारी शामिल करें.

फ़ॉर्मैटिंग के बारे में ज़्यादा जानकारी के लिए, पाबंदियों के बीच का तर्क लेख पढ़ें आपकी क्वेरी.

फ़िल्टर किए जा सकने वाले फ़ील्ड

हर LIST तरीके के फ़िल्टर किए जा सकने वाले फ़ील्ड, तरीके के filter में मौजूद होते हैं पैरामीटर की जानकारी. ज़्यादातर मामलों में, आप किसी संसाधन के स्टैंडर्ड फ़ील्ड. कुछ मामलों में, ऐसे अतिरिक्त फ़ील्ड होते हैं जिनका इस्तेमाल किया जा सकता है इसे सिर्फ़ फ़िल्टर किया जा सकता है.

पैरामीटर की जानकारी का हर फ़ील्ड, इनमें से कम से कम एक फ़ील्ड के साथ काम करता है तुलना किए जा सकने वाले ऑपरेटर:

तुलना किए जा सकने वाले ऑपरेटर
EQUALS (=) संसाधन फ़ील्ड की वैल्यू, दी गई वैल्यू के बराबर है.

उदाहरण: entityStatus="ENTITY_STATUS_ACTIVE"
LESS THAN OR EQUAL TO (<=) संसाधन फ़ील्ड की वैल्यू, दी गई वैल्यू से कम या उसके बराबर है. अक्सर इस्तेमाल किए जाने वाले जब किसी तारीख या समय की तुलना की जाती है.

उदाहरण: updateTime<="2023-04-01T12:00:00Z"
GREATER THAN OR EQUAL TO (>=) संसाधन फ़ील्ड की वैल्यू, दी गई वैल्यू से ज़्यादा या उसके बराबर है. अक्सर इस्तेमाल किए जाने वाले जब किसी तारीख या समय की तुलना की जाती है.

उदाहरण: updateTime>="2023-03-01T12:00:00Z"
HAS (:) संसाधन फ़ील्ड के मान में दी गई वैल्यू शामिल है. अगर संसाधन फ़ील्ड स्ट्रिंग है, तो यह जांच करेगा कि दी गई वैल्यू कोई मौजूदा सबस्ट्रिंग है या नहीं. अगर रिसॉर्स फ़ील्ड एक अरे है, तो यह जांच करेगा कि अरे में दी गई जानकारी शामिल है या नहीं वैल्यू.

उदाहरण: lineItemIds:"1234"

अगर पैरामीटर के ब्यौरे में फ़ील्ड के लिए कोई ऑपरेटर तय नहीं किया गया है, तो सिर्फ़ EQUALS (=) ऑपरेटर का इस्तेमाल कर सकता है. कुछ फ़ील्ड में एक से ज़्यादा ऑपरेटर का इस्तेमाल किया जा सकता है.

फ़िल्टर किए जा सकने वाले कुछ फ़ील्ड के लिए ज़रूरी है कि किसी खास फ़ॉर्मैट के हिसाब से तुलना करने लायक वैल्यू. फ़ॉर्मैट इसके आगे दिया गया है filter पैरामीटर की जानकारी में मौजूद फ़ील्ड.

पाबंदियों के बीच लॉजिक

जवाब को छोटा या बड़ा करने के लिए, एक से ज़्यादा पाबंदियों को जोड़ा जा सकता है. LIST अनुरोध.

आम तौर पर, एक से ज़्यादा पाबंदियों को AND और OR के साथ जोड़ा जा सकता है लॉजिकल ऑपरेटर. LIST का हर तरीका यह बताता है कि वह किन ऑपरेटर के साथ काम करता है. कुछ तरीकों के लिए, filter पैरामीटर में सिर्फ़ एक पाबंदी का इस्तेमाल किया जा सकता है.

AND के साथ फ़िल्टर स्ट्रिंग बनाते समय, इन पाबंदियों को ध्यान में रखें या OR लॉजिकल ऑपरेटर:

  • AND का इस्तेमाल, पाबंदियों या पाबंदियों के ग्रुप के बीच में किया जाना चाहिए. अलग-अलग फ़ील्ड को फ़िल्टर करें या एक ही फ़ील्ड को अलग-अलग तरीके से फ़िल्टर करें. यहां दी गई हैं कुछ उदाहरण:
    • updateTime>="2023-03-01T12:00:00Z" AND entityStatus="ENTITY_STATUS_ACTIVE"
    • updateTime>="2023-03-01T12:00:00Z" AND updateTime<="2023-04-01T12:00:00Z" AND (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED")
  • OR का इस्तेमाल अलग-अलग पाबंदियों के बीच में किया जाना चाहिए. ये पाबंदियां एक जैसे फ़िल्टर के हिसाब से लगाई जाती हैं फ़ील्ड में डालें. यहां एक उदाहरण दिया गया है:
    • (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND (lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR lineItemType="LINE_ITEM_TYPE_VIDEO_DEFAULT")

  • आप पाबंदियों के दो ग्रुप को मिलाकर OR का इस्तेमाल नहीं कर सकते. कई वैल्यू का इस्तेमाल करें LIST अनुरोध, अलग-अलग फ़िल्टर वैल्यू वाले हैं. उदाहरण के लिए, LIST के लिए अलग-अलग अनुरोध सबमिट किए जा रहे हैं:

    • (lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" AND insertionOrderId="123")
    • (lineItemType="LINE_ITEM_TYPE_VIDEO_DEFAULT" AND insertionOrderId="456")

    इन्हें जोड़ने के लिए, OR ऑपरेटर का इस्तेमाल न करें:

    (lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" AND insertionOrderId="123") OR (lineItemType="LINE_ITEM_TYPE_VIDEO_DEFAULT" AND insertionOrderId="456")

  • ब्रैकेट का इस्तेमाल तब किया जा सकता है, जब उनका इस्तेमाल, पाबंदियों को फ़िल्टर स्ट्रिंग. उदाहरण के लिए, नीचे दी गई फ़िल्टर स्ट्रिंग:

    updateTime>="2023-03-01T12:00:00Z" AND entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED" OR entityStatus="ENTITY_STATUS_DRAFT"

    को ऐसे समझा जाता है:

    updateTime>="2023-03-01T12:00:00Z" AND (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED" OR entityStatus="ENTITY_STATUS_DRAFT")