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

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

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

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

  • منبع اختصاصی : این یک روش دقیق و مستقیم برای کنترل افرادی که می توانند به حساب Merchant Center شما دسترسی داشته باشند و کارهایی که می توانند انجام دهند ارائه می دهد.
  • نام‌های منابع RESTful : در Merchant API، منابع User را با نام کامل منبع شناسایی کنید، برای مثال accounts/12345/users/example@example.com .
  • نام مستعار 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/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}

جدول زیر 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 .
قبلی
Migrate accountstatuses to Aggregate Product Statuses
بعدی
Migrate homepage management