Content API for Shopping-এ, আপনি Account রিসোর্সের একটি ফিল্ড ব্যবহার করে ব্যবহারকারী এবং তাদের অ্যাক্সেস অধিকার পরিচালনা করেছেন। Merchant API এটিকে User এবং সংশ্লিষ্ট পদ্ধতি (তৈরি, মুছে ফেলা, পান, তালিকাভুক্ত, পথ) নামক ডেডিকেটেড রিসোর্স দিয়ে প্রতিস্থাপন করে। আরও তথ্যের জন্য, আপনার অ্যাকাউন্টে অ্যাক্সেস নিয়ন্ত্রণ করুন দেখুন।
মূল পার্থক্য
শপিংয়ের জন্য কন্টেন্ট এপিআইয়ের তুলনায়, মার্চেন্ট এপিআই ব্যবহারকারী ব্যবস্থাপনার জন্য নিম্নলিখিত সুবিধাগুলি প্রদান করে:
- নিবেদিতপ্রাণ রিসোর্স : এটি আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টে কারা অ্যাক্সেস করতে পারবে এবং তারা কী করতে পারবে তা নিয়ন্ত্রণ করার জন্য আরও সুক্ষ্ম এবং সরাসরি উপায় প্রদান করে।
- RESTful রিসোর্স নাম : Merchant API-তে,
Userরিসোর্সগুলিকে একটি সম্পূর্ণ রিসোর্স নাম দিয়ে শনাক্ত করুন, উদাহরণস্বরূপ,accounts/12345/users/example@example.com। -
mealias : আপনি প্রমাণিত ব্যবহারকারীকে উল্লেখ করার জন্য রিসোর্সের নামের মধ্যে ইমেল ঠিকানার পরিবর্তেmealias ব্যবহার করতে পারেন, উদাহরণস্বরূপ,accounts/12345/users/me। - একীভূত অ্যাক্সেস অধিকার : মার্চেন্ট API কন্টেন্ট API (উদাহরণস্বরূপ,
admin,reportingManager) থেকে বুলিয়ান অ্যাক্সেস ক্ষেত্রগুলিকে একটি একক, পুনরাবৃত্তিযোগ্যaccess_rightsক্ষেত্রে একত্রিত করে। - ব্যবহারকারীর আমন্ত্রণ এবং যাচাইকরণ : মার্চেন্ট API একটি স্পষ্ট ব্যবহারকারীর অবস্থা (
PENDINGবাVERIFIED) প্রবর্তন করে। যখন আপনি একটি নতুন ব্যবহারকারী তৈরি করেন, তখন তারা আমন্ত্রণ গ্রহণ না করা পর্যন্ত একটিPENDINGঅবস্থায় থাকে। এটি ব্যবহারকারীর অবস্থা সম্পর্কে API দৃশ্যমানতা প্রদান করে, যা শপিংয়ের জন্য সামগ্রী API তে উপলব্ধ ছিল না। ## অনুরোধ যোগ করুন
ব্যবহারকারীদের পরিচালনা করার জন্য মার্চেন্ট এপিআই নিম্নলিখিত অনুরোধ URL গুলি ব্যবহার করে:
-
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}
নিম্নলিখিত টেবিলটি শপিংয়ের জন্য কন্টেন্ট এপিআই এবং মার্চেন্ট এপিআইয়ের মধ্যে অনুরোধের ইউআরএলগুলির তুলনা করে।
| অনুরোধের বিবরণ | কেনাকাটার জন্য কন্টেন্ট API | মার্চেন্ট এপিআই |
|---|---|---|
| একটি অ্যাকাউন্টের জন্য ব্যবহারকারীদের পান | 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} |
শনাক্তকারী
নিম্নলিখিত টেবিলটি শপিংয়ের জন্য কন্টেন্ট এপিআই এবং মার্চেন্ট এপিআইয়ের মধ্যে অনুরোধগুলিতে ব্যবহৃত শনাক্তকারীগুলির তুলনা করে।
| শনাক্তকারীর বর্ণনা | কেনাকাটার জন্য কন্টেন্ট API | মার্চেন্ট এপিআই |
|---|---|---|
| অ্যাকাউন্ট শনাক্তকারী | accountId | অ্যাকাউন্টে account accounts/{account} |
| ব্যবহারকারী শনাক্তকারী | AccountUser অবজেক্টের মধ্যে email_address | accounts/{account}/users/{email} -এ email |
পদ্ধতি
নিম্নলিখিত টেবিলটি শপিংয়ের জন্য কন্টেন্ট এপিআই এবং মার্চেন্ট এপিআইয়ের মধ্যে পদ্ধতিগুলির তুলনা করে।
| কেনাকাটার জন্য কন্টেন্ট API | মার্চেন্ট এপিআই | প্রাপ্যতা এবং নোট |
|---|---|---|
accounts.update | users.create | একটি অ্যাকাউন্টের জন্য একটি নতুন ব্যবহারকারী তৈরি করে। |
accounts.get | users.get | একজন একক ব্যবহারকারীকে উদ্ধার করে। |
accounts.get | users.list | একটি অ্যাকাউন্টের জন্য সকল ব্যবহারকারীর তালিকা তৈরি করে। |
accounts.update | users.update | ব্যবহারকারীর অ্যাক্সেস অধিকার আপডেট করে। |
accounts.update | users.delete | একটি অ্যাকাউন্ট থেকে একজন ব্যবহারকারীকে মুছে ফেলে। |
বিস্তারিত ক্ষেত্রের পরিবর্তন
আপনার ক্ষেত্রের ব্যবহার নিম্নরূপ আপডেট করুন:
| কেনাকাটার জন্য কন্টেন্ট API | মার্চেন্ট এপিআই | বিবরণ |
|---|---|---|
users (পুনরাবৃত্ত AccountUser ) | users (পুনরাবৃত্ত User ) | User সম্পদ এখন নিজস্ব পরিষেবা সহ একটি শীর্ষ-স্তরের সম্পদ। |
AccountUser.email_address | CreateUserRequest.user_id এবং User.name এর অংশ | ব্যবহারকারীর ইমেল ঠিকানা এখন রিসোর্স নামের অংশ। তৈরির সময় user_id ক্ষেত্রে এটি উল্লেখ করুন। |
AccountUser.admin | access_rights: "ADMIN" | মার্চেন্ট API access_rights enum-এ বুলিয়ান admin ফিল্ডকে ADMIN মান দ্বারা প্রতিস্থাপন করে। |
AccountUser.order_manager , AccountUser.payments_manager , AccountUser.payments_analyst | access_rights: "STANDARD" | মার্চেন্ট API এই ভূমিকাগুলিকে 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 । |