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:
- Thêm phương thức
queries.reports.get
. - Thêm tham số truy vấn
orderBy
vàoqueries.reports.list
. - Cập nhật nội dung phản hồi
queries.run
từ một đối tượng trống thành một thực thể của tài nguyênReport
đã tạo.
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
Điểm cuối của dịch vụ đã được thay đổi:
Điểm cuối dịch vụ phiên bản 1 Điểm cuối dịch vụ v2 https://www.googleapis.com/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
Các dịch vụ đã được đổi tên như sau:
Dịch vụ phiên bản 1 dịch vụ phiên bản 2 Cụm từ tìm kiếm truy vấn Báo cáo queries.reports Các phương thức đã được đổi tên như sau:
phương thức phiên bản 1 phương thức phiên bản 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 Các phương thức sau đã được thêm:
Dịch vụ (Các) phương thức queries.reports nhận Các phương thức sau có nội dung phản hồi mới:
Phương thức Đối tượng cơ thể phản hồi mới queries.run Báo cáo Các trường sau đây đã bị xoá:
Tài nguyên (Các) trường Nội dung phản hồi queries.list
loại
Nội dung phản hồi queries.reports.list
loại
Cụm từ tìm kiếm loại
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
Loại đối tượng của các trường sau đã được thay đổi thành:
Tài nguyên (Các) trường Loại đối tượng Cụm từ tìm kiếm Báo cáo RunQueryRequest Các tham số truy vấn phương thức sau đã được thêm:
Phương thức (Các) tham số truy vấn queries.list orderBy queries.reports.list orderBy queries.run đồng bộ Các tham số truy vấn phương thức sau đây đã bị xoá:
Phương thức (Các) tham số truy vấn queries.create không đồng bộ queries.run không đồng bộ Các giá trị Bộ lọc sau đây đã được thêm:
Giá trị bộ lọc FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION Các giá trị Bộ lọc sau đã bị xóa:
Giá trị bộ lọc FILTER_TRUEVIEW_IAR_REGION Các giá trị chỉ số sau đây đã được thêm:
Giá trị chỉ số 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
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.