باستخدام Content API for Shopping، يمكنك استخدام المرجع merchantsupport لإنشاء صفحة بيانات تشخيص داخل التطبيق للتجّار. توفّر Merchant API ميزة "حلّ المشاكل" التي تتيح الوظائف نفسها.
نظرة عامة
عند الترحيل من Content API، يجب مراعاة التغييرات التالية في أسماء الخدمات وطُرق الإعداد وبنيتها:
- التغيير الأهم في استجابة واجهة برمجة التطبيقات هو دمج العنصرَين
AccountIssueوProductIssueفي عنصر واحد هوRenderedIssue، ما سيؤدي إلى تبسيط الرمز البرمجي من خلال توفير بنية متسقة لجميع أنواع المشاكل. - تعيد Merchant API تسمية الحقل
issuesليصبحrendered_issues.
المعرّفات
غيِّر معرّفات Content API على النحو التالي لواجهة Merchant API.
| الطريقة | واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API |
|---|---|---|
renderaccountissues |
{merchant_id} |
accounts/{ACCOUNT_ID} |
renderproductissues |
{PRODUCT_ID} |
accounts/{ACCOUNT_ID}/products/{PRODUCT_ID} |
TriggerAction |
{merchant_id} |
accounts/{ACCOUNT_ID} |
الطلبات
غيِّر طلبات Content API على النحو التالي لتتوافق مع Merchant API.
| الإجراء | واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API |
|---|---|---|
| عرض المشاكل على مستوى الحساب |
POST https://shoppingcontent.googleapis.com/content/v2.1/MERCHANT_ID/merchantsupport/renderaccountissues
|
POST https://merchantapi.googleapis.com/issueresolution/v1/accounts/ACCOUNT_ID:renderaccountissues
|
| مشاكل العرض المتعلّقة بمنتج |
POST https://shoppingcontent.googleapis.com/content/v2.1/MERCHANT_ID/merchantsupport/renderproductissues/PRODUCT_ID
|
POST https://merchantapi.googleapis.com/issueresolution/v1/accounts/ACCOUNT_ID/products/PRODUCT_ID:renderproductissues
|
| إجراء التشغيل |
POST https://shoppingcontent.googleapis.com/content/v2.1/MERCHANT_ID/merchantsupport/triggeraction
|
https://merchantapi.googleapis.com/issueresolution/v1/accounts/ACCOUNT_ID:triggeraction
|
التغيير الأهم في استجابة واجهة برمجة التطبيقات هو دمج العنصرَين
AccountIssue وProductIssue في عنصر RenderedIssue واحد،
ما سيؤدي إلى تبسيط الرمز البرمجي من خلال توفير بنية متسقة لجميع أنواع المشاكل.
الحقول التي تمّت إعادة تسميتها
الاسم الجديد للحقل issues ذي المستوى الأعلى في الرد هو renderedIssues، وهو يحتوي على قائمة بعناصر RenderedIssue.
| واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API |
|---|---|
issues |
renderedIssues |
النماذج التي تمت إعادة تسميتها
| واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API |
|---|---|
|
RenderedIssue |