পরিষেবা অ্যাকাউন্ট ওয়ার্কফ্লো

দ্রষ্টব্য: এই নির্দেশিকা অনুমান করে যে আপনি Google বিজ্ঞাপন অ্যাক্সেস মডেলের সাথে পরিচিত। আপনি যদি তা না করেন, তাহলে ধারণার সাথে নিজেকে পরিচিত করতে আমরা Google Ads অ্যাক্সেস মডেল গাইড পড়ার পরামর্শ দিই।

এই নির্দেশিকা আলোচনা করে যে কীভাবে পরিষেবা অ্যাকাউন্টের মাধ্যমে Google বিজ্ঞাপন API অ্যাক্সেস করতে হয়।

একটি পরিষেবা অ্যাকাউন্ট এমন একটি অ্যাকাউন্ট যা একজন স্বতন্ত্র ব্যবহারকারীর পরিবর্তে আপনার অ্যাপের অন্তর্গত। পরিষেবা অ্যাকাউন্টগুলি একটি OAuth 2.0 ফ্লো নিয়োগ করে যার জন্য মানুষের অনুমোদনের প্রয়োজন হয় না, পরিবর্তে একটি কী ফাইল ব্যবহার করে যা শুধুমাত্র আপনার অ্যাপ অ্যাক্সেস করতে পারে।

পরিষেবা অ্যাকাউন্ট ব্যবহার করা দুটি মূল সুবিধা প্রদান করে:

• Google Ads অ্যাকাউন্টে Google Ads API অ্যাক্সেসের অনুমোদন একটি কনফিগারেশন ধাপ হিসেবে করা হয়, Google Ads UI দ্বারা অফার করা অনুমোদন এবং অ্যাকাউন্ট পরিচালনার বৈশিষ্ট্যগুলিকে কাজে লাগিয়ে। এটি OAuth 2.0 ফ্লো তৈরি না করে এবং ব্যবহারকারীর মিথস্ক্রিয়া, ব্যবহারকারীর শংসাপত্র সংরক্ষণ ইত্যাদির সাথে জড়িত জটিলতার মোকাবেলা না করে বিকাশকারীর প্রচেষ্টাকে বাঁচায়।

• Google বিজ্ঞাপন অ্যাকাউন্টে অ্যাক্সেসের জন্য অনুমোদন পৃথক ব্যবহারকারীর শংসাপত্রের সাথে আবদ্ধ নয়, যেটি এমন ক্ষেত্রে কার্যকর হতে পারে যে ক্ষেত্রে এই ধরনের অনুমোদন অব্যাহত থাকবে বলে আশা করা হয় এমনকি যে কর্মচারীটি মূলত অ্যাক্সেসের অনুমোদন দিয়েছে সে দল বা কোম্পানি ছেড়ে চলে গেলেও।

অ্যাকাউন্ট অ্যাক্সেস সেটআপ

1. একটি পরিষেবা অ্যাকাউন্ট এবং শংসাপত্র তৈরি করে শুরু করুন।

   জেএসএন ফর্ম্যাটে পরিষেবা অ্যাকাউন্ট কীটি ডাউনলোড করুন এবং পরিষেবা অ্যাকাউন্ট আইডি এবং ইমেলটি নোট করুন।

2. অ্যাডমিনিস্ট্রেটর হিসেবে আপনার Google Ads অ্যাকাউন্টে সাইন ইন করুন। অ্যাডমিন > অ্যাক্সেস এবং নিরাপত্তাতে নেভিগেট করুন।

3. ব্যবহারকারী ট্যাবের অধীনে + বোতামে ক্লিক করুন।

   

4. ইমেল ইনপুট বক্সে পরিষেবা অ্যাকাউন্টের ইমেল টাইপ করুন। অ্যাকাউন্ট অ্যাক্সেস লেভেলের উপযুক্ত স্তর নির্বাচন করুন এবং অ্যাকাউন্ট যোগ করুন বোতামে ক্লিক করুন। নোট করুন যে ইমেল এবং অ্যাডমিন অ্যাক্সেস স্তর পরিষেবা অ্যাকাউন্টগুলির জন্য সমর্থিত নয়৷

   

5. পরিষেবা অ্যাকাউন্ট অ্যাক্সেস দেওয়া হয়.

   

ক্লায়েন্ট লাইব্রেরি কনফিগারেশন

আপনার ক্লায়েন্ট লাইব্রেরি কনফিগার করার নির্দেশাবলীর জন্য আপনার প্রোগ্রামিং ভাষার সাথে সম্পর্কিত ট্যাবটি নির্বাচন করুন।

জাভা

আপনার কনফিগারেশনে ব্যক্তিগত কী JSON পাথ সেট করুন। আপনি যদি একটি ads.properties ফাইল ব্যবহার করেন, তাহলে নিম্নলিখিতগুলি যোগ করুন:

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH

অতিরিক্ত বিবরণের জন্য কনফিগারেশন গাইড দেখুন।

.নেট

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 ব্যবহার করে একটি অ্যাক্সেস টোকেন পাওয়ার নির্দেশাবলী দেখায়। যাইহোক, আপনি ইন্টারনেটে উপলব্ধ যেকোনো OAuth 2.0 ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে পারেন। https://oauth.net/code/ বিভিন্ন ভাষা-নির্দিষ্ট OAuth লাইব্রেরি তালিকাভুক্ত করে। পরিষেবা অ্যাকাউন্টগুলির জন্য কাঁচা HTTP ওয়ার্কফ্লো সম্পর্কে আরও জানতে আপনি Google এর OAuth ডকুমেন্টেশনও উল্লেখ করতে পারেন৷

gcloud CLI-তে সক্রিয় শংসাপত্র হিসাবে পরিষেবা অ্যাকাউন্ট সেট করে শুরু করুন।

gcloud auth login --cred-file=PATH_TO_CREDENTIALS_JSON

এরপর, 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/v21/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"
}