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

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

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

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

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

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

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

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

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

  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

যদি আপনি পরিবেশ ভেরিয়েবল ব্যবহার করেন, তাহলে আপনার Bash কনফিগারেশন বা পরিবেশে নিম্নলিখিতগুলি যোগ করুন:

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

যদি আপনি পরিবেশ ভেরিয়েবল ব্যবহার করেন, তাহলে আপনার Bash কনফিগারেশন বা পরিবেশে নিম্নলিখিতগুলি যোগ করুন:

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

কার্ল করা

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/v22/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"
}
পূর্ববর্তী
অ্যাক্সেস মডেল ওভারভিউ
পরবর্তী
ওভারভিউ