আমাদের পণ্যগুলি নিয়ে আলোচনা করতে এবং প্রতিক্রিয়া জানাতে, Google Advertising and Measurement Community সার্ভারে অফিসিয়াল Google Ads Discord চ্যানেলে যোগ দিন।

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

কনফিগারেশন

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

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

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

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

ক্লায়েন্ট শুরু করার সময় আপনি একটি YAML ফাইল নির্দিষ্ট করতে পারেন যাতে Google Ads API-তে অনুরোধ করার জন্য প্রয়োজনীয় তথ্য থাকে। load_from_storage পদ্ধতি ব্যবহার করে ক্লায়েন্ট শুরু করার সময় এই ফাইলটি অ্যাক্সেস করা হয়। এই ফাইলটি তৈরি করার সবচেয়ে সহজ উপায় হল GitHub সংগ্রহস্থল থেকে 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 ফাইলে সংজ্ঞায়িত নামের মতোই হওয়া উচিত, তবে সবগুলো বড় হাতের অক্ষরে এবং GOOGLE_ADS_ নেমস্পেসের সাথে প্রিফিক্স করা উচিত। উদাহরণস্বরূপ, client_id GOOGLE_ADS_CLIENT_ID হিসেবে সংরক্ষণ করা উচিত।

এনভায়রনমেন্ট ভেরিয়েবল সাধারণত $HOME ডিরেক্টরিতে অবস্থিত .bashrc বা .bash_profile ফাইলের মতো একটি bash কনফিগারেশন ফাইলে সংজ্ঞায়িত করা হয়। কমান্ড লাইন ব্যবহার করেও এগুলি সংজ্ঞায়িত করা যেতে পারে । মনে রাখবেন যে এই নির্দেশাবলী ধরে নিচ্ছেন আপনি 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)