উদাহরণ

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

পূর্বশর্ত

নিচে দেওয়া সব স্যাম্পেল curl কমান্ড ব্যবহার করে bash shell-এ সহজেই কপি-পেস্ট করা যাবে। আপনার একটি 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'