لقد تغيّرت طريقة استرداد إحصاءات المنتجات والمشاكل المجمّعة. تم تقسيم الوظائف التي كانت متاحة سابقًا في المورد accountstatuses في Content API for Shopping إلى موارد مخصّصة في Merchant API. يشرح هذا الدليل كيفية نقل عملية الدمج لاستخدام
مورد aggregateProductStatuses
الجديد.
الاختلافات الرئيسية
في ما يلي الاختلافات الرئيسية بين ميزات حالة المنتج في 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. |