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

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

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

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

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

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