Ghi chú phát hành

Marketplace API

Phiên bản 1.0

Ngày Ghi chú
Ngày 26 tháng 8 năm 2025
  • Bạn chỉ được phép sử dụng kích thước khoảng không quảng cáo PIXEL để nhắm đến kích thước khoảng không quảng cáo khi gọi buyers.proposals.sendRfp.
Ngày 27 tháng 2 năm 2025
Ngày 9 tháng 12 năm 2024
Ngày 17 tháng 6 năm 2024
Ngày 6 tháng 6 năm 2024
  • Đã thêm tính năng hỗ trợ cho pausingresuming Giao dịch ưu tiên.
Ngày 25 tháng 4 năm 2024
Ngày 23 tháng 4 năm 2024 Đã thêm giá trị nhắm mục tiêu excludedSensitiveCategoryIds vào MarketplaceTargeting. Đã thêm giá trị nhắm mục tiêu vertical_targeting vào MarketplaceTargeting.
Ngày 15 tháng 4 năm 2024
  • Ra mắt bidders.auctionPackages.list để liệt kê các gói đấu giá ở cấp bên đặt giá thầu. Các gói đấu giá do phương thức này trả về sẽ liệt kê những nhà lập kế hoạch truyền thông đã đăng ký gói đó bằng trường subscribedMediaPlanners.
  • Giới thiệu trường subscribedBuyers cho AuctionPackage.
  • Giới thiệu trường subscribedMediaPlanners cho AuctionPackage.
  • Giới thiệu trường eligibleSeatIds cho AuctionPackage.
Ngày 7 tháng 3 năm 2024
Ngày 29 tháng 2 năm 2024
  • Giới thiệu trường mediaPlanner cho Deal.
  • Giới thiệu trường eligibleSeatIds cho Deal.
  • billedBuyer của giao dịch sẽ không được điền sẵn nếu giao dịch đó thuộc về một tài khoản của nhà lập kế hoạch truyền thông.
Ngày 29 tháng 11 năm 2023 Đã thêm giá trị enum AUDIO vào CreativeFormat. Đã thêm giá trị enum LG_TV vào AppStoreType.
Ngày 11 tháng 10 năm 2021 Ra mắt ban đầu Authorized Buyers Marketplace API, cho phép bạn:
  • Đề xuất và thương lượng giao dịch với nhà xuất bản
  • Truy xuất các giao dịch đã hoàn tất và chỉ số về trạng thái của giao dịch
  • Quản lý gói thuê bao đấu giá
  • Quản lý khách hàng và người dùng khách hàng
  • Khám phá hồ sơ nhà xuất bản

Phiên bản 1.0 beta

Ngày Ghi chú
Ngày 11 tháng 6 năm 2025
  • Bản phát hành đầu tiên của API v1beta.
  • Tài nguyên dataSegments hiện có trong phiên bản v1beta.
    • Đường dẫn tài nguyên cho dataSegments đã thay đổi từ buyers/{accountId}/dataSegments trong phiên bản v1alpha thành curators/{accountId}/dataSegments trong phiên bản v1beta

Phiên bản 1.0 alpha

Ngày Ghi chú
Ngày 12 tháng 6 năm 2024
  • Bản phát hành đầu tiên của API v1alpha.

Real-time Bidding API

Phiên bản 1.0

Ngày Ghi chú
Ngày 1 tháng 5 năm 2025 Giá trị không dùng nữa GOOGLE_RTB từ không gian enum BidProtocol.
Ngày 24 tháng 2 năm 2025 Đã thêm giá trị mới GOOGLE_AD_CATEGORY_TAXONOMY vào không gian enum AdCategoryTaxonomy.
Ngày 13 tháng 2 năm 2025 Các danh mục bị hạn chế đã khai báo không được dùng nữa trong Tệp quảng cáo.
Ngày 6 tháng 8 năm 2024
Ngày 30 tháng 7 năm 2024
Ngày 31 tháng 10 năm 2023 buyers.userLists.getRemarketingTagUrlRestriction đã ngừng hoạt động và sẽ trả về một phản hồi lỗi nếu được gọi. Bạn nên sử dụng tính năng google_ula của thẻ So khớp cookie để thêm người dùng vào danh sách người dùng bằng cách đặt một thẻ từ trình duyệt. Xem thêm trong tài liệu về quy trình So khớp cookie
Ngày 12 tháng 10 năm 2023 Đã thêm giá trị enum RENDERING_PLAYABLE vào CreativeAttribute.
Ngày 17 tháng 8 năm 2023 buyers.userLists.getRemarketingTagUrlRestriction không được dùng nữa và sẽ ngừng hoạt động vào ngày 31/10/2023. Sử dụng tính năng google_ula của thẻ So khớp cookie để thêm người dùng vào danh sách người dùng bằng cách đặt một thẻ từ trình duyệt. Xem thêm trong tài liệu về quy trình So khớp cookie
Ngày 17 tháng 3 năm 2023 Đã thêm trường missingCertificate vào PolicyTopicEntry.
Ngày 7 tháng 2 năm 2023

Đã xoá các giá trị enum không dùng nữa sau đây khỏi bidders.endpoints.bidProtocol:

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
Ngày 8 tháng 11 năm 2022

Thêm giá trị enum OPENRTB_PROTOBUF mới cho bidders.endpoints.bidProtocol. Từ nay về sau, mỗi lần chỉ hỗ trợ một phiên bản OpenRTB. Bạn nên sử dụng OPENRTB_JSON hoặc OpenRTB_PROTOBUF để sử dụng phiên bản OpenRTB mới nhất được hỗ trợ ở định dạng mà bạn muốn. Hãy xem bài đăng trên blog của chúng tôi về Việc ngừng hỗ trợ các phiên bản OpenRTB cũ để biết thêm thông tin chi tiết.

Các trường enum sau đây trong bidders.endpoints.bidProtocol đã được đánh dấu là không được dùng nữa:

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
Ngày 20 tháng 9 năm 2022 Ra mắt trường creatives.renderUrl thử nghiệm cho bản dùng thử theo nguyên gốc FLEDGE.
Ngày 1 tháng 9 năm 2022 Giới thiệu trạng thái CERTIFICATE_REQUIRED cho một số mẫu quảng cáo. Xem Chính sách về cờ bạc và trò chơi để biết thêm thông tin.
Ngày 27 tháng 4 năm 2022 Giải phóng tài nguyên publisherConnections. Các sàn giao dịch Đặt giá thầu mở có thể sử dụng publisherConnections để quản lý mối kết nối với nhà xuất bản.
Ngày 1 tháng 11 năm 2021 Giới thiệu bidders.enpoints.patch để cập nhật điểm cuối của bên đặt giá thầu.
Ngày 27 tháng 5 năm 2021 Giới thiệu một trường video cho tài nguyên Quảng cáo gốc, chấp nhận videoVastXml hoặc videoUrl.
Ngày 8 tháng 10 năm 2020 Đã thay thế các trường openAuctionServingStatus, openBiddingServingStatus, dealsServingStatus, chinaServingStatusrussiaServingStatus bằng networkPolicyCompliance, platformPolicyCompliance, dealsPolicyCompliance, chinaPolicyCompliancerussiaPolicyCompliance tương ứng.
Ngày 24 tháng 6 năm 2020 Ra mắt ban đầu API Đặt giá thầu theo thời gian thực để thay thế API Người mua Ad Exchange và API Người mua Ad Exchange II.

Phiên bản 2.0 (Không dùng nữa)

Ngày Ghi chú
11/8/2025

Đã thêm trạng thái OVERDELIVERED_IMPRESSION vào enum Status của NonBillableWinningBidStatusRow.

29/9/2023

Tất cả các tài nguyên khác ngoài những tài nguyên được dùng để Khắc phục sự cố RTB đều đã ngừng hoạt động và sẽ trả về phản hồi lỗi nếu được gọi. Bạn nên di chuyển sang Marketplace API để tiếp tục truy cập vào Marketplace theo cách lập trình. Các tài nguyên ngừng hoạt động bao gồm những tài nguyên sau và tất cả các tài nguyên phụ của chúng:

  • accounts.clients
  • accounts.creatives
  • accounts.finalizedProposals
  • accounts.products
  • accounts.proposals
  • accounts.publisherProfiles
  • accounts.clients
24/5/2021

Thêm các phương thức pauseresume ở cấp giao dịch.

20/8/2020

Đã thêm trường detail vào BidMetricsRow.

6/5/2020

Đã thêm trường reachedQueries vào BidMetricsRow. Thêm FATAL_VAST_ERRORLOST_IN_MEDIATION vào enum Status của NonBillableWinningBidStatusRow.

9/3/2016

Phát hành Quyền truy cập của khách hàng dưới dạng bản thử nghiệm công khai. Giờ đây, bạn có thể cho phép người mua là khách hàng của bạn truy cập trực tiếp vào Authorized Buyers Marketplace để có thể xem, thương lượng và phê duyệt các giao dịch. Ngoài ra, ứng dụng của bạn có thể thực hiện các thao tác theo phương thức lập trình mà trước đây bạn phải thực hiện theo cách thủ công trong mục Khách hàng của thẻ Cài đặt tài khoản người mua trên Authorized Buyers.