এই নির্দেশিকায় পরিষেবা অ্যাকাউন্ট দিয়ে কীভাবে Google Ads API অ্যাক্সেস করবেন সেই বিষয়ে আলোচনা করা হয়েছে।
পরিষেবা অ্যাকাউন্ট হল এমন একটি অ্যাকাউন্ট যা কোনও স্বতন্ত্র ব্যবহারকারীর পরিবর্তে আপনার অ্যাপের সাথে সম্পর্কিত। পরিষেবা অ্যাকাউন্ট OAuth 2.0 ফ্লো ব্যবহার করে যার জন্য মানুষের অনুমোদনের প্রয়োজন হয় না, পরিবর্তে একটি কী ফাইল ব্যবহার করে যা শুধুমাত্র আপনার অ্যাপ অ্যাক্সেস করতে পারে।
পরিষেবা অ্যাকাউন্ট ব্যবহার করলে দুটি প্রধান সুবিধা পাওয়া যায়:
Google Ads অ্যাকাউন্টে Google Ads API অ্যাক্সেসের অনুমোদন কনফিগারেশন স্টেপ হিসেবে করা হয়, যা Google Ads UI-এর মাধ্যমে অফার করা অনুমোদন ও অ্যাকাউন্ট ম্যানেজমেন্ট ফিচারের সুবিধা নেয়। এর ফলে OAuth 2.0 ফ্লো তৈরি করা এবং ব্যবহারকারীর ইন্টার্যাকশন, ব্যবহারকারীর ক্রেডেনশিয়াল সেভ করা ও টোকেন ম্যানেজমেন্টের মতো জটিলতা মোকাবেলা করার প্রয়োজন হয় না বলে ডেভেলপারদের পরিশ্রম কমে যায়।
Google Ads অ্যাকাউন্ট অ্যাক্সেস করার অনুমোদন কোনও ব্যবহারকারীর ব্যক্তিগত ক্রেডেনশিয়ালের সাথে যুক্ত নয়। এর ফলে, যে কর্মচারী অ্যাক্সেসের অনুমোদন দিয়েছিলেন তিনি টিম বা কোম্পানি ছেড়ে চলে গেলেও, এই অনুমোদন বজায় রাখা সম্ভব হয়।
অ্যাকাউন্ট অ্যাক্সেস সেট-আপ করা
পরিষেবা অ্যাকাউন্ট ও ক্রেডেনশিয়াল তৈরি করার মাধ্যমে শুরু করুন।
JSON ফর্ম্যাটে পরিষেবা অ্যাকাউন্ট কী ডাউনলোড করুন এবং পরিষেবা অ্যাকাউন্ট আইডি ও ইমেল নোট করুন।
অ্যাডমিনিস্ট্রেটর হিসেবে আপনার Google Ads অ্যাকাউন্টে সাইন-ইন করুন। অ্যাডমিন > অ্যাক্সেস ও নিরাপত্তা বিকল্পে নেভিগেট করুন।
ব্যবহারকারী ট্যাবের মধ্যে + বোতামে ক্লিক করুন।
ইমেল ইনপুট বক্সে পরিষেবা অ্যাকাউন্টের ইমেল আইডি টাইপ করুন। অ্যাকাউন্ট অ্যাক্সেসের উপযুক্ত লেভেল বেছে নিন (মনে রাখবেন, পরিষেবা অ্যাকাউন্ট শুধুমাত্র ইমেল অ্যাক্সেস লেভেল কাজ করে না) এবং অ্যাকাউন্ট যোগ করুন বোতামে ক্লিক করুন।
পরিষেবা অ্যাকাউন্টকে অ্যাক্সেস দেওয়া হয়।
ঐচ্ছিক: ডিফল্ট হিসেবে, আপনি কোনও পরিষেবা অ্যাকাউন্টে অ্যাডমিনিস্ট্রেটর অ্যাক্সেস দিতে পারবেন না। ন্যূনতম বিশেষ অধিকারের নীতি অনুসরণ করুন এবং আপনার API কলের জন্য প্রয়োজন হলেই শুধুমাত্র অ্যাডমিনিস্ট্রেটর অ্যাক্সেস দিন। আপনি নিম্নলিখিত উপায়ে অ্যাক্সেস আপগ্রেড করতে পারবেন:
- অ্যাক্সেস লেভেল কলামে, পরিষেবা অ্যাকাউন্টের অ্যাক্সেস লেভেলের পাশে থাকা ড্রপ-ডাউন তীরচিহ্নে ক্লিক করুন।
- ড্রপডাউন তালিকা থেকে অ্যাডমিন বিকল্প বেছে নিন।
ক্লায়েন্ট লাইব্রেরি কনফিগারেশন
আপনার ক্লায়েন্ট লাইব্রেরি কীভাবে কনফিগার করবেন সেই সংক্রান্ত নির্দেশাবলীর জন্য
আপনার প্রোগ্রামিং ল্যাঙ্গুয়েজের সাথে সম্পর্কিত ট্যাব বেছে নিন। আপনার পরিষেবা অ্যাকাউন্ট Google Ads ম্যানেজার অ্যাকাউন্টের মাধ্যমে ক্লায়েন্ট অ্যাকাউন্ট অ্যাক্সেস করলে, login-customer-id (বা loginCustomerId) হাইফেন ছাড়া সেই ম্যানেজার অ্যাকাউন্টের ১০-সংখ্যার গ্রাহক আইডিতে সেট করুন (লগ-ইন গ্রাহক
আইডি দেখুন)।
Java
আপনার কনফিগারেশনে ব্যক্তিগত কী JSON পাথ সেট করুন। আপনি
ads.properties ফাইল ব্যবহার করলে, নিম্নলিখিতগুলি যোগ করুন:
api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH
আরও তথ্যের জন্য কনফিগারেশন গাইড দেখুন।
.NET
GoogleAdsConfig ইনস্ট্যান্সে OAuth2Mode এবং OAuth2SecretsJsonPath সেট করুন এবং GoogleAdsClient অবজেক্ট শুরু করতে এটি ব্যবহার করুন।
GoogleAdsConfig config = new GoogleAdsConfig()
{
OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
OAuth2SecretsJsonPath = "JSON_KEY_FILE_PATH",
// ...
};
GoogleAdsClient client = new GoogleAdsClient(config);
আরও তথ্যের জন্য কনফিগারেশন গাইড দেখুন।
Python
আপনার কনফিগারেশনে ব্যক্তিগত কী JSON পাথ সেট করুন। আপনি যদি
google-ads.yaml ফাইল, YAML স্ট্রিং বা dict ব্যবহার করেন, তাহলে নিম্নলিখিতগুলি যোগ করুন:
json_key_file_path: JSON_KEY_FILE_PATH
আপনি এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করলে, আপনার Bash কনফিগারেশন বা এনভায়রনমেন্টে নিম্নলিখিতগুলি যোগ করুন:
export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH
আরও তথ্যের জন্য কনফিগারেশন গাইড দেখুন।
PHP
আপনার google_ads_php.ini ফাইলে নিম্নলিখিত কী কনফিগার করুন।
[OAUTH2]
; For service account flow.
jsonKeyFilePath = "JSON_KEY_FILE_PATH"
scopes = "https://www.googleapis.com/auth/adwords"
আরও তথ্যের জন্য কনফিগারেশন গাইড দেখুন।
Ruby
আপনার google_ads_config.rb-এ নিম্নলিখিত 'কী' কনফিগার করুন।
c.keyfile = 'JSON_KEY_FILE_PATH'
আরও তথ্যের জন্য কনফিগারেশন গাইড দেখুন।
Perl
আপনার কনফিগারেশনে ব্যক্তিগত কী JSON পাথ সেট করুন। আপনি
googleads.properties ফাইল ব্যবহার করলে, নিম্নলিখিতগুলি যোগ করুন:
jsonKeyFilePath=JSON_KEY_FILE_PATH
আপনি এনভায়রনমেন্ট ভেরিয়েবেল ব্যবহার করলে, আপনার Bash কনফিগারেশন বা এনভায়রনমেন্টে নিম্নলিখিতগুলি যোগ করুন:
export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH
আরও তথ্যের জন্য কনফিগারেশন গাইড দেখুন।
কার্ল
gcloud CLI-তে অ্যাক্টিভ ক্রেডেনশিয়াল হিসেবে পরিষেবা অ্যাকাউন্ট সেট করে শুরু করুন।
gcloud auth login --cred-file=JSON_KEY_FILE_PATHএরপরে, Google Ads API-এর জন্য OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন।
gcloud auth \
print-access-token \
--scopes='https://www.googleapis.com/auth/adwords'আপনার API কলে অ্যাক্সেস টোকেন ব্যবহার করতে পারবেন। নিচে দেওয়া উদাহরণে
দেখানো হয়েছে যে কীভাবে আপনার অ্যাকাউন্টের
ক্যাম্পেন রিট্রিভ করতে
GoogleAdsService.SearchStream পদ্ধতি ব্যবহার করে ক্যাম্পেন রিপোর্ট রান করাতে হয়। এই নির্দেশিকায়
রিপোর্ট করা সম্পর্কে বিস্তারিত তথ্য নেই।
curl -i -X POST \
https://googleads.googleapis.com/v26/customers/CUSTOMER_ID/googleAds:searchStream \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "login-customer-id: LOGIN_CUSTOMER_ID" \
--data-binary "@query.json"query.json-এর কন্টেন্ট নিচে উল্লেখ করা হল:
{
"query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}