ملاحظات إصدار Merchant Reports API

الأسبوع الذي يبدأ في 19 أكتوبر 2026

أصبح بإمكانك الآن الاستعلام عن ucp_agentic_performance_view وucp_agentic_product_performance_view على مستوى الحساب بامتيازات متقدّمة.

الأسبوع الذي يبدأ في 5 أكتوبر 2026

يتوفّر ملف شخصي جديد لإعداد التقارير في واجهة برمجة التطبيقات الفرعية للتقارير (ضمن v1alpha):

  • youtube_product_category_tagged_stats_view: تستردّ مقاييس الأداء (مثل مرّات الظهور والنقرات والطلبات) لفئات المنتجات المُشار إليها في الفيديوهات على YouTube.

يُرجع حقل product_type الجديد في youtube_product_tagged_stats_view و youtube_product_sold_stats_view الفئة في تصنيف المنتجات الخاص بالتاجر.

الأسبوع الذي يبدأ في 28 سبتمبر 2026

يتوفّر ملفان شخصيان جديدان لإعداد التقارير في واجهة برمجة التطبيقات الفرعية للتقارير (ضمن v1alpha):

  • ucp_agentic_performance_view: تستردّ بيانات أداء مسار الإحالة الناجحة لعملية دمج Universal Commerce Protocol (UCP)، بما في ذلك المقاييس والسمات التي يتم تقسيم المقاييس وفقًا لها.
  • ucp_agentic_product_performance_view: تستردّ بيانات أداء المنتجات لعملية دمج UCP، بما في ذلك المقاييس والسمات التي يتم تقسيم المقاييس وفقًا لها.

يعرض حقل subscriber_count الجديد في youtube_creator_performance_view عدد المشتركين في قناة صانع المحتوى.

الأسبوع الذي يبدأ في 14 سبتمبر 2026

يتوفّر الآن تفصيل العمولات (العمولات التي تموّلها المنصة "platform_commissions" والعمولات التي يموّلها البائعون الفرعيون "seller_commissions") في الجدول youtube_content_performance_view. يتوفّر أيضًا أداء البائعين الفرعيين من خلال طلب الحقل account_id.

الأسبوع الذي يبدأ في 1 يونيو 2026

يتوفّر ملفان شخصيان جديدان لإعداد التقارير في واجهة برمجة التطبيقات الفرعية للتقارير (ضمن v1alpha):

  • youtube_product_sold_stats_view: تستردّ هذه السمة إحصاءات المنتجات التي تم بيعها من خلال برنامج التسويق بالعمولة من حزمة "التسوّق على YouTube".
  • youtube_product_tagged_stats_view: تستردّ مقاييس الأداء (مثل مرّات الظهور والنقرات والطلبات) للمنتجات المُشار إليها في الفيديوهات على YouTube.

الأسبوع الذي يبدأ في 13 أبريل 2026

تتيح لك شريحة store_type الجديدة في product_performance_view تقسيم أداء المنتجات حسب المتاجر على الإنترنت مقارنةً بالمتاجر المحلية.

الأسبوع الذي يبدأ في 23 فبراير 2026

يتيح حقل status_per_reporting_context الجديد في product_view الاستعلام عن حالة المنتج التفصيلية حسب سياق إعداد التقارير والبلد. يمكن أن يحدّ حقل reporting_context الجديد من سياقات إعداد التقارير المضمّنة في الاستجابة، كما يحدّ من السياقات المستخدَمة لحساب aggregated_reporting_context_status والتي يتم عرضها في item_issues.

يتوفّر سياق جديد لإعداد التقارير FREE_LISTINGS_UCP_CHECKOUT للاستعلام في product_view.

تمت زيادة الحد الأقصى المسموح به لـ page_size إلى 100,000 في طريقة search. يتم فرض القيم التي تزيد عن 100,000 على 100,000. لم يتم تغيير page_size التلقائي.

الأسبوع الذي يبدأ في 6 يناير 2025

يتم الآن ملء الحقل domain في الأخطاء التي تم عرضها بالقيمة merchantapi.googleapis.com بدلاً من global

الأسبوع الذي يبدأ في 27 مايو 2024

الإصدار التجريبي من واجهة برمجة التطبيقات الفرعية للتقارير

الأسبوع الذي يبدأ في 20 مايو 2024

إطلاق جدول non_product_performance_view في واجهة برمجة التطبيقات الفرعية لإعداد التقارير

الأسبوع الذي يبدأ في 31 أكتوبر 2023

إطلاق الإصدار التجريبي المغلق من واجهة برمجة التطبيقات الفرعية للتقارير