এই নির্দেশিকায় সার্ভিস অ্যাকাউন্ট ব্যবহার করে কীভাবে গুগল অ্যাডস এপিআই অ্যাক্সেস করা যায়, তা আলোচনা করা হয়েছে।
সার্ভিস অ্যাকাউন্ট হলো এমন একটি অ্যাকাউন্ট যা কোনো স্বতন্ত্র ব্যবহারকারীর পরিবর্তে আপনার অ্যাপের নিজস্ব। সার্ভিস অ্যাকাউন্টগুলো এমন একটি OAuth 2.0 ফ্লো ব্যবহার করে, যার জন্য মানুষের অনুমোদনের প্রয়োজন হয় না; এর পরিবর্তে এটি একটি কী ফাইল ব্যবহার করে, যা শুধুমাত্র আপনার অ্যাপই অ্যাক্সেস করতে পারে।
সার্ভিস অ্যাকাউন্ট ব্যবহারের দুটি প্রধান সুবিধা রয়েছে:
গুগল অ্যাডস অ্যাকাউন্টে গুগল অ্যাডস এপিআই অ্যাক্সেসের অনুমোদন একটি কনফিগারেশন ধাপ হিসেবে সম্পন্ন করা হয়, যা গুগল অ্যাডস ইউআই (UI) দ্বারা প্রদত্ত অনুমোদন এবং অ্যাকাউন্ট ম্যানেজমেন্ট বৈশিষ্ট্যগুলোকে কাজে লাগায়। এর ফলে ডেভেলপারদের শ্রম সাশ্রয় হয়, কারণ তাদের OAuth 2.0 ফ্লো তৈরি করতে হয় না এবং ব্যবহারকারীর ইন্টারঅ্যাকশন, ব্যবহারকারীর ক্রেডেনশিয়াল সংরক্ষণ ইত্যাদির মতো জটিলতাগুলোও সামলাতে হয় না।
গুগল অ্যাডস অ্যাকাউন্টে প্রবেশের অনুমোদন কোনো একক ব্যবহারকারীর পরিচয়পত্রের সাথে সংযুক্ত নয়, যা এমন ক্ষেত্রে সুবিধাজনক হতে পারে যেখানে মূল অনুমোদনকারী কর্মী দল বা কোম্পানি ছেড়ে গেলেও সেই অনুমোদন অব্যাহত থাকবে বলে আশা করা হয়।
অ্যাকাউন্ট অ্যাক্সেস সেটআপ
প্রথমে একটি সার্ভিস অ্যাকাউন্ট ও ক্রেডেনশিয়াল তৈরি করে নিন ।
JSON ফরম্যাটে সার্ভিস অ্যাকাউন্ট কী-টি ডাউনলোড করুন এবং সার্ভিস অ্যাকাউন্ট আইডি ও ইমেলটি নোট করে রাখুন।
প্রশাসক হিসেবে আপনার গুগল অ্যাডস অ্যাকাউন্টে সাইন ইন করুন। অ্যাডমিন > অ্যাক্সেস এবং নিরাপত্তা- তে যান।
Users ট্যাবের নিচে থাকা + বোতামটিতে ক্লিক করুন।
সার্ভিস অ্যাকাউন্টের ইমেলটি ইমেল ইনপুট বক্সে টাইপ করুন। অ্যাকাউন্ট অ্যাক্সেস লেভেলের উপযুক্ত স্তর নির্বাচন করুন এবং 'অ্যাড অ্যাকাউন্ট' বোতামে ক্লিক করুন।
সার্ভিস অ্যাকাউন্টটিকে অ্যাক্সেস দেওয়া হয়েছে।
[ঐচ্ছিক] ডিফল্টরূপে, আপনি কোনো সার্ভিস অ্যাকাউন্টে অ্যাডমিনিস্ট্রেটর অ্যাক্সেস দিতে পারবেন না। যদি আপনার API কলগুলোর জন্য অ্যাডমিনিস্ট্রেটর অ্যাক্সেসের প্রয়োজন হয়, তবে আপনি নিম্নলিখিত উপায়ে অ্যাক্সেসটি আপগ্রেড করতে পারেন।
- অ্যাক্সেস লেভেল কলামে সার্ভিস অ্যাকাউন্টের অ্যাক্সেস লেভেলের পাশে থাকা ড্রপ-ডাউন তীরটিতে ক্লিক করুন।
- ড্রপ-ডাউন তালিকা থেকে অ্যাডমিন নির্বাচন করুন।
ক্লায়েন্ট লাইব্রেরি কনফিগারেশন
আপনার ক্লায়েন্ট লাইব্রেরি কীভাবে কনফিগার করবেন তার নির্দেশাবলীর জন্য আপনার প্রোগ্রামিং ভাষার সাথে সম্পর্কিত ট্যাবটি নির্বাচন করুন।
জাভা
আপনার কনফিগারেশনে প্রাইভেট কী JSON পাথ সেট করুন। আপনি যদি ads.properties ফাইল ব্যবহার করেন, তাহলে নিম্নলিখিতটি যোগ করুন:
api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH
অতিরিক্ত বিবরণের জন্য কনফিগারেশন গাইড দেখুন।
.NET
GoogleAdsConfig ইনস্ট্যান্সে OAuth2Mode এবং OAuth2SecretsJsonPath সেট করুন এবং এটি ব্যবহার করে GoogleAdsClient অবজেক্টটি ইনিশিয়ালাইজ করুন।
GoogleAdsConfig config = new GoogleAdsConfig()
{
OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
OAuth2SecretsJsonPath = "PATH_TO_JSON_SECRETS_PATH",
...
};
GoogleAdsClient client = new GoogleAdsClient(config);
অতিরিক্ত বিবরণের জন্য কনফিগারেশন গাইড দেখুন।
পাইথন
আপনার কনফিগারেশনে প্রাইভেট কী JSON পাথ সেট করুন। যদি আপনি একটি google-ads.yaml file , YAML স্ট্রিং, বা dict ব্যবহার করেন, তাহলে নিম্নলিখিতটি যোগ করুন:
json_key_file_path: JSON_KEY_FILE_PATH
আপনি যদি এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করেন, তাহলে আপনার ব্যাশ কনফিগারেশন বা এনভায়রনমেন্টে নিম্নলিখিতটি যোগ করুন:
export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH
পিএইচপি
আপনার google_ads_php.ini ফাইলে নিম্নলিখিত কীগুলি কনফিগার করুন। অতিরিক্ত বিবরণের জন্য কনফিগারেশন গাইড দেখুন।
; For service account flow.
jsonKeyFilePath = "JSON_KEY_FILE_PATH"
scopes = "https://www.googleapis.com/auth/adwords"
রুবি
আপনার google_ads_config.rb ফাইলে নিম্নলিখিত কীগুলি কনফিগার করুন।
c.keyfile = 'JSON_KEY_FILE_PATH'
পার্ল
আপনার কনফিগারেশনে প্রাইভেট কী JSON পাথ এবং ডেলিগেট অ্যাকাউন্ট আইডি সেট করুন। আপনি যদি googleads.properties ফাইল ব্যবহার করেন, তাহলে নিম্নলিখিতগুলি যোগ করুন:
jsonKeyFilePath=JSON_KEY_FILE_PATH
আপনি যদি এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করেন, তাহলে আপনার ব্যাশ কনফিগারেশন বা এনভায়রনমেন্টে নিম্নলিখিতটি যোগ করুন:
export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH
কার্ল
প্রথমে gcloud CLI-তে সার্ভিস অ্যাকাউন্টটিকে সক্রিয় ক্রেডেনশিয়াল হিসেবে সেট করুন।
gcloud auth login --cred-file=PATH_TO_CREDENTIALS_JSONএরপর, গুগল অ্যাডস এপিআই-এর জন্য একটি OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন।
gcloud auth \
print-access-token \
--scopes='https://www.googleapis.com/auth/adwords'আপনি এখন আপনার এপিআই কলগুলিতে অ্যাক্সেস টোকেন ব্যবহার করতে পারবেন। নিম্নলিখিত উদাহরণটি দেখায় কিভাবে আপনার অ্যাকাউন্টের ক্যাম্পেইনগুলি পুনরুদ্ধার করতে GoogleAdsService.SearchStream পদ্ধতি ব্যবহার করে একটি ক্যাম্পেইন রিপোর্ট চালানো যায়। এই নির্দেশিকাটি রিপোর্টিং- এর বিস্তারিত বিষয়গুলি আলোচনা করে না।
curl -i -X POST https://googleads.googleapis.com/v24/customers/CUSTOMER_ID/googleAds:searchStream \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "developer-token: DEVELOPER_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"
}