ملاحظات حول الإصدار

توفّر هذه الصفحة ملاحظات الإصدار الخاصة بواجهة Google Bid Manager API.

أحدث إصدار من واجهة برمجة التطبيقات: الإصدار 2

‫22 سبتمبر 2025

المشاكل المعروفة

إيقاف ثلاث قيم تعداد Filter نهائيًا بسبب انخفاض معدّل استخدامها، كما تم الإعلان عنه سابقًا في مركز مساعدة "مساحة العرض والفيديو 360"

v2

  • تم إيقاف Filters التالية:

    قيم Filter

    FILTER_DFP_ORDER_ID

    FILTER_INSERTION_ORDER

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

‫1 مارس 2025

المشاكل المعروفة

إيقاف تقرير توفّر المساحة الإعلانية في YouTube TrueView والسمات ذات الصلة نهائيًا، كما أعلنّا سابقًا في مركز مساعدة "مساحة العرض والفيديو 360"

v2

  • تم إيقاف قيم التعداد التالية نهائيًا:

    Enumالقيمة(القيم)
    ReportType INVENTORY_AVAILABILITY

  • تم إيقاف الفلاتر التالية نهائيًا:

    قيم الفلتر

    FILTER_DETAILED_DEMOGRAPHICS

    FILTER_DETAILED_DEMOGRAPHICS_ID

    FILTER_HOUSEHOLD_INCOME

    FILTER_LIFE_EVENT

    FILTER_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_AGE

    FILTER_TRUEVIEW_IAR_CATEGORY

    FILTER_TRUEVIEW_IAR_CITY

    FILTER_TRUEVIEW_IAR_COUNTRY

    FILTER_TRUEVIEW_IAR_COUNTRY_NAME

    FILTER_TRUEVIEW_IAR_GENDER

    FILTER_TRUEVIEW_IAR_INTEREST

    FILTER_TRUEVIEW_IAR_LANGUAGE

    FILTER_TRUEVIEW_IAR_PARENTAL_STATUS

    FILTER_TRUEVIEW_IAR_REGION_NAME

    FILTER_TRUEVIEW_IAR_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_TIME_OF_DAY

    FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL

    FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO

    FILTER_TRUEVIEW_IAR_ZIPCODE

    FILTER_YOUTUBE_CHANNEL

    FILTER_YOUTUBE_VIDEO

  • تم إيقاف المقاييس التالية:

    قِيم المقاييس

    METRIC_POTENTIAL_VIEWS

    METRIC_TEA_TRUEVIEW_IMPRESSIONS

    METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

‫20 نوفمبر 2024

الميزات الجديدة

تم إطلاق FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID. يتيح ذلك تضمين بيانات أقل دقة للمقاييس التي تتضمّن البادئات التالية:

  • METRIC_UNIQUE_REACH_
  • METRIC_VIRTUAL_PEOPLE_DUPLICATE_
  • METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
  • METRIC_VIRTUAL_PEOPLE_OVERLAP_

يجب تضمين أحد المقاييس ذات الصلة عند استخدام هذا الفلتر.

عند الإطلاق، سيتم تلقائيًا تطبيق السلوك التلقائي السابق على طلبات البحث التي لا تتضمّن هذا الفلتر، أي سيتم تضمين البيانات ذات الدقة العالية فقط. اعتبارًا من 4 فبراير 2025، سيتم تلقائيًا تضمين البيانات ذات الموثوقية الأقل في الاستعلامات التي لا تتضمّن هذا الفلتر.

v2

  • تمت إضافة الفلاتر التالية:

    نوع الفلترالقيم المتاحة
    FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID

    0: تضمين بيانات ذات دقة أقل (الإعداد التلقائي بعد 4 فبراير 2025)

    1: تضمين البيانات التي تتوفّر عنها معلومات كافية فقط (الإعداد التلقائي قبل 4 فبراير 2025)

‫1 أكتوبر 2024

الميزات الجديدة

بلا عُري

المشاكل المعروفة

v2

إيقاف سمة إعداد التقارير "نموذج المساحات الإعلانية المجهولة"

السمة FILTER_ANONYMOUS_INVENTORY_MODELING هي غروب الشمس.

سيؤدي إنشاء أو تنفيذ موارد Query باستخدام قيم متوقّفة نهائيًا في params.groupBy إلى عرض الخطأ 400.

تمّت إزالة التوافق بين مقاييس ضريبة الخدمات الرقمية/تكاليف التشغيل التنظيمية وإجمالي تكلفة جميع الوسائل وتقارير YOUTUBE.

لم يعُد من الممكن استخدام قيم المقاييس التالية في تقارير YOUTUBE:

  • METRIC_TOTAL_MEDIACOST_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_USD
  • METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPA_USD
  • METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPCV_USD
  • METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPM_USD
  • METRIC_TOTAL_MEDIACOST_PARTNER
  • METRIC_TOTAL_MEDIACOST_USD
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
  • METRIC_FEE32_ADVERTISER
  • METRIC_FEE32_PARTNER
  • METRIC_FEE32_USD

يؤدي إنشاء أو تنفيذ موارد Query باستخدام params.type بقيمة YOUTUBE وقيمة مقياس ذات صلة في params.metrics إلى عرض الخطأ 400.

‫1 مايو 2024

الميزات الجديدة

بلا عُري

المشاكل المعروفة

v2

إيقاف تقريرَي "المسار الكامل" و"تحديد المصدر حسب المسار"

تم إيقاف تقريرَي "المسار الكامل" و"تحديد المصدر حسب المسار". سيؤدي استرداد أو إنشاء أنواع الموارد Query وReport إلى حدوث خطأ.

سيتم إيقاف ReportType القيم التالية:

  • FULL_PATH
  • PATH_ATTRIBUTION

تم أيضًا إيقاف الحقل pathQueryOptions في الكائن Options نهائيًا.

‫28 فبراير 2024

الميزات الجديدة

بلا عُري

المشاكل المعروفة

v2

إيقاف قيم مقياس الإحالات الناجحة على جميع الأجهزة

سيتم إيقاف مقاييس الإحالات الناجحة على جميع الأجهزة. يتم تضمين قيم المقاييس التالية في Bid Manager API:

  • METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
  • METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
  • METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 تموز (يوليو) 2022

الميزات الجديدة

تم إطلاق الإصدار 2 من Bid Manager API.

أجرينا تغييرات هيكلية على واجهة برمجة التطبيقات، بما في ذلك تعديل نقطة نهاية الخدمة وإعادة تسمية الخدمات والطرق.

تم تعديل المرجعَين طلب البحث والتقرير بشكل كبير من خلال إزالة الحقول غير الضرورية وإعادة تنظيم الحقول الحالية وتغيير أنواع الحقول. ويشمل ذلك تغيير أنواع الحقول لاستخدام عناصر مسماة بدلاً من تعريف عام "لعنصر متداخل".

يجب تنفيذ طلبات البحث المخصّصة باستخدام طريقة queries.run بدلاً من تنفيذها تلقائيًا بعد إنشائها.

تم استبدال مَعلمة طلب البحث queries.run asynchronous بـ synchronous.

تبسيط عملية استرداد التقارير من خلال التغييرات التالية:

تم تعديل رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات لتكون أكثر تحديدًا وتقدّم حلولاً أكثر توجيهًا.

اتّبِع التعليمات الواردة في دليل نقل البيانات إلى الإصدار 2 لنقل البيانات من الإصدار 1.1 إلى الإصدار 2.

v2

المشاكل المعروفة

بلا عُري

الإصدارات السابقة

للاطّلاع على إصدارات Bid Manager API السابقة للإصدارات التي تم إيقافها نهائيًا، يُرجى الاطّلاع على ملاحظات الإصدار المؤرشفة.