পাইথন ক্লায়েন্ট লাইব্রেরিটি GitHub-এ হোস্ট করা হয়েছে, এবং প্যাকেজটি PyPI- তে উপলব্ধ।
আবশ্যকতা
লাইব্রেরির জন্য পাইথন ৩.৯ বা তার পরবর্তী সংস্করণ প্রয়োজন।
পূর্বশর্ত
এই নির্দেশিকাটি অনুসরণ করার আগে, আপনার Google Ads API-এর জন্য একটি ডেভেলপার টোকেন এবং আপনার Google Ads অ্যাকাউন্টের জন্য ১০-সংখ্যার ক্লায়েন্ট গ্রাহক আইডি প্রয়োজন হবে।
রানটাইম এবং নির্ভরতা সামঞ্জস্য
পাইথন ক্লায়েন্ট লাইব্রেরি পাইথন সফটওয়্যার ফাউন্ডেশন দ্বারা প্রকাশিত সমর্থিত সংস্করণ বিভাগে পাইথন রানটাইমের সাথে সামঞ্জস্য বজায় রাখে, "বৈশিষ্ট্য" বা "প্রি-রিলিজ" স্ট্যাটাস সহ সংস্করণগুলি ছাড়া।
আমরা লক্ষ্য রাখি পাইথন রানটাইমের নতুন সংস্করণগুলি প্রকাশিত হওয়ার সাথে সাথে এবং পাইথন সফটওয়্যার ফাউন্ডেশন কর্তৃক আনুষ্ঠানিকভাবে সমর্থিত হওয়ার সাথে সাথে গ্রহণ করা।
python.org এর Unsupported Versions বিভাগে, EOL তারিখের পরে পাইথনের রানটাইম (EOL) শেষ হয়ে গেছে, সেগুলি EOL তারিখের পরে সমর্থিত নয়। আমরা EOL রানটাইমের সাথে সামঞ্জস্যের গ্যারান্টি দিতে পারি না, কারণ আমরা লাইব্রেরির এমন একটি সংস্করণ প্রকাশ করতে পারি যা তাদের EOL তারিখের পরে যেকোনো সময়ে তাদের সাথে বেমানান।
নির্ভরতার ক্ষেত্রে, (বিশেষ করে, Python ক্লায়েন্ট লাইব্রেরির প্রয়োজনীয়তা অনুসারে তালিকাভুক্ত যেকোনো Google-রক্ষণাবেক্ষণকৃত প্যাকেজ), আমরা Google-রক্ষণাবেক্ষণকৃত এবং Google-এর OSS ব্রেকিং চেঞ্জ নীতি অনুসারে "সমর্থিত" বলে বিবেচিত প্যাকেজগুলির সাথে সামঞ্জস্য বজায় রাখব।
সমর্থিত পাইথন রানটাইম এবং নির্ভরতার সম্পূর্ণ তালিকার জন্য, নির্ভরতা পৃষ্ঠাটি দেখুন।
স্থাপন
আমাদের ইনস্টলেশন গাইডে লাইব্রেরি ইনস্টল করার বিভিন্ন উপায় দেখানো হয়েছে। আপনার অ্যাপ্লিকেশনে লাইব্রেরি ইনস্টল করার সবচেয়ে সহজ (এবং প্রস্তাবিত) উপায় হল pip :
$ python -m pip install google-ads
কনফিগারেশন
একবার আপনি লাইব্রেরিটি ইনস্টল করার পরে আপনাকে এর জন্য একটি কনফিগারেশন সেট আপ করতে হবে। লাইব্রেরিটি কনফিগার করার একাধিক উপায় রয়েছে, যা আমাদের কনফিগারেশন গাইডে বর্ণিত হয়েছে।
প্রমাণীকরণ
একবার আপনি একটি কনফিগারেশন পদ্ধতি বেছে নিলে, আপনি আপনার প্রমাণীকরণ কনফিগারেশন সেট আপ করতে পারেন। ধাপে ধাপে নির্দেশাবলীর জন্য আমাদের Python ক্লায়েন্ট লাইব্রেরি প্রমাণীকরণ গাইড গাইড দেখুন, এবং আরও সাধারণ পটভূমির জন্য আমাদের OAuth ওভারভিউ দেখুন।
একটি API অনুরোধ করুন
একবার আপনার প্রমাণীকরণ কনফিগারেশন সেট আপ করার পরে, আপনি একটি API অনুরোধ করতে প্রস্তুত। API অনুরোধ করার জন্য লাইব্রেরিটি সঠিকভাবে কনফিগার করা আছে কিনা তা দ্রুত পরীক্ষা করার জন্য get campaigns উদাহরণটি দেখুন।
get_campaigns.py নমুনাটি চালানোর জন্য, আপনার স্থানীয়ভাবে ইনস্টল করা googleads-python ক্লায়েন্ট লাইব্রেরির রুট ডিরেক্টরিতে, নিম্নলিখিত কমান্ডটি চালান:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
অতিরিক্ত সম্পদ
API অনুরোধ করার পর, ক্লায়েন্ট লাইব্রেরির এই ব্যবহারগুলিতে এগিয়ে যান: