Ghi chú phát hành

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

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

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

Thận trọng: Thay đổi này sắp ra mắt.

Tính năng mới

Không có.

Vấn đề đã biết

phiên bản 2

Phương diện báo cáo Lập mô hình khoảng không quảng cáo ẩn danh (AIM) sẽ ngừng hoạt động

Phương diện FILTER_ANONYMOUS_INVENTORY_MODELING đã ngừng hoạt động.

Tạo hoặc chạy Query bằng cách sử dụng giá trị ngừng cung cấp trong params.groupBy trả về lỗi 400.

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

Các giá trị chỉ số sau đây không còn dùng được 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

Tạo hoặc chạy Query có tính năng params.type trong số YOUTUBE và một giá trị chỉ số có liên quan ở 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 đầy đủ báo cáo phân bổ đường dẫn và đường dẫn

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

Nội dung sau đây Các giá trị ReportType là ngừng cung cấp:

• FULL_PATH
• PATH_ATTRIBUTION

Chiến lược phát hành đĩa đơn pathQueryOptions trường của Đối tượng Options cũng là hoàng hôn.

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ị

Chuyển đổi thiết bị chéo chỉ số sắp ngừng hoạt động. Chỉ số API Trình quản lý giá thầu sau đây sau đây là:

• 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 API Trình quản lý giá thầu phiên bản 2.

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

Cập nhật đáng kể các tài nguyên về 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 trường loại. Điều này bao gồm việc thay đổi loại trường để sử dụng đối tượng được đặt tên thay vì chung "đối tượng lồng nhau" định nghĩa.

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ì để chúng tự động chạy sau khi tạo.

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

Truy xuất báo cáo được đơn giản hoá 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ào queries.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 bản sao của tài nguyên Report đã 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 nhiều thông tin các giải pháp quy tắc.

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.

phiên bản 2

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

  điểm cuối dịch vụ v1	đ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 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 vào:

  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
  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 đã đượ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 tham số lịch biểu	QueryMetadata Tham số QuerySchedule
  Báo cáo	key siêu dữ liệu tham số	ReportKey ReportMetadata Tham số
  RunQueryRequest	dataRange	DataRange

• 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 đã 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 đã đượ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ó.

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

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