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