Ghi chú phát hành

Trang này cung cấp ghi chú phát hành cho API Trình quản lý giá thầu của Google.

Phiên bản 2

Thực hiện các thay đổi về cấu trúc đối với API, bao gồm cả việc cập nhật điểm cuối của dịch vụ và đổi tên các dịch vụ và phương thức.

Cập nhật đáng kể các tài nguyên Truy vấn và Báo cáo bằng cách xoá các trường không cần thiết, sắp xếp lại các trường hiện có và thay đổi loại trường. Trong đó có việc thay đổi loại trường để dùng các đối tượng được đặt tên thay vì định nghĩa chung "đối tượng lồng nhau".

Bắt buộc chạy các truy vấn đặc biệt bằng cách sử dụng phương thức queries.run thay vì để các truy vấn này tự động chạy sau khi tạo.

Thay thế tham số truy vấn queries.run asynchronous bằng synchronous.

Đơn giản hoá quá trình truy xuất báo cáo thông qua các thay đổi sau:

Cập nhật các thông báo lỗi mà API trả về để cụ thể hơn và cung cấp thêm các giải pháp quy định.

Làm theo hướng dẫn trong Hướng dẫn di chuyển phiên bản 2 để di chuyển từ phiên bản 1.1 sang phiên bản 2.

Tính năng mới

Vấn đề đã biết

Không nội dung nào.

Phiên bản 1.1

Bộ lọc một với một để báo cáo mối liên kết cột

Các bộ lọc được liên kết với nhiều cột báo cáo hiện sẽ ánh xạ tới một cột.

Ví dụ: trong phiên bản 1, việc thêm bộ lọc FILTER_ADVERTISER sẽ tạo ra một báo cáo với các cột "Nhà quảng cáo" ngoài cột "Mã nhà quảng cáo". Trong phiên bản 1.1, tất cả các cột báo cáo đều có bộ lọc riêng. Ví dụ: một bộ lọc mới FILTER_ADVERTISER_NAME sẽ liên kết tới "Nhà quảng cáo". Để đưa cả cột "Mã nhà quảng cáo" và "Nhà quảng cáo" vào báo cáo, bạn phải đưa cả hai bộ lọc FILTER_ADVERTISER và FILTER_ADVERTISER_NAME tương ứng vào yêu cầu Queries.createquery.

Cụ thể hơn, yêu cầu createquery:

{
...
"params": {
  ...
  "groupBys": ["FILTER_ADVERTISER"],
  "metrics": ["METRIC_IMPRESSIONS"],
  ...
}
...
}

sẽ tạo tệp báo cáo có các tiêu đề sau trong v1:

Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions

và các tiêu đề sau trong phiên bản 1.1:

Advertiser,Impressions

Mã v1 sau đây được dùng để lấy các cột báo cáo trong ví dụ trên:

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);

sẽ phải được sửa đổi tương tự như sau trong phiên bản 1.1 (lưu ý rằng thứ tự bộ lọc):

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);
Bộ lọc gốc Đã thêm bộ lọc
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

Phân trang

Phiên bản 1.1 bổ sung tính năng phân trang cho các phương thức Queries.listqueries và Reports.listreports.

Trong phiên bản 1.1, số lượng kết quả mà các phương thức này trả về bằng với tham số mới thêm pageSize (mặc định là tham số 100 nếu không được chỉ định). Nội dung phản hồi chứa một trường nextPageToken mới thêm vào có thể dùng để truy xuất tập hợp kết quả tiếp theo. Trường này để trống nếu đã hết kết quả.

Mã v1 sau để truy xuất tất cả báo cáo thuộc về một truy vấn cụ thể:

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    return reportListResponse.getReports();
  }
}

sẽ phải được sửa đổi tương tự như sau trong phiên bản 1.1 để có thể tiếp tục truy xuất tất cả báo cáo:

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;
  }
}

Xem tài liệu về phương thức Queries.listqueries và Reports.listreports để biết thêm thông tin chi tiết.

Vấn đề đã biết

Không nội dung nào.

Phiên bản 1

Đây là phiên bản đầu tiên của API.

Vấn đề đã biết

Không nội dung nào.