লগিং

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

লাইব্রেরিটি পাইথনের বিল্ট-ইন লগিং ফ্রেমওয়ার্ক ব্যবহার করে এবং ডিফল্টভাবে stderr এ লগ ব্যবহার করে। অন্তর্ভুক্ত করা হলে, আপনার কনফিগারেশনে সংজ্ঞায়িত logging অবজেক্টটি সরাসরি logging.config.dictConfig এ একটি dict হিসাবে পাস করা হয়।

আপনি ক্লায়েন্ট শুরু করার আগে একটি লগিং কনফিগারেশন সেট করে প্রোগ্রামগতভাবে লগিং কনফিগার করতে পারেন। আপনি ক্লায়েন্ট লগার ইনস্ট্যান্স পুনরুদ্ধার করতে পারেন এবং নিম্নলিখিত উদাহরণ দিয়ে এটি কনফিগার করতে পারেন:

import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)

লক্ষ্য করুন যে ক্লায়েন্ট শুরু হলে ক্লায়েন্ট লগার কনফিগার করা হয়। লগিং কনফিগারেশনের পরবর্তী পরিবর্তন উপেক্ষা করা হবে। YAML ফাইলে লগিং কনফিগারেশনকে প্রোগ্রাম্যাটিকভাবে ওভাররাইড করার জন্য, ক্লায়েন্ট শুরু হওয়ার আগে উপরের লাইনগুলিতে কল করতে ভুলবেন না।

লগ লেভেল

ক্লায়েন্ট কয়েকটি ভিন্ন স্তরে লগ তৈরি করে এবং আপনি নীচের কিছু বা সমস্ত দেখতে আপনার কনফিগারেশন সেট করতে পারেন:

স্তর	সফল অনুরোধ	ব্যর্থ অনুরোধ
DEBUG	JSON হিসাবে সম্পূর্ণ অনুরোধ এবং প্রতিক্রিয়া বস্তু সহ একটি বিস্তারিত লগ।	JSON হিসাবে সম্পূর্ণ অনুরোধ এবং ব্যতিক্রম বস্তু সহ একটি বিস্তারিত লগ।
INFO	নির্দিষ্ট অনুরোধ এবং প্রতিক্রিয়া ক্ষেত্র সহ একটি সংক্ষিপ্ত সারসংক্ষেপ।	JSON হিসাবে সম্পূর্ণ অনুরোধ এবং ব্যতিক্রম বস্তু সহ একটি বিস্তারিত লগ।
WARNING	কোনোটিই নয়	নির্দিষ্ট অনুরোধের তথ্য, ব্যতিক্রম অবস্থা এবং বার্তা সহ একটি সংক্ষিপ্ত সারাংশ।

যেহেতু পাইথন লগিং ফ্রেমওয়ার্ক লগ বার্তাগুলিকে উপেক্ষা করে যেগুলি কনফিগার করা স্তরের চেয়ে কম গুরুতর, WARNING সেট করার অর্থ হল আপনি শুধুমাত্র ব্যর্থ অনুরোধগুলির সাথে সম্পর্কিত সংক্ষিপ্ত বার্তাগুলি দেখতে পাবেন, কিন্তু DEBUG সেট করার অর্থ হল আপনি উপরের টেবিলে সমস্ত সম্ভাব্য ধরনের লগ দেখতে পাবেন৷

ফাইল লগিং

আপনি সহজেই একটি ফাইলে লগ বার্তা পাইপ করতে পারেন; উদাহরণস্বরূপ, get_campaigns চালানোর সময় উদাহরণ::

python get_campaigns.py -c $CLIENT_ID 2> example.log

লগিং ইন্টারসেপ্টর

পাইথন ক্লায়েন্ট লাইব্রেরি জিআরপিসি ইন্টারসেপ্টর ব্যবহার করে অনুরোধ এবং প্রতিক্রিয়ার বিবরণ অ্যাক্সেস এবং লগ করতে। আপনি কাস্টম লজিক সহ একটি gRPC ইন্টারসেপ্টর তৈরি করে আপনার নিজস্ব কাস্টম লগিং সেট আপ করতে পারেন। আরও বিশদ বিবরণের জন্য লগিং গাইড দেখুন এবং একটি কাস্টম লগিং ইন্টারসেপ্টরের উদাহরণ দেখুন।