इस्तेमाल के सामान्य उदाहरण का उदाहरण

इस इस्तेमाल के उदाहरण में, पिछले 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/v24/customers/{customer_id}/googleAds:searchStream

क्वेरी करने के लिए, {customer_id} को उस Google Ads खाते के आईडी से बदलें. आईडी में हाइफ़न शामिल न करें. अगर आपको किसी उप-खाते का डेटा पाना है, तो आपको उस उप-खाते का आईडी इस्तेमाल करना होगा. मैनेजर खाते के आईडी से क्वेरी करने पर, सिर्फ़ उस मैनेजर खाते का डेटा दिखता है. इसमें उसके उप-खातों का डेटा शामिल नहीं होता.

पूरे एचटीटीपी अनुरोध का सैंपल

यहां इस रिपोर्ट की परिभाषा का पूरा उदाहरण दिया गया है. इसे एचटीटीपी पीओएसटी अनुरोध में शामिल किया गया है.

POST /v24/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 में लिखा गया है, लेकिन यह प्रोसेस सभी लैंग्वेज के लिए एक जैसी है.