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

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

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

1 آذار (مارس) 2025

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

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

إيقاف تقرير مدى توفّر المستودع الإعلاني في إعلانات TrueView على YouTube والسمات المتعلّقة به نهائيًا، كما أعلنّا سابقًا في مركز مساعدة "مساحة العرض والفيديو 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. يتيح ذلك تضمين data البيانات الأقل ثقة للمقاييس التي تحتوي على البادئات التالية:

• 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

إيقاف سمة إعداد تقارير نموذج المساحات الإعلانية المجهولة (AIM) نهائيًا

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

يؤدي إنشاء موارد Query أو تشغيلها باستخدام قيم الإيقاف النهائي في params.groupBy إلى ظهور خطأ 400.

أصبحت مقاييس ضريبة الخدمات الرقمية (DST) أو تكاليف التشغيل التنظيمية (ROC) وإجمالي تكلفة الوسائط غير متوافقة مع تقارير 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 هو sunset أيضًا.

‫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 بدلاً من تشغيلها تلقائيًا بعد إنشائها.

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

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

• إضافة طريقة queries.reports.get
• إضافة مَعلمة طلب بحث orderBy إلى queries.reports.list
• تعديل نص استجابة queries.run من عنصر فارغ إلى مثيل لمصدر Report تم إنشاؤه

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

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

v2

• تم تغيير نقطة نهاية الخدمة:

  نقطة نهاية الخدمة في الإصدار 1	نقطة نهاية الخدمة في الإصدار 2
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• تمت إعادة تسمية الخدمات على النحو التالي:

  خدمة الإصدار 1	خدمة الإصدار 2
  طلبات البحث	طلبات البحث
  التقارير	queries.reports

• تمت إعادة تسمية الطرق على النحو التالي:

  طريقة الإصدار 1	طريقة الإصدار 2
  Queries.createquery	queries.create
  Queries.deletequery	queries.delete
  Queries.getquery	queries.get
  Queries.listqueries	queries.list
  Queries.runquery	queries.run
  Reports.listreports	queries.reports.list

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

  الخدمة	الطرق
  queries.reports	الحصول

• تحتوي الطرق التالية على نص استجابة جديد:

  الطريقة	عنصر جديد لنص الاستجابة
  queries.run	الإبلاغ

• تمّت إزالة الحقول التالية:

  المورد	الحقول
  queries.list نص الاستجابة	النوع
  queries.reports.list نص الاستجابة	النوع
  طلب بحث	النوع reportDataEndTimeMs reportDataStartTimeMs timezoneCode
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs timezoneCode

• تم تغيير نوع العنصر للحقول التالية إلى ما يلي:

  المورد	الحقول	نوع العنصر
  طلب بحث	metadata params الجدول الزمني	QueryMetadata المعلّمات QuerySchedule
  الإبلاغ	مفتاح metadata params	ReportKey ReportMetadata المعلّمات
  RunQueryRequest	dataRange	DataRange

• تمت إضافة مَعلمات طلب البحث التالية للطريقة:

  الطريقة	مَعلمات طلب البحث
  queries.list	orderBy
  queries.reports.list	orderBy
  queries.run	مزامنة

• تمّت إزالة مَعلمات طلب البحث التالية للطريقة:

  الطريقة	مَعلمات طلب البحث
  queries.create	غير متزامن
  queries.run	غير متزامن

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

  قيمة الفلتر
  FILTER_INVENTORY_MEDIA_COST_TYPE
  FILTER_TARGETING_EXPANSION

• تمت إزالة قيم الفلتر التالية:

  قيمة الفلتر
  FILTER_TRUEVIEW_IAR_REGION

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

  قيمة المقياس
  METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS
  METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT
  METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH

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

بلا عُري

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

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