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

अब हम इस्तेमाल के एक सामान्य उदाहरण पर नज़र डालते हैं: कैंपेन के हिसाब से पिछले 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 में लिखा गया है. हालांकि, यह प्रोसेस सभी भाषाओं के लिए एक जैसी है.