نقل حالات الحساب إلى حالات المنتجات المجمّعة

لقد تغيّرت طريقة استرداد الإحصاءات والمشاكل المجمّعة للمنتجات. تم الآن تقسيم الوظيفة التي كانت متوفّرة سابقًا في مورد 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 للطلب

وصف الطلب Content API for Shopping Merchant API
الحصول على إحصاءات المنتج والمشاكل المتعلّقة به GET /content/v2.1/{merchantId}/accountstatuses/{accountId} GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

المعرّفات

لقد تغيّرت طريقة تحديد الموارد لدعم البنية الجديدة.

تنسيق المعرّف

وصف المعرّف Content API for 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 الجديد.

Content API for 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.
السابق
Migrate accountstatuses to Account Issues
التالي
Migrate user and access management