Ad Manager REST API, List तरीकों से फ़िल्टर करने की सुविधा देता है. फ़िल्टर स्ट्रिंग
सिंटैक्स को औपचारिक तौर पर EBNF
व्याकरण में बताया जाता है.
शुरू करने के लिए, यहां इस्तेमाल के कुछ सामान्य उदाहरण दिए गए हैं.
| उदाहरण | मतलब |
|---|---|
orders.updateTime > "2024-01-01T00:00:00-5:00" |
ईस्टर्न स्टैंडर्ड टाइमज़ोन के हिसाब से, 1 जनवरी, 2024 के बाद updateTime के साथ ऑर्डर की सूची बनाता है |
lineItems.targeting.geoTargeting.targetedGeoIds:2840 |
यह सूची में, जगह के हिसाब से टारगेट करने वाले ऐसे लाइन आइटम की सूची होती है जिसमें अमेरिका (जियो टारगेट आईडी 2480) शामिल है |
lineItems.displayName = "*_interstitial" |
यह डायलॉग बॉक्स, उन लाइन आइटम की सूची बनाता है जिनका डिसप्ले नेम, _interstitial स्ट्रिंग से खत्म होता है |
orders.displayName = "*video*" |
यह ऐसे ऑर्डर की सूची बनाता है जिनका डिसप्ले नेम video स्ट्रिंग होता है |
displayName:"video" |
यह ऐसे ऑर्डर की सूची बनाता है जिनका डिसप्ले नेम, video स्ट्रिंग (वैकल्पिक सिंटैक्स) वाला होता है |
लिटरल वैल्यू
सिर्फ़ लिटरल वैल्यू (उदाहरण: 42, Hugo) वह वैल्यू होती है जिसका मैच करना है.
अकेले दिखाई देने वाले लिटरल संसाधन पर काम करने वाले सभी फ़ील्ड के साथ अस्पष्ट मिलान करते हैं. संसाधन का दस्तावेज़, list तरीके से मैच करने के लिए किन फ़ील्ड का इस्तेमाल किया जाता है. Ad Manager यूज़र इंटरफ़ेस (यूआई) में इस सुविधा की यूनिवर्सल सर्च की तुलना की जा सकती है. हालांकि, इसकी तुलना में सिर्फ़ एक तरह का संसाधन इस्तेमाल किया जा सकता है.
स्ट्रिंग की लिटरल वैल्यू जिनमें स्पेस हों, उन्हें डबल कोट में रैप करना चाहिए
(उदाहरण: "Foo bar"). स्ट्रिंग की लिटरल वैल्यू को रैप करने के लिए, सिंगल कोट का इस्तेमाल नहीं किया जा सकता.
लॉजिकल ऑपरेटर
Ad Manager REST API, बाइनरी ऑपरेटर AND और OR के साथ काम करता है.
| ऑपरेटर | उदाहरण | मतलब |
|---|---|---|
AND |
a AND b |
अगर a और b सही हैं, तो वैल्यू 'सही' होगी. |
OR |
a OR b OR c |
अगर a, b, c में से कोई भी सही है, तो वैल्यू 'सही' होगी. |
नेगेशन ऑपरेटर
Ad Manager REST API, NOT और - ऑपरेटर उपलब्ध कराता है.
इनका इस्तेमाल एक-दूसरे की जगह पर किया जा सकता है.
| ऑपरेटर | उदाहरण | मतलब |
|---|---|---|
NOT |
NOT a |
अगर a सही नहीं है, तो सही. |
- |
-a |
अगर a सही नहीं है, तो सही. |
कंपैरिज़न ऑपरेटर
Ad Manager REST API, स्ट्रिंग, न्यूमेरिक, टाइमस्टैंप, और अवधि वाले फ़ील्ड के लिए, बाइनरी कंपैरिज़न ऑपरेटर
=, !=, <, >, <=, और >= के साथ काम करता है.
| ऑपरेटर | उदाहरण | मतलब |
|---|---|---|
= |
a = true |
अगर a सही है, तो सही. |
!= |
a != 42 |
जब तक a 42 के बराबर न हो, तब तक सही. |
< |
a < 42 |
अगर a 42 से कम का कोई संख्यात्मक मान है, तो सही. |
> |
a > "foo" |
अगर "foo" के बाद a को लेक्सिकली ऑर्डर किया गया है, तो वैल्यू 'सही' होगी. |
<= |
a <= "foo" |
अगर a "foo" है या इससे पहले का शब्द 'सही' है, तो वैल्यू 'सही' होगी. |
>= |
a >= 42 |
अगर a, 42 या उससे ज़्यादा का संख्यात्मक मान है, तो सही. |
फ़िल्टर को क्वेरी स्ट्रिंग के तौर पर स्वीकार किया जाता है. इसलिए, स्ट्रिंग को पूरी तरह से टाइप की गई वैल्यू में बदलने के लिए कन्वर्ज़न टाइप होता है:
- स्ट्रिंग में डबल कोट होने चाहिए. उदाहरण:
"Foo bar". - Enum, enum की स्ट्रिंग दिखाने की उम्मीद करते हैं (केस-सेंसिटिव).
- बूलियन को
trueऔरfalseलिटरल वैल्यू चाहिए होती हैं. - संख्याएं, स्टैंडर्ड पूर्णांक या फ़्लोट निरूपण की उम्मीद करती हैं. फ़्लोट के लिए, घातांकों का
इस्तेमाल किया जा सकता है. उदाहरण:
2.997e9. - अवधि में एक संख्यात्मक निरूपण के बाद एक
sसफ़िक्स (सेकंड के लिए) होना चाहिए. उदाहरण:"20s","1.2s". - टाइमस्टैंप के लिए, फ़ॉर्मैट की गई RFC-3339 स्ट्रिंग की ज़रूरत होती है.
उदाहरण:
"2012-04-21T11:30:00-04:00". यूटीसी ऑफ़सेट इस्तेमाल किए जा सकते हैं.
वाइल्डकार्ड
बराबरी के लिए स्ट्रिंग की तुलना करते समय, Ad Manager REST API * वर्ण का इस्तेमाल करके वाइल्डकार्ड का इस्तेमाल करता है.
| उदाहरण | मतलब |
|---|---|
a = "*.foo" |
अगर a के आखिर में ".foo" आता है, तो वैल्यू 'सही' होगी. |
ट्रैवर्सल ऑपरेटर
Ad Manager REST API, . ऑपरेटर के साथ काम करता है. इससे किसी मैसेज, मैप या स्ट्रक्चर के ज़रिए ट्रैवर्सल करने की जानकारी मिलती है.
| उदाहरण | मतलब |
|---|---|
a.b = true |
अगर a में बूलियन b फ़ील्ड सही है, तो सही. |
a.b > 42 |
अगर a में b फ़ील्ड की संख्या 42 से ज़्यादा है, तो वैल्यू 'सही' होगी. |
a.b.c = "foo" |
अगर a.b में "foo" स्ट्रिंग c फ़ील्ड है, तो वैल्यू 'सही' होगी. |
ट्रैवर्सल को, संसाधन में मौजूद फ़ील्ड के नामों का इस्तेमाल करके लिखा जाता है. अलग-अलग सेवाएं ट्रैवर्सल के लिए इस्तेमाल किए जा सकने वाले फ़ील्ड का सबसेट तय कर सकती हैं.
ऑपरेटर है
Ad Manager REST API, : ऑपरेटर के साथ काम करता है, जिसका मतलब है "है".
इसका इस्तेमाल कलेक्शन (दोहराए गए फ़ील्ड या मैप), मैसेज, और स्ट्रिंग के साथ किया जा सकता है. साथ ही, यह हर मामले में थोड़ा अलग तरीके से काम करता है.
स्ट्रिंग फ़ील्ड की क्वेरी करके पता लगाता है कि स्ट्रिंग में कोई मिलती-जुलती सबस्ट्रिंग है या नहीं:
| उदाहरण | मतलब |
|---|---|
r.displayName:"_250x250" |
अगर स्ट्रिंग फ़ील्ड r.displayName में _250x250 सबस्ट्रिंग है, तो वैल्यू 'सही' होगी. |
दोहराई गई फ़ील्ड क्वेरी से पता चलता है कि दोहराए गए स्ट्रक्चर में मिलता-जुलता एलिमेंट है या नहीं:
| उदाहरण | मतलब |
|---|---|
r:42 |
अगर r में 42 हो, तो सही. |
r.foo:42 |
अगर r में e.foo = 42 जैसा कोई एलिमेंट e है, तो सही है. |
Maps, निर्देशों, और मैसेज में किसी फ़ील्ड की मौजूदगी या किसी खास वैल्यू के बारे में क्वेरी की जा सकती है:
| उदाहरण | मतलब |
|---|---|
m:foo |
अगर m में "foo" कुंजी है, तो सही. |
m.foo:* |
अगर m में "foo" कुंजी है, तो सही. |
m.foo:42 |
अगर m.foo 42 है, तो सही है. |
मैसेज ट्रैवर्स करते समय, किसी फ़ील्ड को सिर्फ़ तब मौजूद माना जाता है, जब उसकी वैल्यू नॉन-डिफ़ॉल्ट हो.
सीमाएं
अलग-अलग सेवाएं, यहां बताई गई जानकारी के अलावा, फ़िल्टर क्वेरी के लिए स्ट्रक्चर या सीमाएं तय कर सकती हैं.
क्रम
Ad Manager REST API, List तरीकों का इस्तेमाल करके ऑर्डर करने की सुविधा देता है. orderBy फ़ील्ड का सिंटैक्स, कॉमा लगाकर अलग की गई फ़ील्ड के नामों की सूची होती है. उदाहरण के लिए:
"foo,bar".
क्रम से लगाने का डिफ़ॉल्ट क्रम बढ़ते क्रम में है. किसी फ़ील्ड को घटते हुए क्रम में दिखाने के लिए, " desc" सफ़िक्स जोड़ें. उदाहरण के लिए: "foo desc, bar".
सिंटैक्स में अतिरिक्त स्पेस वर्णों को अनदेखा कर दिया जाता है. "foo, bar desc", " foo , bar desc ", और "foo,bar desc" सभी वैल्यू एक जैसी हैं.
सबफ़ील्ड को ट्रैवर्सल ऑपरेटर के साथ दिखाया जाता है. उदाहरण
के लिए: foo.bar या address.street.