উদাহরণ

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

পূর্বশর্ত

নীচের সমস্ত নমুনাগুলি কার্ল কমান্ড ব্যবহার করে একটি ব্যাশ শেলে সহজেই অনুলিপি-এবং-পেস্টযোগ্য হতে বোঝানো হয়েছে। আপনার অন্তত একটি ক্লায়েন্ট অ্যাকাউন্ট থাকা একটি Search Ads 360 ম্যানেজার অ্যাকাউন্টের প্রয়োজন হবে।

পরিবেশ পরিবর্তনশীল

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

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'