ব্যবহারকারী এবং অ্যাক্সেস ব্যবস্থাপনা স্থানান্তর করুন

Content API for Shopping-এ, আপনি Account রিসোর্সের একটি ফিল্ডের মাধ্যমে ব্যবহারকারী এবং তাদের অ্যাক্সেস রাইটস পরিচালনা করতেন। Merchant API এটিকে User নামক একটি ডেডিকেটেড রিসোর্স এবং সংশ্লিষ্ট মেথড (create, delete, get, list, path) দ্বারা প্রতিস্থাপন করেছে। আরও তথ্যের জন্য, Control access to your account দেখুন।

মূল পার্থক্য

শপিং-এর জন্য কন্টেন্ট এপিআই-এর তুলনায়, ব্যবহারকারী ব্যবস্থাপনার ক্ষেত্রে মার্চেন্ট এপিআই নিম্নলিখিত সুবিধাগুলো প্রদান করে:

  • নির্দিষ্ট রিসোর্স : এর মাধ্যমে আরও সুনির্দিষ্ট ও সরাসরিভাবে নিয়ন্ত্রণ করা যায় যে, কারা আপনার মার্চেন্ট সেন্টার অ্যাকাউন্ট অ্যাক্সেস করতে পারবে এবং তারা কী করতে পারবে।
  • RESTful রিসোর্স নাম : মার্চেন্ট এপিআই-তে, User রিসোর্সগুলোকে একটি সম্পূর্ণ রিসোর্স নাম দিয়ে শনাক্ত করুন, যেমন, accounts/12345/users/example@example.com
  • me alias : আপনি প্রমাণীকৃত ব্যবহারকারীকে নির্দেশ করার জন্য রিসোর্স নামে ইমেল ঠিকানার পরিবর্তে me alias-টি ব্যবহার করতে পারেন, উদাহরণস্বরূপ, accounts/12345/users/me
  • সমন্বিত অ্যাক্সেস অধিকার : মার্চেন্ট এপিআই, কন্টেন্ট এপিআই থেকে বুলিয়ান অ্যাক্সেস ফিল্ডগুলিকে (যেমন, admin , reportingManager ) একটি একক, পুনরাবৃত্তিযোগ্য access_rights ফিল্ডে একত্রিত করে।
  • ব্যবহারকারীর আমন্ত্রণ এবং যাচাইকরণ : মার্চেন্ট এপিআই একটি সুস্পষ্ট ব্যবহারকারী অবস্থা ( PENDING বা VERIFIED ) চালু করেছে। যখন আপনি একজন নতুন ব্যবহারকারী তৈরি করেন, আমন্ত্রণটি গ্রহণ না করা পর্যন্ত তারা PENDING অবস্থায় থাকে। এটি ব্যবহারকারীর অবস্থা সম্পর্কে এপিআই-এর মাধ্যমে দেখার সুযোগ করে দেয়, যা শপিং-এর জন্য কন্টেন্ট এপিআই-তে উপলব্ধ ছিল না। ##টি অনুরোধ যোগ করুন

মার্চেন্ট এপিআই ব্যবহারকারীদের পরিচালনা করতে নিম্নলিখিত রিকোয়েস্ট ইউআরএলগুলো ব্যবহার করে:

  • GET /accounts/v1/accounts/{account}/users/{email}
  • GET /accounts/v1/accounts/{account}/users
  • POST /accounts/v1/accounts/{account}/users
  • PATCH /accounts/v1/accounts/{account}/users/{email}
  • DELETE /accounts/v1/accounts/{account}/users/{email}

নিম্নলিখিত সারণিতে শপিং-এর জন্য কন্টেন্ট এপিআই এবং মার্চেন্ট এপিআই-এর অনুরোধ ইউআরএলগুলোর তুলনা করা হয়েছে।

অনুরোধের বিবরণ কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই
একটি অ্যাকাউন্টের জন্য ব্যবহারকারী পান GET {api_version}/{merchantId}/accounts/{accountId} GET {api_version}/accounts/{account}/users
একজন ব্যবহারকারী তৈরি করুন PATCH {api_version}/{merchantId}/accounts/{accountId} POST {api_version}/accounts/{account}/users
একজন ব্যবহারকারীকে আপডেট করুন PATCH {api_version}/{merchantId}/accounts/{accountId} PATCH {api_version}/accounts/{account}/users/{email}
একজন ব্যবহারকারীকে মুছে ফেলুন PATCH {api_version}/{merchantId}/accounts/{accountId} DELETE {api_version}/accounts/{account}/users/{email}

শনাক্তকারী

নিম্নলিখিত সারণিতে শপিং-এর জন্য কন্টেন্ট এপিআই এবং মার্চেন্ট এপিআই-এর অনুরোধে ব্যবহৃত আইডেন্টিফায়ারগুলোর তুলনা করা হয়েছে।

শনাক্তকারী বিবরণ কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই
অ্যাকাউন্ট শনাক্তকারী accountId accounts/{account} -এ account
ব্যবহারকারী শনাক্তকারী AccountUser অবজেক্টের মধ্যে email_address accounts/{account}/users/{email}email

পদ্ধতি

নিম্নলিখিত সারণিতে শপিং-এর জন্য কন্টেন্ট এপিআই এবং মার্চেন্ট এপিআই-এর পদ্ধতিগুলোর মধ্যে তুলনা করা হয়েছে।

কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই প্রাপ্যতা ও নোট
accounts.update users.create একটি অ্যাকাউন্টের জন্য নতুন ব্যবহারকারী তৈরি করে।
accounts.get users.get একজন ব্যবহারকারীকে খুঁজে বের করে।
accounts.get users.list একটি অ্যাকাউন্টের সকল ব্যবহারকারীর তালিকা দেখায়।
accounts.update users.update ব্যবহারকারীর প্রবেশাধিকার হালনাগাদ করে।
accounts.update users.delete অ্যাকাউন্ট থেকে একজন ব্যবহারকারীকে মুছে ফেলে।

বিস্তারিত ক্ষেত্রের পরিবর্তন

আপনার ফিল্ড ব্যবহারের ধরণ নিম্নরূপে হালনাগাদ করুন:

কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই বর্ণনা
users (পুনরাবৃত্ত AccountUser ) users (পুনরাবৃত্ত User ) User রিসোর্সটি এখন নিজস্ব সার্ভিসসহ একটি টপ-লেভেল রিসোর্স।
AccountUser.email_address CreateUserRequest.user_id এবং User.name এর অংশবিশেষ ব্যবহারকারীর ইমেল ঠিকানা এখন রিসোর্স নামের একটি অংশ। তৈরির সময় user_id ফিল্ডে এটি উল্লেখ করুন।
AccountUser.admin access_rights: "ADMIN" মার্চেন্ট এপিআই access_rights enum-এর boolean admin ফিল্ডটিকে ADMIN ভ্যালু দ্বারা প্রতিস্থাপন করে।
AccountUser.order_manager , AccountUser.payments_manager , AccountUser.payments_analyst access_rights: "STANDARD" মার্চেন্ট এপিআই এই রোলগুলোকে STANDARD অ্যাক্সেস রাইট দ্বারা প্রতিস্থাপন করে।
AccountUser.reporting_manager access_rights: "PERFORMANCE_REPORTING" reporting_manager রোলটি এখন PERFORMANCE_REPORTING অ্যাক্সেস রাইট।
AccountUser.read_only access_rights: "READ_ONLY" read_only রোলটি এখন READ_ONLY অ্যাক্সেস রাইট।
উপলব্ধ নয় User.name এতে ব্যবহারকারীর সম্পূর্ণ রিসোর্স নামটি থাকে, উদাহরণস্বরূপ, accounts/{account}/users/{email}
উপলব্ধ নয় User.state ব্যবহারকারীর আমন্ত্রণের অবস্থা নির্দেশ করে, যা হয় PENDING অথবা VERIFIED )।