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

अब हम एक सामान्य इस्तेमाल के उदाहरण पर नज़र डालते हैं: कैंपेन के हिसाब से, पिछले 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/v19/customers/{customer_id}/googleAds:searchStream

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

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

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