সাধারণ ব্যবহারের ক্ষেত্রে উদাহরণ

এই ইউজ কেসটি ডিভাইস অনুযায়ী বিভক্ত করে, ক্যাম্পেইন অনুসারে গত ৩০ দিনে একটি অ্যাকাউন্টের পারফরম্যান্সের সারসংক্ষেপ তুলে ধরে। এই রিপোর্টের জন্য কোয়েরিটি নিম্নরূপ:

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

এই অনুরোধটি জারি করতে, এই গুগল অ্যাডস কোয়েরি ল্যাঙ্গুয়েজ স্টেটমেন্টটি GoogleAdsService.SearchStream ইন্টারফেসে পাস করুন।

HTTP অনুরোধ URL

অনুরোধটি নিম্নলিখিত URL-এ অবস্থিত Google Ads API সার্ভারে একটি HTTP POST অনুরোধ।

https://googleads.googleapis.com/v24/customers/{customer_id}/googleAds:searchStream

আপনি যে নির্দিষ্ট গুগল অ্যাডস অ্যাকাউন্টের ডেটা কোয়েরি করতে চান, তার আইডি দিয়ে {customer_id} প্রতিস্থাপন করুন। আইডিতে হাইফেন অন্তর্ভুক্ত করবেন না। আপনি যদি কোনো সাব-অ্যাকাউন্টের ডেটা পুনরুদ্ধার করতে চান, তবে আপনাকে অবশ্যই সেই সাব-অ্যাকাউন্টের আইডি ব্যবহার করতে হবে। ম্যানেজার অ্যাকাউন্টের আইডি দিয়ে কোয়েরি করলে শুধুমাত্র সেই ম্যানেজার অ্যাকাউন্টের সরাসরি মালিকানাধীন ডেটা ফেরত আসে এবং এর সাব-অ্যাকাউন্টগুলোর ডেটা অন্তর্ভুক্ত থাকে না।

সম্পূর্ণ HTTP অনুরোধের নমুনা

এখানে এই রিপোর্ট সংজ্ঞার একটি সম্পূর্ণ উদাহরণ দেওয়া হলো, যা একটি HTTP POST অনুরোধের মধ্যে সংযুক্ত রয়েছে।

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"
}

কোডের নমুনা

গত ৭ দিনের মেট্রিক্স ব্যবহার করে ক্যাম্পেইন অনুসন্ধান করে এমন একটি কোড স্যাম্পলের ভিডিও ওয়াকথ্রু দেখুন। এই কোড স্যাম্পলটি জাভাতে লেখা, কিন্তু প্রক্রিয়াটি সব ভাষার জন্যই একই রকম।