مهاجرت کاربر و مدیریت دسترسی

در Content API for Shopping، کاربران و حقوق دسترسی آنها را با فیلدی در منبع Account مدیریت کردید. Merchant API این را با منبع اختصاصی به نام User و روش‌های مربوطه (ایجاد، حذف، دریافت، فهرست، مسیر) جایگزین می‌کند. برای اطلاعات بیشتر، به کنترل دسترسی به حساب خود مراجعه کنید.

تفاوت های کلیدی

در مقایسه با Content API برای خرید، Merchant API مزایای زیر را برای مدیریت کاربر ارائه می دهد:

• منبع اختصاصی : این یک روش دقیق و مستقیم برای کنترل افرادی که می توانند به حساب Merchant Center شما دسترسی داشته باشند و کارهایی که می توانند انجام دهند ارائه می دهد.
• نام‌های منابع RESTful : در Merchant API، منابع User را با نام کامل منبع شناسایی کنید، برای مثال accounts/12345/users/[e-mail] .
• نام مستعار me : می توانید از نام مستعار me به جای آدرس ایمیل در نام منبع برای مراجعه به کاربر تأیید شده استفاده کنید، به عنوان مثال، accounts/12345/users/me .
• حقوق دسترسی تلفیقی : Merchant API فیلدهای دسترسی بولی را از Content API (به عنوان مثال، admin ، reportingManager ) در یک فیلد access_rights تکرارپذیر یکپارچه می کند.
• دعوت و تأیید کاربر : Merchant API یک وضعیت کاربر صریح ( PENDING یا VERIFIED ) را معرفی می کند. وقتی کاربر جدیدی ایجاد می‌کنید، تا زمانی که دعوت را نپذیرد، در وضعیت PENDING هستند. این امکان مشاهده API را در وضعیت کاربر فراهم می کند، که در Content API برای خرید در دسترس نبود. ## درخواست اضافه کنید

Merchant API از URL های درخواست زیر برای مدیریت کاربران استفاده می کند:

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

جدول زیر URL های درخواست را بین Content API برای خرید و Merchant API مقایسه می کند.

درخواست توضیحات	Content API برای خرید	Merchant 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}

شناسه ها

جدول زیر شناسه‌های مورد استفاده در درخواست‌ها را بین Content API برای خرید و Merchant API مقایسه می‌کند.

شرح شناسه	Content API برای خرید	Merchant API
شناسه حساب	accountId	account در accounts/{account}
شناسه کاربری	email_address در شیء AccountUser	email در accounts/{account}/users/{email}

روش ها

جدول زیر روش‌های بین Content API برای خرید و Merchant API را مقایسه می‌کند.

Content API برای خرید	Merchant API	در دسترس بودن و یادداشت ها
accounts.update	users.create	یک کاربر جدید برای یک حساب کاربری ایجاد می کند.
accounts.get	users.get	یک کاربر را بازیابی می کند.
accounts.get	users.list	همه کاربران را برای یک حساب فهرست می کند.
accounts.update	users.update	حقوق دسترسی کاربر را به روز می کند.
accounts.update	users.delete	یک کاربر را از یک حساب حذف می کند.

تغییرات میدان دقیق

استفاده از فیلدها را به صورت زیر به روز کنید:

Content API برای خرید	Merchant API	توضیحات
users ( AccountUser مکرر)	users ( User مکرر)	منبع User اکنون یک منبع سطح بالا با خدمات خاص خود است.
AccountUser.email_address	CreateUserRequest.user_id و بخشی از User.name	آدرس ایمیل کاربر اکنون بخشی از نام منبع است. در حین ایجاد آن را در قسمت user_id مشخص کنید.
AccountUser.admin	access_rights: "ADMIN"	Merchant API فیلد admin بولی را با مقدار ADMIN در فهرست access_rights جایگزین می‌کند.
AccountUser.order_manager , AccountUser.payments_manager , AccountUser.payments_analyst	access_rights: "STANDARD"	Merchant 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 .