تقدّم هذه الصفحة ملاحظات الإصدار لواجهة برمجة التطبيقات 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 تمت إعادة تسمية الطرق على النحو التالي:
تمت إضافة الطرق التالية:
الخدمة الطرق queries.reports الحصول تحتوي الطرق التالية على نص استجابة جديد:
الطريقة عنصر جديد لنص الاستجابة queries.run الإبلاغ تمّت إزالة الحقول التالية:
المورد الحقول queries.list
نص الاستجابةالنوع
queries.reports.list
نص الاستجابةالنوع
طلب بحث النوع
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
تم تغيير نوع العنصر للحقول التالية إلى ما يلي:
المورد الحقول نوع العنصر طلب بحث الإبلاغ RunQueryRequest تمت إضافة مَعلمات طلب البحث التالية للطريقة:
الطريقة مَعلمات طلب البحث 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 للإصدارات التي سيتم إيقافها نهائيًا، يُرجى الاطّلاع على ملاحظات الإصدارات المؤرشفة.