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

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

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

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

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

سمة 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

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

  المورد	الحقول	نوع العنصر
  طلب بحث	البيانات الوصفية params الجدول الزمني	QueryMetadata المعلّمات QuerySchedule
  الإبلاغ	مفتاح البيانات الوصفية 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 للإصدارات التي سيتم إيقافها نهائيًا، يُرجى الاطّلاع على ملاحظات الإصدارات المؤرشفة.