لقد تغيّرت الطريقة التي تستردّ بها الإحصاءات والمشاكل المجمّعة المتعلّقة بالمنتجات. تم الآن تقسيم الوظائف التي كانت متوفّرة سابقًا في المرجع accountstatuses ضمن Content API for Shopping إلى مراجع مخصّصة في Merchant API. يشرح هذا الدليل كيفية نقل عملية الدمج لاستخدام المورد الجديد
aggregateProductStatuses.
ملاحظة: في Merchant API، يتم تقسيم المشاكل على مستوى الحساب وحالات المنتجات المجمّعة. يمكنك أيضًا مراجعة دليلنا حول نقل البيانات من accountstatuses إلى
مشاكل الحساب.
الاختلافات الرئيسية
في ما يلي الاختلافات الرئيسية بين ميزات حالة المنتج في Content API for Shopping وMerchant API:
- مراجع مخصّصة: تم الآن تقسيم المرجع
accountstatusesمن Content API for Shopping. في Merchant API، تتوفّر المشاكل على مستوى الحساب من خلال الموردaccountissues، بينما تتوفّر إحصاءات المنتجات المجمّعة والمشاكل على مستوى السلعة من خلال المورد الجديدaggregateProductStatuses. - بنية المورد الجديد:
AggregateProductStatusهو مورد جديد يمثّل الإحصاءات والمشاكل الخاصة بمجموعة معيّنة من سياق إعداد التقارير وبلد. - آلية الفلترة: بدلاً من استخدام مَعلمات طلب البحث مثل
destinationsلاختيار البيانات، تستخدم Merchant API الطريقةlistمع السلسلةfilterلطلب البحث عن سياقات وتقارير وبلدان معيّنة. - إزالة حقل القناة: لم يعُد الحقل
channelمستخدَمًا. أصبحت هذه المعلومات الآن جزءًا ضمنيًا منreportingContext.
الطلبات
تستخدم Merchant API طلب GET مع المَعلمة filter لاسترداد حالات المنتجات المجمّعة.
GET
https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
تنسيق عنوان URL الخاص بالطلب
| وصف الطلب | واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API |
|---|---|---|
| الحصول على إحصاءات ومشاكل المنتجات | GET /content/v2.1/{merchantId}/accountstatuses/{accountId} |
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses |
المعرّفات
تغيّرت طريقة تحديد المراجع لتتوافق مع البنية الجديدة.
تنسيق المعرّف
| وصف المعرّف | واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API |
|---|---|---|
| معرّف المورد | تم تحديد المرجع من خلال accountId. تم اختيار شرائح بيانات محدّدة باستخدام مَعلمات طلب البحث. |
يحدّد اسم المورد البيانات بشكل فريد لسياق تقارير وبلد معيّنَين: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}. |
الطُرق
تم تعديل طريقة استرداد حالات المنتجات إلى طريقة list
تتيح الفلترة.
| طريقة Content API for Shopping | طريقة Merchant API | التوفّر والملاحظات |
|---|---|---|
accountstatuses.get |
aggregateProductStatuses.list |
عرضت الطريقة accountstatuses.get موردًا واحدًا يحتوي على جميع إحصاءات المنتجات. تعرض طريقة aggregateProductStatuses.list الجديدة قائمة بالموارد، مورد واحد لكل تركيبة من سياق إعداد التقارير والبلد. استخدِم المَعلمة filter لاسترداد بيانات معيّنة. بالنسبة إلى المشاكل على مستوى الحساب، استخدِم accountissues.list. |
تغييرات الحقول التفصيلية
تم تعديل حقول إحصاءات المنتجات والمشاكل وإعادة هيكلتها
في المرجع الجديد AggregateProductStatus.
| واجهة برمجة تطبيقات المحتوى في Shopping | Merchant API | الوصف |
|---|---|---|
products |
aggregate_product_statuses |
يتم استبدال مصفوفة products بالحقل المتكرّر aggregate_product_statuses في ردّ القائمة. |
destination |
reporting_context |
تم استبدال الحقل destination بالحقل reporting_context الذي يحدّد سياق البرنامج للإحصاءات. |
channel |
(ما مِن حقل مكافئ) | تتم إزالة الحقل channel. أصبحت هذه المعلومات الآن جزءًا من reporting_context. |
statistics |
stats |
تمت إعادة تسمية العنصر statistics إلى stats. يتم تحويل أسماء الحقول داخلها إلى snake_case، على سبيل المثال، أصبح activeCount الآن active_count. |
itemLevelIssues.servability |
item_level_issues.severity |
تم استبدال التعداد servability بالتعداد severity لوصف تأثير المشكلة. |
itemLevelIssues.attributeName |
item_level_issues.attribute |
تمت إعادة تسمية الحقل attributeName إلى attribute. |
itemLevelIssues.documentation |
item_level_issues.documentation_uri |
تمت إعادة تسمية الحقل documentation إلى documentation_uri. |
itemLevelIssues.numItems |
item_level_issues.product_count |
تمت إعادة تسمية الحقل numItems إلى product_count. |