अब हम इस्तेमाल के एक सामान्य उदाहरण पर नज़र डालते हैं: कैंपेन के हिसाब से पिछले 30 दिनों की परफ़ॉर्मेंस की खास जानकारी, जिसे डिवाइस के हिसाब से सेगमेंट में बांटा गया है. इस रिपोर्ट से जुड़ी क्वेरी इस तरह है:
SELECT
campaign.name,
campaign.status,
segments.device,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
यह अनुरोध करने के लिए, ऊपर दिए गए Google Ads क्वेरी लैंग्वेज स्टेटमेंट को GoogleAdsService.SearchStream
इंटरफ़ेस में पास करें.
एचटीटीपी अनुरोध का यूआरएल
अनुरोध में, Google Ads API सर्वर के लिए इस यूआरएल पर एक एचटीटीपी पीओएसटी शामिल किया गया है:
https://googleads.googleapis.com/v17/customers/{customer_id}/googleAds:searchStream
एचटीटीपी अनुरोध का सैंपल पूरा करें
यहां ऊपर दी गई रिपोर्ट की परिभाषा का पूरा उदाहरण दिया गया है. इसके बारे में एचटीटीपी पोस्ट अनुरोध में बताया गया है.
POST /v17/customers/{customer_id}/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com User-Agent: curl Content-Type: application/json Accept: application/json Authorization: Bearer [Enter OAuth 2.0 access token here] developer-token: [Enter developerToken here] Parameters: { "query" : "SELECT campaign.name, campaign.status, segments.device, metrics.impressions, metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM campaign WHERE segments.date DURING LAST_30_DAYS" }
कोड सैंपल
पिछले सात दिनों के मेट्रिक वाले कैंपेन में खोज करने वाले कोड सैंपल के बारे में सिलसिलेवार तरीके से निर्देश देने वाला वीडियो देखें. वीडियो में इस्तेमाल किया गया कोड सैंपल, Java में लिखा गया है. हालांकि, यह प्रोसेस सभी भाषाओं के लिए एक जैसी है.