باستخدام 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 |