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'"
}