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

في 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.

وصف الطلب واجهة برمجة تطبيقات المحتوى في 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.

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

الطُرق

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

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

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

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

واجهة برمجة تطبيقات المحتوى في 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