Search Ads 360 Reporting API, मॉडर्न प्लैटफ़ॉर्म पर आधारित है और इसमें कई नए कॉन्सेप्ट शामिल किए गए हैं. इनके बारे में, नीचे दिए गए सेक्शन में बताया गया है.
संसाधन
रिपोर्ट टाइप की जगह संसाधन ऑब्जेक्ट का इस्तेमाल किया जाता है. पहले से तय रिपोर्ट टाइप का अनुरोध करने के बजाय, अब एसक्यूएल जैसी नई क्वेरी लैंग्वेज का इस्तेमाल करके सभी संसाधनों के लिए क्वेरी की जा सकती है. ज़्यादा जानने के लिए, Search Ads 360 Reporting API का स्ट्रक्चर देखें.
खोज रिपोर्टिंग
नए एपीआई में, Search की अपनी सेवा है. Search की सेवा, लेगसी रिपोर्टिंग सेवा की जगह लेगी. सभी क्वेरी, SearchAds360Service से होकर जाती हैं. यह रिपोर्टिंग डेटा और मेट्रिक को खोजने और वापस पाने के लिए, दो तरीके उपलब्ध कराता है: SearchStream और Search. खोज के दोनों तरीकों से, आपकी खोज क्वेरी से मेल खाने वाले सभी SearchAds360Row ऑब्जेक्ट दिखते हैं. ज़्यादा जानकारी के लिए, खोज रिपोर्ट बनाना लेख पढ़ें.
संसाधन का मेटाडेटा
SearchAds360FieldService
की मदद से, SearchAds360Service खोज के तरीकों में उपलब्ध संसाधनों, संसाधन फ़ील्ड, सेगमेंटेशन कुंजियों, और मेट्रिक के लिए डाइनैमिक तरीके से अनुरोध किया जा सकता है. ज़्यादा जानने के लिए, संसाधन का मेटाडेटा वापस पाना लेख पढ़ें.
फ़ील्ड के नाम
एपीआई में, डॉट नोटेशन से अलग किए गए नेस्ट किए गए फ़ील्ड के नाम शामिल हैं. उदाहरण के लिए, campaign.id और ad_group.id. इसके अलावा, नेस्टिंग की सुविधा का इस्तेमाल और भी किया जा सकता है. उदाहरण के लिए,ad_group.campaign.id. ज़्यादा जानने के लिए, Search Ads 360 Reporting API का स्ट्रक्चर देखें.
Search Ads 360 API के पिछले वर्शन में रिपोर्टिंग, एक जैसे कॉन्सेप्ट के लिए अलग-अलग इकाइयों के अलग-अलग फ़ील्ड पर आधारित होती है. उदाहरण के लिए, campaign और adgroup, दोनों रिपोर्ट में एक अलग campaignId फ़ील्ड शामिल होता है.
क्वेरी लैंग्वेज
इस एपीआई में, Search Ads 360 क्वेरी लैंग्वेज का इस्तेमाल किया जाता है. यह एसक्यूएल जैसी एक फ़्लेक्सिबल भाषा है. इसकी मदद से, ऐसी क्वेरी तय की जा सकती हैं जिनसे आपको अपने कारोबार के हिसाब से सबसे सही रिपोर्टिंग डेटा मिल सके. ज़्यादा जानने के लिए, Search Ads 360 क्वेरी लैंग्वेज देखें.
अनुरोध पाना
नए एपीआई में, खोजने की सुविधा के लिए अलग सेवा (SearchAds360Service) उपलब्ध है. हालांकि, GET
अनुरोध अब भी हर इकाई की खास सेवा पर मौजूद हैं. उदाहरण के लिए, आपको CustomColumnService से कस्टम कॉलम की जानकारी मिल सकती है.
ज़्यादा जानने के लिए, Search Ads 360 Reporting API में फ़ॉर्मैट में हुए बदलाव लेख पढ़ें.
कस्टम कॉलम
Search Ads 360 के नए वर्शन में, फ़ॉर्मूला कॉलम और कस्टम कन्वर्ज़न को कस्टम कॉलम कहा जाता है.
कस्टम कॉलम के बारे में ज़्यादा जानें.
नए CustomColumnService की मदद से, कस्टम कॉलम बनाए जा सकते हैं. ज़रूरी अनुमतियां होने पर, खाता ट्री में मौजूद किसी भी खाते के मालिकाना हक वाले CustomColumn संसाधनों का अनुरोध किया जा सकता है.
खाते का मैनेजमेंट
Search Ads 360 का नया वर्शन खातों को मैनेजर खातों, सब-मैनेजर खातों, और क्लाइंट खातों के क्रम में रखकर मैनेज करता है. मैनेजर खाते ने एजेंसी खाते की जगह ले ली है. सब-मैनेजर खातों ने Search Ads 360 के पुराने वर्शन में मौजूद विज्ञापन देने वालों के खातों की जगह ले ली है. ज़्यादा जानने के लिए, Search Ads 360 के मैनेजर खातों के बारे में जानकारी लेख पढ़ें.
खाता ट्री के बारे में क्वेरी की जा सकती है. इसके बाद, उन सभी खातों के लिए अनुरोध सबमिट किए जा सकते हैं जिनसे आपको रिपोर्टिंग डेटा चाहिए.
खाते के क्रम में बदलाव होने की वजह से, विज्ञापन देने वाले व्यक्ति या कंपनी/एजेंसी से जुड़े फ़ील्ड को सही विकल्पों से बदल दिया गया है, ताकि जहां भी संभव हो, फ़ंक्शनल समानता बनी रहे. असर डालने वाले फ़ील्ड और उनके विकल्पों की सूची देखने के लिए, फ़ील्ड मैपिंग देखें.
लॉगिन ग्राहक आईडी हेडर
login-customer-id एक नया हेडर है. सब-मैनेजर या क्लाइंट खाते को ऐक्सेस करने के लिए, मैनेजर खाते का इस्तेमाल करते समय इस हेडर का इस्तेमाल करना ज़रूरी है. ज़्यादा जानकारी के लिए, लॉगिन ग्राहक आईडी हेडर देखें.
वर्शन
Search Ads 360 Reporting API, सिमैंटिक वर्शनिंग का इस्तेमाल करता है. इसके मुख्य और छोटे वर्शन होते हैं, जिन्हें vMAJOR_MINOR के तौर पर फ़ॉर्मैट किया जाता है. ज़्यादा जानने के लिए, वर्शनिंग देखें.