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। -
mealias : আপনি প্রমাণীকৃত ব্যবহারকারীকে নির্দেশ করার জন্য রিসোর্স নামে ইমেল ঠিকানার পরিবর্তেmealias-টি ব্যবহার করতে পারেন, উদাহরণস্বরূপ,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 )। |