একটি ক্লায়েন্ট লাইব্রেরি সেট আপ করুন

শপিং-এর জন্য কন্টেন্ট এপিআই সেট আপ করতে আমরা গুগল এপিআই ক্লায়েন্ট লাইব্রেরি ব্যবহার করার পরামর্শ দিই। এই নির্দেশিকায় উদাহরণ হিসেবে পাইথন কন্টেন্ট এপিআই ক্লায়েন্ট লাইব্রেরি ব্যবহার করা হয়েছে, কিন্তু এগুলো অনেক জনপ্রিয় প্রোগ্রামিং ভাষার জন্য উপলব্ধ এবং প্রমাণীকরণ, অনুরোধ পাঠানো ও প্রতিক্রিয়া পার্স করার মতো সাধারণ এপিআই কাজগুলোকে সহজ করে তোলে। অন্যান্য ভাষার জন্য ক্লায়েন্ট লাইব্রেরি সেট আপ করার বিষয়ে সাহায্যের জন্য, গিটহাবে googleads/googleads-shopping-samples রিপো-এর মধ্যে থাকা সেই ভাষার README.md ফাইলটি দেখুন।

দ্রষ্টব্য: পাইথনে নমুনা কোডটি ব্যবহার করার জন্য আপনাকে বেশ কিছু প্রয়োজনীয় লাইব্রেরি ইনস্টল করতে হবে। এই কারণে, আমরা আপনাকে কাজ শুরু করার আগে একটি পাইথন ভার্চুয়াল এনভায়রনমেন্ট তৈরি করার পরামর্শ দিচ্ছি। আরও তথ্যের জন্য, “pip এবং ভার্চুয়াল এনভায়রনমেন্ট ব্যবহার করে প্যাকেজ ইনস্টল করা” দেখুন।

পাইথনের জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরি সেট আপ করতে, নিম্নলিখিত ধাপগুলি সম্পন্ন করুন:

1. ক্লায়েন্ট লাইব্রেরির কনফিগারেশন এবং অথেনটিকেশন ফাইলগুলির জন্য একটি ডিরেক্টরি তৈরি করুন। আপনার হোম ডিরেক্টরির মধ্যে নিম্নলিখিত ডিরেক্টরিগুলি তৈরি করুন:

   ~/shopping-samples/content/

   দ্রষ্টব্য: এই পাথটি, এবং সেইসাথে ধাপ ৫-এ তৈরি করা merchant-info.json ফাইলের নাম, ধাপ ৭-এ ডাউনলোড করা Content API samples ডিরেক্টরির মধ্যে থাকা python/shopping/content/common.py ফাইলে সংজ্ঞায়িত করা আছে।

2. আপনার পরিষেবা অ্যাকাউন্টের পরিচয়পত্র ডাউনলোড করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

   1. গুগল এপিআই লাইব্রেরিতে যান।
   2. পৃষ্ঠার উপরের মেনু থেকে একটি প্রজেক্ট বেছে নিন। যদি আপনার এখনও কোনো প্রজেক্ট না থাকে, তাহলে ‘নতুন প্রজেক্ট’ (New project) এ ক্লিক করে একটি তৈরি করুন।
   3. আপনি যদি এই প্রজেক্টের জন্য শপিং-এর কন্টেন্ট এপিআই আগে থেকে চালু না করে থাকেন, তাহলে গুগল এপিআই-এর তালিকা থেকে এটি খুঁজে বের করে চালু করুন।
   4. উপরের বাম দিকের নেভিগেশন মেনুতে (☰) ক্লিক করুন, APIs & Services নির্বাচন করুন, এবং তারপরে Credentials নির্বাচন করুন।
   5. একটি পরিষেবা অ্যাকাউন্ট সেট আপ করতে, 'Create credentials' নির্বাচন করুন এবং তারপরে 'Service account' নির্বাচন করুন।
   6. নতুন সার্ভিস অ্যাকাউন্টটির একটি নাম দিন। এটি সার্ভিস অ্যাকাউন্ট আইডির জন্য ডিফল্ট ইউজারনেম হিসেবেও কাজ করবে। পরবর্তী ব্যবহারের জন্য '@' চিহ্নের পরের অংশসহ সার্ভিস অ্যাকাউন্ট আইডিটি লিখে রাখুন। 'Create'-এ ক্লিক করুন, এরপর প্রজেক্ট এবং ইউজারদের অ্যাক্সেস দেওয়ার ঐচ্ছিক ধাপগুলো সম্পন্ন করুন এবং 'Done'-এ ক্লিক করুন।
   7. আপনাকে সার্ভিস অ্যাকাউন্টস পৃষ্ঠায় নিয়ে যাওয়া হবে, যেখানে আপনি আপনার নতুন সার্ভিস অ্যাকাউন্টটি অ্যাক্সেস করতে পারবেন।

3. একটি JSON প্রাইভেট কী পেতে, সার্ভিস অ্যাকাউন্টে ক্লিক করুন, তারপর Keys ট্যাবে যান। Add key > Create new key-তে ক্লিক করুন এবং তারপর কী-এর ধরন হিসেবে JSON নির্বাচন করুন। আপনার কম্পিউটারে প্রাইভেট কী-টি ডাউনলোড করতে Create-এ ক্লিক করুন। নতুন কী-টি স্বয়ংক্রিয়ভাবে ডাউনলোড হয়ে যাবে।

4. ডাউনলোড করা ক্রেডেনশিয়াল ফাইলটির নাম পরিবর্তন করে service-account.json রাখুন।

   দ্রষ্টব্য: এই ফাইলের নামটি _constants.py ফাইলে সংজ্ঞায়িত করা আছে, যা ৭ নং ধাপে ডাউনলোড করা Content API samples ডিরেক্টরির অন্তর্গত python/shopping/content/ ফোল্ডারে অবস্থিত।

5. service-account.json ফাইলটি আপনার home directory /shopping-samples/content/ -এ সরিয়ে নিন।

6. আপনার home directory /shopping-samples/content/ -এ একটি খালি merchant-info.json ফাইল তৈরি করুন।

7. merchant-info.json ফাইলে নিম্নলিখিত লেখাটি যোগ করুন:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. নতুন সার্ভিস অ্যাকাউন্টটিকে আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টে একজন ব্যবহারকারী হিসেবে যুক্ত করুন। আপনি যদি একজন থার্ড-পার্টি ডেভেলপার হন, তাহলে এই ধাপটি আপনার ক্লায়েন্টকে দিয়ে করিয়ে নিতে হবে।

   1. আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টে যান।
   2. আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের সেটিংসে, 'People' নির্বাচন করুন এবং 'access' এ ক্লিক করুন।

   3. + ব্যক্তি যোগ করুন- এ ক্লিক করুন এবং নতুন ব্যবহারকারীর ইমেল ঠিকানা হিসেবে পরিষেবা অ্যাকাউন্ট আইডিটি ব্যবহার করুন।

      দ্রষ্টব্য: আপনি যদি আগে সার্ভিস অ্যাকাউন্ট আইডিটি লিখে না রাখেন, তাহলে সার্ভিস অ্যাকাউন্টস অ্যাডমিনিস্ট্রেশন পেজে যান এবং আপনার তৈরি করা প্রজেক্টটি নির্বাচন করুন।

   4. Accounts পরিষেবাটি ব্যবহার করার জন্য অ্যাডমিন অ্যাক্সেস প্রয়োজন, তাই অ্যাডমিন নির্বাচন করুন।

   5. পছন্দগুলি সংরক্ষণ করতে এবং ব্যবহারকারীদের তালিকায় ফিরে যেতে 'ব্যবহারকারী যোগ করুন'- এ ক্লিক করুন। পরিষেবা অ্যাকাউন্ট আইডিটি নির্বাচিত ব্যবহারকারীর ভূমিকার সাথে তালিকাভুক্ত থাকে।

   6. আপনি যোগ করতে চান এমন অন্য সমস্ত পরিষেবা অ্যাকাউন্টের জন্য প্রক্রিয়াটি পুনরাবৃত্তি করুন।

9. googleads/googleads-shopping-samples গিটহাব রিপোটি আপনার কম্পিউটারের যেকোনো স্থানে ক্লোন করুন (অথবা ডাউনলোড করে আনজিপ করুন); এটি আপনার হোম ডিরেক্টরিতে বা ~/shopping-samples/content/ ফোল্ডারে থাকার কোনো প্রয়োজন নেই।

10. আপনি যদি রিপোটি ক্লোন না করে ডাউনলোড ও আনজিপ করে থাকেন, তাহলে আনজিপ করা ডিরেক্টরিটির নাম পরিবর্তন করে googleads-shopping-samples রাখুন।

11. প্রয়োজনীয় স্যাম্পল ডিপেন্ডেন্সিগুলো ইনস্টল করতে, একটি টার্মিনাল উইন্ডোতে googleads-shopping-samples/python/ ফোল্ডারে যান এবং নিম্নলিখিত কমান্ডটি চালান:

    pip install -r requirements.txt
    

আপনার পাইথনের জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরিটি এখন কনফিগার করা আছে এবং কন্টেন্ট এপিআই-এর সাথে ব্যবহারের জন্য প্রস্তুত। পরবর্তী অংশে, আপনি একটি নতুন পণ্য যুক্ত করার জন্য একটি অনুরোধ তৈরি করে পাঠাবেন।