উদাহরণ

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

পূর্বশর্ত

নীচের সমস্ত নমুনাগুলি কার্ল কমান্ড ব্যবহার করে একটি ব্যাশ শেলে সহজেই অনুলিপি-এবং-পেস্টযোগ্য হতে বোঝানো হয়েছে। আপনার অন্তত একটি ক্লায়েন্ট অ্যাকাউন্ট থাকা একটি 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'