फ़िल्टर की गई रिपोर्ट

Search Ads 360 Reporting API का नया वर्शन अब उपलब्ध है. एपीआई के नए वर्शन में, कस्टम रिपोर्ट बनाने और डेटा को रिपोर्टिंग ऐप्लिकेशन और प्रोसेस में इंटिग्रेट करने की सुविधा मिलती है. Search Ads 360 Reporting API के नए वर्शन पर माइग्रेट करने और उसका इस्तेमाल करने के बारे में ज़्यादा जानें.

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

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

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

हर फ़िल्टर के हिसाब से, फ़िल्टर किए जाने वाले कॉलम, ऑपरेटर, और उन वैल्यू की सूची तय होती है जिन्हें तय किए गए कॉलम में शामिल किया जा सकता है:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]

ध्यान दें: कुछ कॉलम को फ़िल्टर नहीं किया जा सकता. 'रिपोर्ट के टाइप' रेफ़रंस में, हर कॉलम बताता है कि यह Filterable है या नहीं.

फ़िल्टर ऑपरेटर

सभी फ़िल्टर केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं. इसका मतलब है कि "www.Sprockets.com" वाला फ़िल्टर, उस कॉलम से मेल नहीं करेगा जिसमें "www.sprockets.com" शामिल हैं.

ऑपरेटर	ब्यौरा	इस्तेमाल की जा सकने वाली वैल्यू की संख्या
equals	कॉलम, तय की गई वैल्यू से पूरी तरह मेल खाना चाहिए.	1
notEquals	कॉलम, तय की गई वैल्यू से मेल नहीं खाना चाहिए.	1
in	कॉलम, फ़िल्टर की सूची में मौजूद किसी एक वैल्यू से पूरी तरह मेल खाना चाहिए. सूची डेटा टाइप (जैसे String list) के लिए मान्य नहीं है.	वैरिएबल
lessThan	कॉलम में ऐसी वैल्यू होनी चाहिए जो दी गई वैल्यू से कम हो. अगर इस फ़िल्टर को Boolean कॉलम के लिए तय किया जाता है, तो Search Ads 360 API false को 0 की न्यूमेरिक वैल्यू और true को 1 में बदल देता है. अगर आपने इस फ़िल्टर को String कॉलम के लिए तय किया है, तो एपीआई शब्दकोश के क्रम की तुलना करता है. सूची डेटा टाइप (जैसे String list) के लिए मान्य नहीं है.	1
greaterThan	कॉलम में ऐसी वैल्यू होनी चाहिए जो फ़िल्टर की सूची में मौजूद किसी एक वैल्यू से ज़्यादा हो. अगर आपने इस फ़िल्टर को Boolean कॉलम के लिए तय किया है, तो एपीआई false को 0 की संख्या वाली वैल्यू और true को 1 में बदल देता है. अगर आपने इस फ़िल्टर को String कॉलम के लिए तय किया है, तो एपीआई शब्दकोश के क्रम की तुलना करता है. सूची डेटा टाइप (जैसे String list) के लिए मान्य नहीं है.	1
lessThanOrEqual	कॉलम में ऐसी वैल्यू होनी चाहिए जो फ़िल्टर की सूची में दी गई किसी वैल्यू से कम या उसके बराबर हो. अगर आपने इस फ़िल्टर को Boolean कॉलम के लिए तय किया है, तो एपीआई false को 0 की संख्या वाली वैल्यू और true को 1 में बदल देता है. अगर आपने इस फ़िल्टर को String कॉलम के लिए तय किया है, तो एपीआई शब्दकोश के क्रम की तुलना करता है. सूची डेटा टाइप (जैसे String list) के लिए मान्य नहीं है.	1
greaterThanOrEqual	कॉलम में एक ऐसी वैल्यू होनी चाहिए जो फ़िल्टर की सूची में दी गई किसी एक वैल्यू से ज़्यादा या उसके बराबर हो. अगर आपने इस फ़िल्टर को Boolean कॉलम के लिए तय किया है, तो एपीआई false को 0 की संख्या वाली वैल्यू और true को 1 में बदल देता है. अगर आपने इस फ़िल्टर को String कॉलम के लिए तय किया है, तो एपीआई शब्दकोश के क्रम की तुलना करता है. सूची डेटा टाइप (जैसे String list) के लिए मान्य नहीं है.	1
isNull	कॉलम खाली होना चाहिए. उदाहरण के लिए, अगर किसी कीवर्ड रिपोर्ट में keywordMaxCpc कॉलम के लिए isNull तय किया जाता है, तो रिपोर्ट में सिर्फ़ वही कीवर्ड होंगे जिन्होंने मैक्स सीपीसी तय नहीं किया है.	0
isNotNull	कॉलम में कोई वैल्यू होनी चाहिए.	0
startsWith	कॉलम की शुरुआत फ़िल्टर की सूची में से किसी एक स्ट्रिंग से होनी चाहिए. सिर्फ़ String कॉलम के लिए मान्य है.	वैरिएबल
containsSubstring	कॉलम में, फ़िल्टर की सूची में बताई गई सभी स्ट्रिंग या उनमें से एक स्ट्रिंग का कुछ हिस्सा शामिल होना चाहिए. उदाहरण के लिए, containsSubstring वैल्यू वाला फ़िल्टर: ["ham", "cheese"] इस वैल्यू वाली पंक्तियां दिखाएगा: hamburger cheeseburger लेकिन इन वैल्यू वाली पंक्तियां नहीं दिखाएगा: lobster roll lettuce high amplitude (high amplitude में "h am" सबस्ट्रिंग शामिल है, लेकिन स्पेस सहित सभी वर्णों का आकलन फ़िल्टर से किया जाता है) सिर्फ़ String कॉलम के लिए मान्य है.	वैरिएबल
doesNotContainSubstring	कॉलम में फ़िल्टर की सूची में से कोई भी स्ट्रिंग नहीं होनी चाहिए. उदाहरण के लिए, doesNotContainSubstring वैल्यू वाला फ़िल्टर: ["ham", "cheese"] इस वैल्यू वाली पंक्तियां दिखाएगा: lobster roll lettuce लेकिन इन वैल्यू वाली पंक्तियां नहीं दिखाएगा: hamburger cheiseburger सिर्फ़ String कॉलम के लिए मान्य है.	वैरिएबल
containsElement	कॉलम में, फ़िल्टर की सूची में कम से कम एक वैल्यू होनी चाहिए. सिर्फ़ सूची डेटा टाइप (जैसे कि String list) वाले कॉलम के लिए मान्य है. उदाहरण के लिए, campaign रिपोर्ट में, containsElement के लिए वैल्यू वाला फ़िल्टर: ["foo", "bar"] effectiveLabels कॉलम में, फ़िल्टर करने से सिर्फ़ foo, bar या दोनों के लेबल वाले कैंपेन दिखेंगे.	वैरिएबल