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

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

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

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

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