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

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

الإصدار 2

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

تم إجراء تعديلات كبيرة على موارد طلب البحث والتقارير من خلال إزالة الحقول غير الضرورية وإعادة تنظيم الحقول الحالية وتغيير أنواع الحقول. ويتضمن ذلك تغيير أنواع الحقول لاستخدام الكائنات المُسمّاة بدلاً من التعريف العام لـ "الكائن المتداخل".

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

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

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

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

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

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

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

بلا عُري

الإصدار 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

هذا هو الإصدار الأولي من واجهة برمجة التطبيقات.

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

بلا عُري