নিরীক্ষণ

Python ক্লায়েন্ট লাইব্রেরি GitHub-এ হোস্ট করা হয় এবং প্যাকেজটি PyPI-তে উপলভ্য।

প্রয়োজনীয়তা

লাইব্রেরিটি Python 3.9 থেকে 3.14 পর্যন্ত ভার্সন সাপোর্ট করে (>=3.9, <3.15; Python 3.14 সাপোর্ট v28.2.0-এ যোগ করা হয়েছে)। কারণ Python 3.9 এবং 3.10 google-ads v32.0.0 এবং পরবর্তী ভার্সনে ইম্পোর্ট করার সময় একটি অবচয় সতর্কতা জারি করে, তাই Python 3.11 বা তার পরবর্তী ভার্সন ব্যবহার করার সাজেশন দেওয়া হয়।

পূর্বশর্ত

এই নির্দেশিকা অনুসরণ করার আগে, আপনার Google Ads অ্যাকাউন্টের ১০-সংখ্যার ক্লায়েন্ট কাস্টমার আইডি প্রয়োজন।

রানটাইম ও ডিপেন্ডেন্সি কম্প্যাটিবিলিটি

Python ক্লায়েন্ট লাইব্রেরি Python Software Foundation-এর প্রকাশিত মানানসই ভার্সন বিভাগে Python রানটাইমের সাথে মানানসই থাকে, তবে "ফিচার" বা "প্রি-রিলিজ" স্ট্যাটাস সহ ভার্সনগুলি এর ব্যতিক্রম।

Google Ads API টিম Python রানটাইমের নতুন ভার্সন রিলিজ হওয়ার সাথে সাথে এবং Python Software Foundation-এর মাধ্যমে আনুষ্ঠানিকভাবে সমর্থিত হওয়ার সাথে সাথে তা গ্রহণ করার লক্ষ্য রাখে।

Python রানটাইম যেগুলি এন্ড অফ লাইফ (EOL)-এ পৌঁছে গেছে সেগুলি python.org-এর কাজ করে না এমন ভার্সন বিভাগে EOL তারিখের পরে কাজ করে না। EOL রানটাইমের সাথে কম্প্যাটিবিলিটির গ্যারেন্টি দেওয়া যায় না, কারণ EOL তারিখের পরে লাইব্রেরি রিলিজ করলে কম্প্যাটিবিলিটি ভেঙে যেতে পারে।

ডিপেন্ডেন্সির (বিশেষত, Python ক্লায়েন্ট লাইব্রেরির মাধ্যমে প্রয়োজনীয় হিসেবে তালিকাভুক্ত Google-এর ম্যানেজ করা যেকোনও প্যাকেজ) ক্ষেত্রে, Google-এর ম্যানেজ করা এবং Google-এর OSS ব্রেকিং পরিবর্তন নীতি অনুযায়ী "কাজ করে" হিসেবে বিবেচিত প্যাকেজের সাথে কম্প্যাটিবিলিটি বজায় রাখা হয়।

কাজ করে এমন Python রানটাইম ও ডিপেন্ডেন্সির সম্পূর্ণ তালিকা দেখতে, ডিপেন্ডেন্সি পৃষ্ঠা দেখুন।

ইনস্টল করা

ইনস্টলেশন গাইডে লাইব্রেরি ইনস্টল করার সবকটি উপায় উল্লেখ করা আছে। আপনার অ্যাপ্লিকেশনে লাইব্রেরি ইনস্টল করার সবচেয়ে সহজ (এবং সাজেস্ট করা) উপায় হল pip ব্যবহার করা:

python -m pip install google-ads

কনফিগারেশন

লাইব্রেরি ইনস্টল করার পরে, আপনাকে এটির জন্য একটি কনফিগারেশন সেট-আপ করতে হবে। লাইব্রেরি কনফিগার করার একাধিক উপায় আছে, যেগুলি কনফিগারেশন গাইডে বর্ণনা করা আছে।

যাচাইকরণ

কনফিগারেশন অ্যাপ্রোচ বেছে নেওয়ার পরে, আপনার যাচাইকরণ কনফিগারেশন সেট-আপ করুন। ধাপে-ধাপে দেওয়া নির্দেশাবলীর জন্য, Python ক্লায়েন্ট লাইব্রেরি যাচাইকরণ গাইড দেখুন। আরও সাধারণ প্রেক্ষাপটের জন্য, OAuth ওভারভিউ দেখুন।

API সংক্রান্ত অনুরোধ করা

আপনার যাচাইকরণ কনফিগারেশন সেট-আপ করা হয়ে গেলে, আপনি API অনুরোধ করার জন্য প্রস্তুত। API অনুরোধ করার জন্য লাইব্রেরি সঠিকভাবে কনফিগার করা হয়েছে কিনা তা পরীক্ষা করার দ্রুত উপায়ের জন্য ক্যাম্পেন পান উদাহরণ দেখুন।

get_campaigns.py স্যাম্পেল চালাতে, প্রথমে google-ads-python রিপোজিটরি ক্লোন করুন। তারপর, ক্লোন করা রিপোজিটরির রুট ডিরেক্টরি থেকে, নিম্নলিখিত কমান্ড রান করুন:

python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE

অতিরিক্ত রিসোর্স

আপনি API অনুরোধ করতে পারলে, ক্লায়েন্ট লাইব্রেরির এইসব ব্যবহারের দিকে এগিয়ে যান: