পরিষেবা অ্যাকাউন্ট

সার্ভিস অ্যাকাউন্ট হলো বিশেষ গুগল অ্যাকাউন্ট যা অ্যাপ্লিকেশনগুলো OAuth 2.0-এর মাধ্যমে প্রোগ্রাম্যাটিকভাবে গুগল এপিআই (API) অ্যাক্সেস করার জন্য ব্যবহার করতে পারে। একটি সার্ভিস অ্যাকাউন্ট এমন একটি OAuth 2.0 ফ্লো ব্যবহার করে যার জন্য মানুষের অনুমোদনের প্রয়োজন হয় না। এর পরিবর্তে, এটি একটি কী ফাইল ব্যবহার করে যা শুধুমাত্র আপনার অ্যাপ্লিকেশনই অ্যাক্সেস করতে পারে। এই নির্দেশিকায় সার্ভিস অ্যাকাউন্ট ব্যবহার করে শপিং-এর কন্টেন্ট এপিআই (Content API) কীভাবে অ্যাক্সেস করা যায় তা আলোচনা করা হয়েছে।

দ্রষ্টব্য: প্রমাণীকরণের জন্য সার্ভিস অ্যাকাউন্ট ব্যবহারকারী অ্যাপ্লিকেশনগুলি শুধুমাত্র আপনার নিজের মার্চেন্ট সেন্টার অ্যাকাউন্ট অ্যাক্সেস করতে পারে। আপনি যদি এমন কোনো থার্ড-পার্টি অ্যাপ্লিকেশন তৈরি করেন যার আপনার ক্লায়েন্টদের মার্চেন্ট সেন্টার অ্যাকাউন্টে অ্যাক্সেসের প্রয়োজন, তাহলে অনুগ্রহ করে এর পরিবর্তে ‘অনুমোদন অনুরোধ’ (Authorizing Requests ) নির্দেশিকাটি দেখুন।

পূর্বশর্ত

• একটি মার্চেন্ট সেন্টার অ্যাকাউন্ট।

শপিং-এর জন্য কন্টেন্ট এপিআই অ্যাক্সেস করতে একটি সার্ভিস অ্যাকাউন্ট ব্যবহার করার ধাপসমূহ

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

      সার্ভিস অ্যাকাউন্টের জন্য ভূমিকা (role) নির্বাচন করা হলে কন্টেন্ট এপিআই-তে (Content API) কী ধরনের কল করা যাবে তার উপর কোনো প্রভাব পড়বে না, কারণ কন্টেন্ট এপিআই মেথডগুলিতে অ্যাক্সেস মার্চেন্ট সেন্টারে (Merchant Center) সার্ভিস অ্যাকাউন্ট আইডির (service account ID) সাথে যুক্ত ভূমিকার দ্বারা নির্ধারিত হয়। আপনি কী নির্বাচন করবেন সে সম্পর্কে অনিশ্চিত থাকলে, শুধু প্রজেক্ট > ভিউয়ার (Project > Viewer ) নির্বাচন করুন।

   7. আপনাকে সার্ভিস অ্যাকাউন্টস পৃষ্ঠায় নিয়ে যাওয়া হবে, যেখানে আপনি আপনার নতুন সার্ভিস অ্যাকাউন্টটি অ্যাক্সেস করতে পারবেন।
   8. একটি JSON প্রাইভেট কী পেতে, সার্ভিস অ্যাকাউন্টে ক্লিক করুন, তারপর KEYS ট্যাবে যান। ADD KEY > Create new key-তে ক্লিক করুন এবং তারপর কী-এর ধরন হিসেবে JSON নির্বাচন করুন। আপনার কম্পিউটারে প্রাইভেট কী-টি ডাউনলোড করতে CREATE-এ ক্লিক করুন।
2. নতুন সার্ভিস অ্যাকাউন্টটিকে আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টে একজন ব্যবহারকারী হিসেবে যুক্ত করুন। আপনি যদি একজন থার্ড-পার্টি ডেভেলপার হন, তাহলে এই ধাপটি আপনার ক্লায়েন্টকে দিয়ে করিয়ে নিতে হবে।
   1. আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টে যান।
   2. আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের সেটিংসে থাকা অ্যাকাউন্ট অ্যাক্সেস -এ যান।
   3. + ব্যবহারকারী যোগ করুন- এ ক্লিক করুন এবং নতুন ব্যবহারকারীর ইমেল ঠিকানা হিসেবে পরিষেবা অ্যাকাউন্ট আইডিটি ব্যবহার করুন।

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

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

প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী

আমি কি আমার সার্ভিস অ্যাকাউন্ট দিয়ে মার্চেন্ট সেন্টার UI-তে সাইন ইন করতে পারি?

না, সার্ভিস অ্যাকাউন্টগুলো সাধারণ গুগল অ্যাকাউন্ট নয় এবং এগুলো দিয়ে মার্চেন্ট সেন্টার UI অ্যাক্সেস করা যায় না।

আমাকে কত ঘন ঘন সার্ভিস অ্যাকাউন্ট অ্যাক্সেস টোকেন রিফ্রেশ করতে হবে?

গুগল OAuth 2.0 অথরাইজেশন সার্ভার থেকে ইস্যু করার এক ঘণ্টা পর অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে যায়। কোনো অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে, অ্যাপ্লিকেশনটির উচিত ক্লায়েন্ট লাইব্রেরি ব্যবহার করে আরেকটি অ্যাক্সেস টোকেন সংগ্রহ করা।