نقل عملية ربط الحساب

تطوّرت إدارة علاقات الحسابات من طريقة link واحدة في Content API for Shopping إلى نظام أكثر تفصيلاً ووضوحًا في Merchant API. تستخدم واجهة برمجة التطبيقات الجديدة موارد مخصّصة، مثل AccountRelationship وAccountService، لتحديد الخدمات المحدّدة التي يقدّمها حساب إلى حساب آخر. لمزيد من التفاصيل، يُرجى الاطّلاع على العلاقات بين الحسابات.

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

  • مراجع مخصّصة للعلاقات والخدمات: في Merchant API، يحدّد المرجع AccountRelationship العلاقة بين مقدّم الخدمة والتاجر، بينما يحدّد المرجع AccountService الخدمة المحدّدة المقدَّمة (على سبيل المثال accountAggregation). ويحلّ ذلك محلّ الحقلَين العامَين linkType وservices من Content API for Shopping.
  • طُرق الإجراءات الواضحة: بدلاً من طريقة link واحدة مع مَعلمة action، تستخدم Merchant API طُرقًا مميّزة لإدارة الخدمات، مثل propose وapprove وreject.
  • ربط مخصّص بـ "الملف التجاري على Google": أصبح الربط بـ "الملف التجاري على Google"، الذي كان يتم سابقًا من خلال ضبط الحقل googleMyBusinessLink، يتم الآن باستخدام طريقة مخصّصة، وهي gbpAccounts.linkGbpAccount.
  • إنشاء حساب عميل كخدمة: يتم الآن التعامل مع إنشاء حساب عميل ضمن حساب متقدّم على أنّه اقتراح خدمة accountAggregation باستخدام طريقة accounts.createAndConfigure. تتوفّر معلومات إضافية عن الحسابات على صفحة Merchant Accounts API. لا حاجة إلى المصافحة لأنّ المستخدم لديه إذن بالوصول إلى كلّ من الحساب المتقدّم وحساب العميل.

الطلبات

توفّر Merchant API نقاط نهاية محدّدة لإدارة أنواع مختلفة من روابط الحسابات والخدمات:

عناوين URL لطلبات البيانات من Merchant API

  • اقتراح خدمة جديدة: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • الموافقة على خدمة: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • رفض خدمة: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • رابط يؤدي إلى "الملف التجاري على Google": POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • إنشاء حساب عميل (رابط تجميع الحسابات): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

مقارنة عناوين URL الخاصة بالطلبات

وصف الطلب واجهة برمجة تطبيقات المحتوى في Shopping Merchant API
ربط الحسابات (مثل المنصات التابعة لجهات خارجية) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
الربط بـ "الملف التجاري على Google" ‫PUT .../v2.1/{merchantId}/accounts/{accountId} (مع الحقل googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
إنشاء حساب عميل POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

الطُرق

طريقة Content API for Shopping طريقة Merchant API التوفّر والملاحظات
accounts.link accountServices.propose استخدِم هذه الطريقة لبدء خدمة جديدة باستخدام حساب آخر.
‫accounts.link (باستخدام action: "approve") accountServices.approve استخدِم هذه الطريقة للموافقة على اقتراح خدمة في انتظار المراجعة.
‫accounts.link (باستخدام action: "remove") accountServices.reject استخدِم هذه الطريقة لرفض خدمة معلّقة أو تم إنشاؤها.
accounts.insert (لحسابات العملاء) accounts.createAndConfigure استخدِم هذه الطريقة مع خدمة accountAggregation لإنشاء حساب عميل جديد ضِمن حساب متقدّم.
‫accounts.update (باستخدام googleMyBusinessLink) gbpAccounts.linkGbpAccount استخدِم هذه الطريقة المخصّصة لربط حساب على Merchant Center بملف تجاري على Google.
‫accounts.update (باستخدام adsLinks) AccountRelationship مورد تتم إدارة الربط بـ "إعلانات Google" من واجهة مستخدم "إعلانات Google". يتم تمثيل الرابط الناتج على شكل AccountRelationship في Merchant API، ويمكن الاطّلاع عليه ولكن لا يمكن إنشاؤه مباشرةً.

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

واجهة برمجة تطبيقات المحتوى في Shopping Merchant API الوصف
AccountsLinkRequest.action طُرق propose وapprove وreject يتم استبدال الحقل action الفردي بطُرق مخصّصة في واجهة برمجة التطبيقات لكل تغيير في الحالة في دورة حياة الخدمة.
AccountsLinkRequest.linkType AccountService.service_type يتم استبدال السلسلة العامة linkType بحقل service_type من النوع oneof منظَّم ضمن المورد AccountService، مثل productsManagement أو accountAggregation
AccountsLinkRequest.services AccountService.service_type يتم الآن تمثيل قائمة الخدمات المستندة إلى السلاسل من خلال service_type المحدّد ضمن المرجع AccountService.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider يتم الآن تحديد معرّف الحساب الذي يقدّم الخدمة في الحقل provider من طلب propose.
Account.googleMyBusinessLink LinkGbpAccountRequest يتم استبدال العنصر الذي يحتوي على تفاصيل رابط "نشاطي التجاري على Google" برسالة طلب مخصّصة لطريقة linkGbpAccount.
Account.adsLinks AccountRelationship يتم تمثيل روابط "إعلانات Google" كمورد AccountRelationship حيث تكون قيمة provider هي providers/GOOGLE_ADS. تتم إدارة هذه العلاقة عادةً من واجهة مستخدم "إعلانات Google".