نقل إدارة المستخدمين وأذونات الوصول

في Content API for Shopping، كنت تدير المستخدمين وحقوق وصولهم من خلال حقل في مورِد Account يستبدل Merchant API هذا الحقل بمورِد مخصّص باسم User وطُرق مقابلة (إنشاء، وحذف، والحصول، وإدراج، ومسار). لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التحكّم في إذن الوصول إلى حسابك.

الاختلافات الرئيسية

مقارنةً بـ Content API for Shopping، يقدّم Merchant API المزايا التالية لإدارة المستخدمين:

  • مورِد مخصّص: يوفّر هذا المورِد طريقة أكثر دقة ومباشرة للتحكّم في المستخدمين الذين يمكنهم الوصول إلى حسابك على Merchant Center والإجراءات التي يمكنهم تنفيذها.
  • أسماء موارد متوافقة مع REST: في Merchant API، يتم تحديد موارد User من خلال اسم المورِد الكامل ، مثلاً accounts/12345/users/example@example.com.
  • me alias: يمكنك استخدام الاسم المستعار me بدلاً من عنوان بريد إلكتروني في اسم المورِد للإشارة إلى المستخدم الذي تم التحقّق من هويته، مثلاً accounts/12345/users/me.
  • حقوق وصول موحّدة: يوحّد Merchant API حقول الوصول المنطقية من Content API (مثلاً، admin وreportingManager) في حقل واحد قابل للتكرار هو access_rights.
  • دعوة المستخدم والتحقّق منه: يقدّم Merchant API حالة مستخدم صريحة (PENDING أو VERIFIED). عند إنشاء مستخدم جديد، تكون حالته PENDING إلى أن يقبل الدعوة. ويوفّر ذلك إمكانية الاطّلاع على حالة المستخدم في واجهة برمجة التطبيقات، وهو ما لم يكن متاحًا في Content API for Shopping. Add ## Requests

يستخدم 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 for Shopping وMerchant API.

وصف الطلب Content API for Shopping 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 for Shopping وMerchant API.

وصف المعرّف Content API for Shopping Merchant API
معرّف الحساب accountId account في accounts/{account}
معرّف المستخدِم email_address ضمن عنصر AccountUser email في accounts/{account}/users/{email}

الطُرق

يقارن الجدول التالي الطُرق بين Content API for Shopping وMerchant API.

Content API for Shopping Merchant API التوفّر والملاحظات
accounts.update users.create إنشاء مستخدم جديد لحساب
accounts.get users.get استرداد مستخدم واحد
accounts.get users.list إدراج جميع المستخدمين لحساب
accounts.update users.patch تعديل حقوق وصول مستخدم
accounts.update users.delete حذف مستخدم من حساب

التغييرات التفصيلية في الحقول

عدِّل استخدامك للحقول على النحو التالي:

Content API for Shopping 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