উদাহরণ

এই নির্দেশিকায় ক্লায়েন্ট লাইব্রেরি ব্যবহার না করে সরাসরি REST এন্ডপয়েন্ট কল করার উদাহরণ দেওয়া আছে।

পূর্বশর্ত

নিচে দেওয়া সব নমুনা curl কমান্ড ব্যবহার করে bash শেল-এ সহজেই কপি ও পেস্ট করা যায়। আপনার একটি Search Ads 360 ম্যানেজার অ্যাকাউন্ট থাকতে হবে যাতে অন্তত একটি ক্লায়েন্ট অ্যাকাউন্ট থাকে।

গুরুত্বপূর্ণ: এই উদাহরণগুলিতে, আমরা ধরে নিচ্ছি যে আপনি এমন একজন ব্যবহারকারীর দ্বারা ক্লায়েন্ট অ্যাকাউন্ট (CUSTOMER_ID) অ্যাক্সেস করছেন যার কাছে ম্যানেজার অ্যাকাউন্টের (MANAGER_CUSTOMER_ID) অ্যাডমিনিস্ট্রেটিভ অ্যাক্সেস আছে যা সরাসরি ক্লায়েন্ট অ্যাকাউন্ট ম্যানেজ করে। আপনি যদি পরিবর্তে সরাসরি কোনও ব্যক্তিগত ক্লায়েন্ট অ্যাকাউন্ট অ্যাক্সেস করেন, তাহলে login-customer-id হেডার বাদ দিন অথবা CUSTOMER_ID-এর মতো একই ভ্যালুতে সেট করুন।

এনভায়রনমেন্ট ভেরিয়েবল

নিচে অ্যাকাউন্টের ক্রেডেনশিয়াল ও আইডি লিখুন, তারপর আপনার টার্মিনালে কপি ও পেস্ট করে পরবর্তী উদাহরণে ব্যবহৃত এনভায়রনমেন্ট ভেরিয়েবল কনফিগার করুন।

মনে রাখবেন: অনুমোদন সংক্রান্ত নির্দেশিকায় OAuth 2.0 অ্যাক্সেস টোকেন তৈরি করার নির্দেশাবলী দেওয়া আছে।

API_VERSION="0"
OAUTH2_ACCESS_TOKEN="OAUTH_ACCESS_TOKEN"
MANAGER_CUSTOMER_ID="MANAGER_CUSTOMER_ID"
CUSTOMER_ID="CUSTOMER_ID"

অতিরিক্ত ঐচ্ছিক অবজেক্ট আইডি

নিম্নলিখিত উদাহরণগুলি আগে থেকে থাকা ক্যাম্পেনের ক্ষেত্রে কাজ করে। এইসব উদাহরণে ব্যবহার করার জন্য আপনার কাছে আগে থেকে থাকা কোনও ক্যাম্পেনের আইডি থাকলে, সেটি নিচে লিখুন।

CAMPAIGN_ID=CAMPAIGN_ID

পৃষ্ঠা অনুযায়ী সার্চ

search পদ্ধতিতে পেজিনেশন ব্যবহার করা হয়, যেখানে query-এর সাথে অ্যাডজাস্ট করা যায় এমন pageSize প্যারামিটার উল্লেখ করা থাকে।

cURL

#!/bin/bash
# [START curl_command]
curl -f --request POST "https://searchads360.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/searchAds360:search" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"pageSize": 10,
"query": "
  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'
"
}'
# [END curl_command]

SA360 কোয়েরি ভাষা

  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'

স্ট্রিমিং

searchStream পদ্ধতিতে একটিমাত্র উত্তরে সব ফলাফল স্ট্রিম করা হয়, তাই pageSize ফিল্ড কাজ করে না।

cURL

#!/bin/bash
# [START curl_command]
curl -f --request POST "https://searchads360.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/searchAds360:searchStream" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'
"
}'
# [END curl_command]

SA360 কোয়েরি ল্যাঙ্গুয়েজ

  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'