Google Ads API में, यूनिफ़ाइड एट्रिब्यूट की जानकारी अपने-आप वापस मिलती है और मेट्रिक रिपोर्टिंग होती है मैकेनिज़्म जिसमें आपको Google Ads क्वेरी का इस्तेमाल करके क्वेरी बनाने की सुविधा मिलती है भाषा. यह ऐसी जटिल क्वेरी को चालू करता है जो अलग-अलग Google Ads खातों के लिए साइन अप करते हैं.
क्वेरी बनाने के लिए, Search
या SearchStream
में से किसी एक तरीके का इस्तेमाल किया जा सकता है.
दोनों तरीकों में एक जैसी क्वेरी का इस्तेमाल किया जाता है और एक जैसे नतीजे मिलते हैं. कॉन्टेंट बनाने
Search
तरीका,10, 000 पंक्तियों वाले तय साइज़ वाले पेजों में डेटा दिखाता है. इससे आपको
का इस्तेमाल करें. हालांकि, इससे कम कमाई में
बहुत ज़्यादा बैंडविड्थ या गैर-भरोसेमंद नेटवर्क स्थितियों, उदाहरण के लिए, किसी बड़े नेटवर्क को
नतीजे को छोटे-छोटे रिस्पॉन्स में सेट कर दिया जाता है. इन्हें तब फिर से फ़ेच किया जा सकता है जब कनेक्शन
खो गया. दूसरी ओर, SearchStream
तरीका पूरे नतीजे को स्ट्रीम करता है
एक ही रिस्पॉन्स में सेट करें, जो बल्क डेटा के लिए ज़्यादा बेहतर हो सकता है
वापस पाना.
Search
और SearchStream
, दोनों में एक ही बेस यूआरएल का इस्तेमाल किया गया है:
https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_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'" }
अगर नतीजों में 10,000 से ज़्यादा पंक्तियां हैं, तो nextPageToken
जवाब में लौटाया गया:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
इसी क्वेरी को pageToken
के साथ दोहराते हुए,
पिछला अनुरोध, नतीजों का अगला पेज फ़ेच करता है:
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_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'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
SearchStream
तरीके का इस्तेमाल करने के लिए, जो एक स्ट्रीम में सभी नतीजे दिखाता है
रिस्पॉन्स के तौर पर, यूआरएल में दिए गए सेवा के तरीके को searchStream
में बदलें
(SearchStream
को pageSize
और pageToken
की ज़रूरत नहीं है):
POST /v17/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_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'" }