নিরীক্ষণ

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 রানটাইমের সাথে কম্প্যাটিবিলিটি বজায় রাখে, তবে "ফিচার" বা "প্রি-রিলিজ" স্ট্যাটাস সহ ভার্সনের ক্ষেত্রে এটি প্রযোজ্য নয়।

Python Software Foundation-এর তরফ থেকে Python রানটাইমের নতুন ভার্সন রিলিজ ও আনুষ্ঠানিকভাবে সাপোর্ট করা হলে, Google Ads API টিম যত শীঘ্র সম্ভব সেটি গ্রহণ করার চেষ্টা করে।

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 অনুরোধ করতে পারলে, ক্লায়েন্ট লাইব্রেরির এইসব ব্যবহারের দিকে এগিয়ে যান: