Python ক্লায়েন্ট লাইব্রেরি GitHub-এ হোস্ট করা হয়েছে এবং প্যাকেজটি PyPI- তে উপলব্ধ।
প্রয়োজনীয়তা
লাইব্রেরির জন্য Python 3.8 বা তার পরবর্তী সংস্করণ প্রয়োজন।
পূর্বশর্ত
লাইব্রেরি ইনস্টল করার আগে, আপনার একটি বিকাশকারী টোকেন এবং ক্লায়েন্ট গ্রাহক আইডি প্রয়োজন হবে। সেগুলি কীভাবে পেতে হয় তার নির্দেশাবলী পূর্বশর্ত বিভাগে বর্ণিত হয়েছে। মনে রাখবেন যে আপনি পরবর্তী ধাপে অন্যান্য প্রয়োজনীয় OAuth2 টোকেন তৈরি করবেন।
রানটাইম এবং নির্ভরতা সামঞ্জস্য
পাইথন ক্লায়েন্ট লাইব্রেরি পাইথন সফ্টওয়্যার ফাউন্ডেশন দ্বারা প্রকাশিত সমর্থিত সংস্করণ বিভাগে পাইথন রানটাইমের সাথে সামঞ্জস্য বজায় রাখে, "বৈশিষ্ট্য" বা "প্রি-রিলিজ" স্ট্যাটাস সহ সংস্করণগুলি ছাড়া।
পাইথন রানটাইমের নতুন সংস্করণ গ্রহণ করার সময়, আমরা পাইথন ক্লায়েন্ট লাইব্রেরির একটি নতুন সংস্করণ প্রকাশ করার লক্ষ্য রাখি যা মুক্তির পর প্রান্তিকের শেষের দিকে সর্বশেষ রানটাইমের সাথে সামঞ্জস্যপূর্ণ। উদাহরণস্বরূপ, যদি অক্টোবরে একটি নতুন রানটাইম প্রকাশ করা হয়, তাহলে পাইথন ক্লায়েন্ট লাইব্রেরির একটি সামঞ্জস্যপূর্ণ সংস্করণ পরের বছরের মার্চের শেষে পাওয়া যাবে।
Python রানটাইম যেগুলি এন্ড অফ লাইফ (EOL) এ পৌঁছেছে তা python.org এর অসমর্থিত সংস্করণ বিভাগে জীবন শেষ হওয়ার তারিখের পরে সমর্থিত নয়।
আমরা পাইথন ক্লায়েন্ট লাইব্রেরির একটি সংস্করণ প্রকাশ করতে পারি যা অসমর্থিত পাইথন রানটাইমগুলির সাথে অসামঞ্জস্যপূর্ণ যেকোন সময়ে তারা EOL এ পৌঁছানোর পরে।
নির্ভরতাগুলির জন্য, (বিশেষত, যে কোনো Google-রক্ষণাবেক্ষণ করা প্যাকেজগুলি যেগুলি পাইথন ক্লায়েন্ট লাইব্রেরির প্রয়োজন অনুসারে তালিকাভুক্ত করা হয়েছে), আমরা Google-র রক্ষণাবেক্ষণ করা প্যাকেজের সাথে সামঞ্জস্য বজায় রাখব এবং Google-এর OSS ব্রেকিং পরিবর্তন নীতি অনুসারে "সমর্থিত" বলে বিবেচিত হবে।
সমর্থিত পাইথন রানটাইম এবং নির্ভরতার একটি সম্পূর্ণ তালিকার জন্য, নির্ভরতা পৃষ্ঠাটি দেখুন।
ইনস্টলেশন
PyPi থেকে লাইব্রেরি ইনস্টল করতে এবং এই পৃষ্ঠায় ফিরে যেতে আমাদের ইনস্টলেশন ডকুমেন্টেশনের নির্দেশাবলী অনুসরণ করুন।
কনফিগারেশন
একবার আপনি লাইব্রেরি ইনস্টল করার পরে আপনাকে এটির জন্য একটি কনফিগারেশন সেট আপ করতে হবে। লাইব্রেরি কনফিগার করার একাধিক উপায় আছে, যা আমাদের কনফিগারেশন ডকুমেন্টেশনে বর্ণিত আছে।
প্রমাণীকরণ
একবার আপনি একটি কনফিগারেশন টাইপ বেছে নিলে আপনি API-তে অনুরোধ করার জন্য প্রয়োজনীয় অবশিষ্ট OAuth2 টোকেন তৈরি করে এগিয়ে যেতে পারেন। একাধিক সমর্থিত OAuth2 ফ্লো আছে, যা নীচের তালিকায় নথিভুক্ত করা হয়েছে। প্রবাহের মধ্যে পার্থক্য সম্পর্কে বিশদ বিবরণের জন্য এবং আপনার আবেদনের জন্য কোনটি সর্বোত্তম তা সিদ্ধান্ত নিতে সহায়তার জন্য, আমাদের OAuth ডকুমেন্টেশন দেখুন।
একটি API অনুরোধ করা
একবার আপনি আপনার কনফিগারেশনে আপনার OAuth2 টোকেনগুলিকে অন্তর্ভুক্ত করলে, আপনি একটি API অনুরোধ করতে প্রস্তুত৷ এপিআই অনুরোধ করার জন্য লাইব্রেরি সঠিকভাবে কনফিগার করা হয়েছে তা পরীক্ষা করার একটি সহজ উপায়ের জন্য গেট ক্যাম্পেইনের উদাহরণ পড়ুন।
get_campaigns.py নমুনা চালানোর জন্য, আপনার স্থানীয়ভাবে ইনস্টল করা googleads-python ক্লায়েন্ট লাইব্রেরির রুট ডিরেক্টরিতে, নিম্নলিখিত কমান্ডটি চালান:
$ python examples/basic_operations/get_campaigns.py -c \
INSERT_YOUR_CUSTOMER_ID_HERE
অতিরিক্ত সম্পদ
আপনি একটি API অনুরোধ করতে সক্ষম হওয়ার পরে, ক্লায়েন্ট লাইব্রেরির এই ব্যবহারগুলিতে এগিয়ে যান: