Ghi chú phát hành

Trang này cung cấp ghi chú phát hành cho API Google Bid Manager.

Phiên bản API mới nhất: v2

Ngày 22 tháng 9 năm 2025

Vấn đề đã biết

Ngừng cung cấp 3 giá trị enum Filter do có ít người dùng, như đã thông báo trước đó trong trung tâm trợ giúp Display & Video 360.

phiên bản 2

• Các Filters sau đây không còn được dùng nữa:

  (Các) giá trị Filter
  FILTER_DFP_ORDER_ID FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

Ngày 1 tháng 3 năm 2025

Vấn đề đã biết

Ngừng cung cấp báo cáo về tính sẵn có của khoảng không quảng cáo TrueView trên YouTube và các phương diện liên quan như đã thông báo trước đó trong trung tâm trợ giúp của Display & Video 360.

phiên bản 2

• Các giá trị enum sau đây không được dùng nữa:

  Enum	Giá trị
  ReportType	INVENTORY_AVAILABILITY

• Các bộ lọc sau đây không còn được dùng nữa:

  (Các) giá trị bộ lọc

  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

• Các chỉ số sau đây không được dùng nữa:

  (Các) giá trị của chỉ số
  METRIC_POTENTIAL_VIEWS METRIC_TEA_TRUEVIEW_IMPRESSIONS METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

Ngày 20 tháng 11 năm 2024

Tính năng mới

FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID được ra mắt. Điều này cho phép đưa dữ liệu có độ tin cậy thấp hơn vào các chỉ số có tiền tố sau:

• METRIC_UNIQUE_REACH_
• METRIC_VIRTUAL_PEOPLE_DUPLICATE_
• METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
• METRIC_VIRTUAL_PEOPLE_OVERLAP_

Bạn phải thêm một trong các chỉ số liên quan khi sử dụng bộ lọc này.

Khi ra mắt, những cụm từ tìm kiếm không có bộ lọc này sẽ mặc định chuyển về hành vi mặc định trước đó là chỉ bao gồm dữ liệu có độ tin cậy cao. Kể từ ngày 4 tháng 2 năm 2025, những truy vấn không có bộ lọc này sẽ mặc định bao gồm dữ liệu có độ tin cậy thấp hơn.

phiên bản 2

• Các bộ lọc sau đây đã được thêm:

  Loại bộ lọc	Các giá trị hợp lệ
  FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID	0: Bao gồm dữ liệu có độ tin cậy thấp hơn. (Mặc định sau ngày 4 tháng 2 năm 2025) 1: Chỉ bao gồm dữ liệu có độ tin cậy cao. (Mặc định trước ngày 4 tháng 2 năm 2025)

Ngày 1 tháng 10 năm 2024

Tính năng mới

Không có.

Vấn đề đã biết

phiên bản 2

Ngừng sử dụng phương diện báo cáo Lập mô hình khoảng không quảng cáo ẩn danh (AIM)

Phương diện FILTER_ANONYMOUS_INVENTORY_MODELING không được dùng nữa.

Việc tạo hoặc chạy các tài nguyên Query bằng cách sử dụng các giá trị sunset trong params.groupBy sẽ trả về lỗi 400.

Chỉ số DST/ROC (Chi phí vận hành theo luật định) và Tổng chi phí truyền thông không tương thích với báo cáo YOUTUBE.

Bạn không thể sử dụng các giá trị chỉ số sau đây trong báo cáo YOUTUBE nữa:

• 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

Việc tạo hoặc chạy các tài nguyên Query bằng params.type của YOUTUBE và giá trị chỉ số có liên quan trong params.metrics sẽ trả về lỗi 400.

Ngày 1 tháng 5 năm 2024

Tính năng mới

Không có.

Vấn đề đã biết

phiên bản 2

Ngừng cung cấp báo cáo Lộ trình đầy đủ và báo cáo Phân bổ theo lộ trình

Báo cáo Đường dẫn đầy đủ và Phân bổ theo đường dẫn sẽ ngừng hoạt động. Việc truy xuất hoặc tạo các loại tài nguyên Query và Report này sẽ dẫn đến lỗi.

Các giá trị ReportType sau đây sẽ ngừng hoạt động:

• FULL_PATH
• PATH_ATTRIBUTION

Trường pathQueryOptions của đối tượng Options cũng sẽ ngừng hoạt động.

Ngày 28 tháng 2 năm 2024

Tính năng mới

Không có.

Vấn đề đã biết

phiên bản 2

Ngừng cung cấp giá trị chỉ số lượt chuyển đổi trên nhiều thiết bị

Các chỉ số về lượt chuyển đổi trên nhiều thiết bị sẽ ngừng hoạt động. Các giá trị chỉ số Bid Manager API sau đây được đưa vào:

• 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

Ngày 6 tháng 7 năm 2022

Tính năng mới

Phát hành Bid Manager API 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 dịch vụ và đổi tên các dịch vụ cũng như 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 các loại trường. Trong đó có việc thay đổi các loại trường để sử dụng các đối tượng được đặt tên thay vì định nghĩa "đối tượng lồng nhau" chung.

Bắt buộc phải chạy các truy vấn đặc biệt bằng phương thức queries.run thay vì 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á việc truy xuất báo cáo thông qua những thay đổi sau:

• Thêm phương thức queries.reports.get.
• Việc thêm tham số truy vấn orderBy vào queries.reports.list.
• Nội dung phản hồi queries.run được cập nhật từ một đối tượng trống thành một thực thể của tài nguyên Report đã tạo.

Cập nhật thông báo lỗi do API trả về để cụ thể hơn và cung cấp các giải pháp mang tính chỉ dẫn hơn.

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

phiên bản 2

• Điểm cuối dịch vụ đã thay đổi:

  Điểm cuối dịch vụ phiên bản 1	Điểm cuối dịch vụ phiên bản 2
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• Các dịch vụ đã được đổi tên như sau:

  Dịch vụ v1	Dịch vụ v2
  Cụm từ tìm kiếm	cụm từ tìm kiếm
  Báo cáo	queries.reports

• Các phương thức đã được đổi tên như sau:

  Phương thức v1	Phương thức v2
  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ụ	Phương thức
  queries.reports	get

• Các phương thức sau đây có một nội dung phản hồi mới:

  Phương thức	Đối tượng nội dung 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
  queries.list Nội dung phản hồi	loại
  queries.reports.list Nội dung phản hồi	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 đây đã đượ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	siêu dữ liệu params lịch biểu	QueryMetadata Tham số QuerySchedule
  Báo cáo	key siêu dữ liệu params	ReportKey ReportMetadata Tham số
  RunQueryRequest	dataRange	DataRange

• Các tham số truy vấn phương thức sau đây đã được thêm:

  Phương thứ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	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 đây đã bị xoá:

  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 có.

Các bản phát hành trước

Để đọc về các bản phát hành Bid Manager API trước đây cho các phiên bản ngừng hoạt động, hãy xem ghi chú phát hành được lưu trữ.