تقدّم هذه الصفحة ملاحظات إصدار Google Bid Manager API.
الإصدار 2
إجراء تغييرات هيكلية على واجهة برمجة التطبيقات، بما في ذلك تحديث نقطة نهاية الخدمة وإعادة تسمية الخدمات والطرق.
تم إجراء تعديلات كبيرة على موارد طلب البحث والتقارير من خلال إزالة الحقول غير الضرورية وإعادة تنظيم الحقول الحالية وتغيير أنواع الحقول. ويتضمن ذلك تغيير أنواع الحقول لاستخدام الكائنات المُسمّاة بدلاً من التعريف العام لـ "الكائن المتداخل".
إجراء طلبات البحث المخصّصة المطلوبة باستخدام طريقة queries.run
بدلاً من تشغيلها تلقائيًا بعد الإنشاء.
تم استبدال مَعلمة طلب البحث queries.run
asynchronous
بـ
synchronous
.
استرداد التقرير بشكل مبسّط من خلال التغييرات التالية:
- إضافة طريقة
queries.reports.get
. - إضافة مَعلمة طلب البحث
orderBy
إلىqueries.reports.list
. - تعديل نص الاستجابة
queries.run
من عنصر فارغ إلى مثيل لموردReport
الذي تم إنشاؤه
رسائل الخطأ المعدّلة التي تعرضها واجهة برمجة التطبيقات لتكون أكثر تحديدًا وتوفّر حلولاً أكثر دقة
اتّبِع التعليمات الواردة في دليل نقل بيانات الإصدار 2 للنقل من الإصدار 1.1 إلى الإصدار 2.
الميزات الجديدة
تم تغيير نقطة نهاية الخدمة:
نقطة نهاية الخدمة v1 الإصدار 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
المشاكل المعروفة
بلا عُري
الإصدار 1.1
فلتر واحد لواحد للإبلاغ عن ربط الأعمدة
يتم الآن تعيين الفلاتر التي تم تعيينها إلى أعمدة تقارير متعددة لأعمدة فردية.
على سبيل المثال، في الإصدار 1، يؤدي تضمين الفلتر FILTER_ADVERTISER
إلى إنشاء تقرير
يحتوي على العمودين "المعلن" بالإضافة إلى "الرقم التعريفي للمعلِن". في الإصدار 1.1، تحتوي جميع
أعمدة التقارير على عوامل تصفية خاصة بها. على سبيل المثال، يتم ربط الفلتر الجديد
FILTER_ADVERTISER_NAME
بالفلتر "المعلن". لعرض عمودَي "رقم تعريف
المعلِن" و "المعلن" في التقارير، يجب تضمين كلا الفلترَين FILTER_ADVERTISER
وFILTER_ADVERTISER_NAME
على التوالي في طلبات
Queries.createquery
.
بعبارة أخرى، طلب createquery
:
{
...
"params": {
...
"groupBys": ["FILTER_ADVERTISER"],
"metrics": ["METRIC_IMPRESSIONS"],
...
}
...
}
ينشئ ملف تقرير بالعناوين التالية في الإصدار 1:
Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions
والعناوين التالية في الإصدار 1.1:
Advertiser,Impressions
يتم استخدام رمز v1 التالي للحصول على أعمدة التقرير في المثال أعلاه:
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
سيتم تعديلها بشكل مشابه لما يلي في الإصدار 1.1 (ترتيب فلاتر الملاحظات):
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER_NAME");
groupBys.add("FILTER_ADVERTISER");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_STATUS");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_CODE");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
الفلتر الأصلي | تمت إضافة فلاتر |
---|---|
FILTER_ADVERTISER |
FILTER_ADVERTISER_NAME FILTER_ADVERTISER_INTEGRATION_CODE FILTER_ADVERTISER_INTEGRATION_STATUS |
FILTER_AD_POSITION |
FILTER_AD_POSITION_NAME |
FILTER_CARRIER |
FILTER_CARRIER_NAME |
FILTER_CHANNEL_ID |
FILTER_CHANNEL_NAME |
FILTER_CITY |
FILTER_CITY_NAME |
FILTER_COMPANION_CREATIVE_ID |
FILTER_COMPANION_CREATIVE_NAME |
FILTER_DMA |
FILTER_DMA_NAME |
FILTER_INSERTION_ORDER |
FILTER_INSERTION_ORDER_NAME |
FILTER_PARTNER |
FILTER_PARTNER_NAME FILTER_PARTNER_STATUS |
FILTER_REGION |
FILTER_REGION_NAME |
FILTER_TRUEVIEW_DMA |
FILTER_TRUEVIEW_DMA_NAME |
FILTER_TRUEVIEW_IAR_REGION |
FILTER_TRUEVIEW_IAR_REGION_NAME |
FILTER_USER_LIST_FIRST_PARTY |
FILTER_USER_LIST_FIRST_PARTY_NAME |
FILTER_USER_LIST_THIRD_PARTY |
FILTER_USER_LIST_THIRD_PARTY_NAME |
تقسيم النتائج على عدّة صفحات
يضيف الإصدار 1.1 ميزة التقسيم على صفحات إلى الطرق
Queries.listqueries
و
Reports.listreports
.
في الإصدار 1.1، يساوي عدد النتائج التي تعرضها هذه الطرق معلَمة مضافة حديثًا
pageSize
(وتكون القيمة التلقائية هي
100
في حال عدم تحديدها). تحتوي الردود على حقل
nextPageToken
تمت إضافته حديثًا والذي يمكن
استخدامه لاسترداد المجموعة التالية من النتائج. يكون هذا الحقل فارغًا إذا تم استنفاد النتائج.
رمز الإصدار 1 التالي لاسترداد جميع التقارير المتعلقة بطلب بحث معيّن:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
return reportListResponse.getReports();
}
}
إلى إجراء تعديلات مشابهة لما يلي في الإصدار 1.1 لمواصلة استرداد جميع التقارير:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
List<Report> reports = new ArrayList<>(reportListResponse.getReports());
while (reportListResponse.getNextPageToken() != null
&& reportListResponse.getNextPageToken().length() > 0) {
// Get next set of results, aka page.
reportListResponse =
service
.reports()
.listreports(queryId)
.setPageToken(reportListResponse.getNextPageToken())
.execute();
reports.addAll(reportListResponse.getReports());
}
return reports;
}
}
لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات Queries.listqueries
و
Reports.listreports
.
المشاكل المعروفة
بلا عُري
الإصدار 1
هذا هو الإصدار الأولي من واجهة برمجة التطبيقات.
المشاكل المعروفة
بلا عُري