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

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

يتوفّر عرضان جديدان للتقارير في واجهة برمجة التطبيقات الفرعية Reports (ضمن 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

يتوفّر عرضان جديدان للتقارير في واجهة برمجة التطبيقات الفرعية Reports (ضمن 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

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