Search Ads 360 Reporting API में, एट्रिब्यूट को वापस पाने और मेट्रिक की रिपोर्टिंग के लिए एक जैसा तरीका होता है. इसकी मदद से, Search Ads 360 क्वेरी भाषा का इस्तेमाल करके क्वेरी बनाई जा सकती हैं. इससे जटिल क्वेरी चालू होती हैं, जो अलग-अलग Search Ads 360 खातों के बारे में काफ़ी डेटा दिखा सकती हैं.
क्वेरी बनाने के लिए, Search या SearchStream में से किसी एक तरीके का इस्तेमाल किया जा सकता है.
दोनों तरीके एक जैसी क्वेरी के साथ काम करते हैं और एक जैसे नतीजे दिखाते हैं. Search तरीका, पसंद के मुताबिक पेज साइज़ में डेटा दिखाता है. इससे पेजेशन का इस्तेमाल करके, नतीजों के सेट को दोहराने में मदद मिलती है. यह सुविधा, कम बैंडविड्थ या अविश्वसनीय नेटवर्क की स्थितियों में फ़ायदेमंद हो सकती है. उदाहरण के लिए, किसी बड़े नतीजे के सेट को छोटे जवाबों में सेगमेंट करने के लिए, जिन्हें कनेक्शन टूटने पर फिर से फ़ेच किया जा सकता है. दूसरी ओर, SearchStream तरीके से पूरे नतीजे के सेट को एक ही रिस्पॉन्स में स्ट्रीम किया जाता है. यह तरीका, एक साथ ज़्यादा डेटा पाने के लिए ज़्यादा असरदार हो सकता है.
Search और SearchStream, दोनों एक ही बेस यूआरएल का इस्तेमाल करते हैं:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
पेज के हिसाब से खोजने का तरीका, pageSize पैरामीटर का इस्तेमाल करता है. यह पैरामीटर, एपीआई के एक जवाब में कितने नतीजे दिखाए जाएं, यह तय करता है.
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchAds360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
अगर नतीजों में pageSize से ज़्यादा पंक्तियां हैं, तो जवाब में nextPageToken दिखता है:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
ऊपर दी गई वैल्यू के साथ pageToken जोड़कर, उसी क्वेरी को दोहराने पर, नतीजों का अगला पेज फ़ेच होता है:
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
SearchStream तरीके का इस्तेमाल करने के लिए, जो एक स्ट्रीम किए गए रिस्पॉन्स में सभी नतीजे दिखाता है, बस यूआरएल में सेवा के तरीके को बदलकर searchStream कर दें (SearchStream को pageSize और pageToken की ज़रूरत नहीं है):
POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }