২৩শে জুলাই সকাল ১০:০০ টায় (EST) ডিসকর্ডে গুগল অ্যাডভার্টাইজিং অ্যান্ড মেজারমেন্ট কমিউনিটি সার্ভারে এবং ইউটিউবে আমাদের সাথে লাইভে যোগ দিন! আমরা গুগল অ্যাডস এপিআই-এর v25-এ যুক্ত হওয়া নতুন ফিচারগুলো নিয়ে আলোচনা করব।

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

কনফিগারেশন

ক্লায়েন্ট কনফিগার করার একাধিক ভিন্ন উপায় রয়েছে।

প্রমাণীকরণ কনফিগারেশন

Google Ads API অ্যাক্সেস করার জন্য প্রয়োজনীয় OAuth ক্রেডেনশিয়াল পরিচালনা করার একাধিক উপায় রয়েছে। আপনি যে পদ্ধতিটি বেছে নেবেন, তা আপনার ব্যবহৃত কনফিগারেশন ফিল্ডগুলোকে প্রভাবিত করবে। আরও তথ্যের জন্য আমাদের অথেনটিকেশন গাইড দেখুন।

YAML ফাইল ব্যবহার করে কনফিগারেশন

ক্লায়েন্ট ইনিশিয়ালাইজ করার সময় ব্যবহারের জন্য আপনি একটি YAML ফাইল নির্দিষ্ট করে দিতে পারেন, যেটিতে গুগল অ্যাডস এপিআই-তে রিকোয়েস্ট পাঠানোর জন্য প্রয়োজনীয় তথ্য থাকে। load_from_storage মেথড ব্যবহার করে যখন কোনো ক্লায়েন্ট ইনিশিয়ালাইজ করা হয়, তখন এই ফাইলটি অ্যাক্সেস করা হয়। এই ফাইলটি তৈরি করার সবচেয়ে সহজ উপায় হলো গিটহাব রিপোজিটরি থেকে google-ads.yaml উদাহরণটি কপি করে সেটিকে পরিবর্তন করে আপনার ক্রেডেনশিয়ালগুলো, যেমন—আপনার ডেভেলপার টোকেন, রিফ্রেশ টোকেন, ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট অন্তর্ভুক্ত করা।

আপনি যদি কোনো পাথ প্রদান না করেন, তাহলে লাইব্রেরিটি আপনার $HOME ডিরেক্টরিতে ফাইলটি খুঁজবে:

from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()

google-ads.yaml ফাইলটি কোথায় অবস্থিত তা নির্দিষ্ট করতে, মেথডটি কল করার সময় আপনি পাথটিকে একটি স্ট্রিং হিসেবে পাস করতে পারেন:

from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage("path/to/google-ads.yaml")

আপনি একটি নির্দিষ্ট এনভায়রনমেন্ট ভেরিয়েবল নির্ধারণ করেও পাথটি নির্দিষ্ট করতে পারেন:

import os

os.environ["GOOGLE_ADS_CONFIGURATION_FILE_PATH"] = "path/to/google-ads.yaml"
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()

যদি উভয় মানই প্রদান করা হয় — অর্থাৎ মেথডটিতে একটি পাথ পাস করা হয় এবং এনভায়রনমেন্ট ভেরিয়েবলটিও উপস্থিত থাকে — তাহলে লাইব্রেরিটি মেথডটিতে পাস করা পাথটিকে অগ্রাধিকার দেবে।

এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করে কনফিগারেশন

আপনি আপনার সমস্ত ক্লায়েন্ট কনফিগারেশন এনভায়রনমেন্ট ভেরিয়েবল হিসেবে সংরক্ষণ করতে পারেন, যা ক্লায়েন্টের ` load_from_env মেথড ব্যবহার করার সময় পড়া হবে। এনভায়রনমেন্ট ভেরিয়েবলগুলোর নাম google-ads.yaml ফাইলে সংজ্ঞায়িত ভেরিয়েবলগুলোর নামের মতোই হওয়া উচিত, তবে সেগুলো সম্পূর্ণ বড় হাতের অক্ষরে (uppercase) এবং GOOGLE_ADS_ নেমস্পেসের উপসর্গ দিয়ে শুরু হতে হবে। উদাহরণস্বরূপ, client_id GOOGLE_ADS_CLIENT_ID হিসেবে সংরক্ষণ করতে হবে।

এনভায়রনমেন্ট ভেরিয়েবল সাধারণত $HOME ডিরেক্টরিতে অবস্থিত .bashrc বা .bash_profile ফাইলের মতো একটি ব্যাশ কনফিগারেশন ফাইলে সংজ্ঞায়িত করা হয়। এগুলি কমান্ড লাইন ব্যবহার করেও সংজ্ঞায়িত করা যেতে পারে। মনে রাখবেন যে এই নির্দেশাবলী ধরে নিচ্ছে আপনি bash ব্যবহার করছেন; যদি আপনি অন্য কোনো শেল ব্যবহার করেন, তবে আপনার ব্যবহৃত শেলে কীভাবে এনভায়রনমেন্ট ভেরিয়েবল সেট করতে হয় তা জানতে আপনাকে ডকুমেন্টেশন দেখতে হতে পারে।

টার্মিনাল ব্যবহার করে .bashrc ফাইলের মাধ্যমে এনভায়রনমেন্ট ভেরিয়েবল নির্ধারণ করার কিছু প্রাথমিক ধাপ নিচে দেওয়া হলো:

# Append the line "export GOOGLE_ADS_CLIENT_ID=1234567890" to
# the bottom of your .bashrc file.
$ echo "export GOOGLE_ADS_CLIENT_ID=1234567890" >> ~/.bashrc
# Update your bash environment to use the most recently updated
# version of your .bashrc file.
$ src ~/.bashrc

আপনার টার্মিনাল ইনস্ট্যান্সে সরাসরি কমান্ড লাইন থেকেও এনভায়রনমেন্ট ভেরিয়েবল সেট করা যেতে পারে:

$ export GOOGLE_ADS_CLIENT_ID=1234567890
$ echo $GOOGLE_ADS_CLIENT_ID
1234567890

` load_from_env মেথডটি পাইথনের বিল্ট-ইন os মডিউলের ` environ অ্যাট্রিবিউট থেকে কনফিগারেশন ডেটা লোড করে। উদাহরণস্বরূপ: os.environ["GOOGLE_ADS_CLIENT_ID"]

এনভায়রনমেন্ট ভেরিয়েবলের কনফিগারেশন ব্যবহার করে কীভাবে একটি ক্লায়েন্ট ইনস্ট্যান্স ইনিশিয়ালাইজ করতে হয়, তার একটি উদাহরণ নিচে দেওয়া হলো:

from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_env()

এনভায়রনমেন্ট ভেরিয়েবলের মাধ্যমে logging কনফিগার করতে হলে, কনফিগারেশন ভ্যালুটি অবশ্যই একটি JSON অবজেক্ট হতে হবে, যা নমুনা google-ads.yaml কনফিগারেশন ফাইলের YAML কী-গুলোর কাঠামোর সাথে মেলে।

একটি .bashrc ফাইল ব্যবহার করে কীভাবে এটি সেট করা যেতে পারে তার একটি উদাহরণ এখানে দেওয়া হলো:

export GOOGLE_ADS_LOGGING='{
  "version": 1,
  "disable_existing_loggers": false,
  "formatters": {
    "default_fmt": {
      "format": "[%(asctime)s - %(levelname)s] %(message).5000s",
      "datefmt": "%Y-%m-%d %H:%M:%S"
    }
  },
  "handlers": {
    "default_handler": {
      "class": "logging.StreamHandler",
      "formatter": "default_fmt"
    }
  },
  "loggers": {
    "": {
      "handlers": ["default_handler"],
      "level": "INFO"
    }
  }
}'

YAML স্ট্রিং ব্যবহার করে কনফিগারেশন

যদি আপনি কোনো YAML ফাইল মেমরিতে লোড করে থাকেন, তবে ইনিশিয়ালাইজেশনের সময় সেটি সরাসরি ক্লায়েন্টকে সরবরাহ করতে পারেন। এটি করার জন্য শুধু load_from_string মেথডটি ব্যবহার করুন।

from google.ads.googleads.client import GoogleAdsClient

with open("/path/to/yaml", "rb") as handle:
    yaml = handle.read()

client = GoogleAdsClient.load_from_string(yaml)

`dict` ব্যবহার করে কনফিগারেশন

আপনি সরাসরি load_from_dict মেথডে একটি dict পাস করতে পারেন। উদাহরণস্বরূপ:

from google.ads.googleads.client import GoogleAdsClient

credentials = {
    "developer_token": "abcdef123456",
    "refresh_token": "1//0abcdefghijklABCDEF",
    "client_id": "123456-abcdef.apps.googleusercontent.com",
    "client_secret": "aBcDeFgHiJkL"}

client = GoogleAdsClient.load_from_dict(credentials)