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

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

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 অনুরোধটি প্রদর্শন করে। আমরা আপনাকে আপনার নিজের অ্যাপে অনুরোধ জমা দেওয়ার জন্য ক্লায়েন্ট লাইব্রেরিগুলোর মধ্যে একটি ব্যবহার করতে উৎসাহিত করি।

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

কোডের নমুনা

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