Ghi chú phát hành

Marketplace API

Phiên bản 1.0

Ngày Ghi chú
Ngày 14 tháng 12 năm 2025
  • Trường accountID trong tài nguyên mediaPlanners không còn được dùng nữa.
Ngày 10 tháng 11 năm 2025
Ngày 26 tháng 8 năm 2025
  • Chỉ cho phép kích thước khoảng không quảng cáo PIXEL cho tiêu chí nhắm mục tiêu theo 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 Giao dịch ưu tiên pausing và resuming.
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á được trả về theo phương thức này liệt kê những chuyên viên kế hoạch truyền thông đã đăng ký gói đấu giá đó bằng trường subscribedMediaPlanners.
  • Ra mắt trường subscribedBuyers cho AuctionPackage.
  • Ra mắt trường subscribedMediaPlanners cho AuctionPackage.
  • Ra mắt trường eligibleSeatIds cho AuctionPackage.
Ngày 7 tháng 3 năm 2024
Ngày 29 tháng 2 năm 2024
  • Ra mắt trường mediaPlanner cho Deal.
  • Ra mắt trường eligibleSeatIds cho Deal.
  • billedBuyer của giao dịch sẽ không được điền nếu thuộc về tài khoản của chuyên viên 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 Lần ra mắt đầu tiên của 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ề tình trạng giao dịch
  • Quản lý gói thuê bao gói đấ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 19 tháng 10 năm 2026
  • Ra mắt mediaPlanners.search để tìm tài khoản của chuyên viên kế hoạch truyền thông theo mã tài khoản con DSP.
Ngày 25 tháng 8 năm 2026
Ngày 20 tháng 7 năm 2026
Ngày 29 tháng 6 năm 2026
Ngày 14 tháng 12 năm 2025
  • Tài nguyên curatedPackages và mediaPlanners hiện đã có sẵn cho người quản lý trong phiên bản v1beta.
  • Trường accountID trong tài nguyên mediaPlanners không còn được dùng nữa.
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 v1alpha thành curators/{accountId}/dataSegments trong v1beta

Phiên bản 1.0 alpha

Ngày Ghi chú
Ngày 19 tháng 10 năm 2026
  • Ra mắt mediaPlanners.search để tìm tài khoản của chuyên viên kế hoạch truyền thông theo mã tài khoản con DSP.
Ngày 25 tháng 8 năm 2026
Ngày 20 tháng 7 năm 2026
Ngày 29 tháng 6 năm 2026
Ngày 14 tháng 12 năm 2025
  • Tài nguyên curatedPackages và mediaPlanners hiện đã có sẵn cho người quản lý trong v1alpha.
  • Trường accountID trong tài nguyên mediaPlanners không còn được dùng nữa.
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 20 tháng 9 năm 2026 Ngừng sử dụng trạng thái CERTIFICATE_REQUIRED và trường missingCertificate sau khi cập nhật chính sách để không còn yêu cầu chứng chỉ cho trò chơi cờ bạc và trò chơi sòng bạc không bằng tiền thật.
Ngày 10 tháng 9 năm 2026 Ra mắt phương thức addDeals cho tài nguyên buyers.creatives, cho phép người mua liên kết mã giao dịch (bao gồm cả Đảm bảo có lập trình, Phiên đấu giá kín, Giao dịch ưu tiên và Gói thị trường) với một mẫu quảng cáo.
Ngày 9 tháng 7 năm 2026 Ngừng sử dụng trường allowed_user_targeting_modes và enum UserTargetingMode trong PretargetingConfig.
Ngày 1 tháng 5 năm 2025 Giá trị không dùng nữa GOOGLE_RTB trong 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 Ngừng sử dụng các danh mục bị hạn chế đã khai báo trong Mẫu 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.getRemarketingTag và UrlRestriction đã ngừng hoạt động và sẽ trả về 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 thẻ từ trình duyệt. Xem thêm trong Tài liệu về 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.getRemarketingTag và UrlRestriction không còn được dùng nữa và sẽ ngừng hoạt động từ 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 thẻ từ trình duyệt. Xem thêm trong Tài liệu về tính năng 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

Đã xóa 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. Trong tương lai, mỗi lần chúng tôi sẽ chỉ hỗ trợ một phiên bản OpenRTB. Bạn nên sử dụng OPENRTB_JSON hoặc OpenRTB_PROTOBUF để 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 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 Ra mắt trạng thái CERTIFICATE_REQUIRED cho một số mẫu quảng cáo. Hãy 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 quan hệ với nhà xuất bản.
Ngày 1 tháng 11 năm 2021 Ra mắt 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 Ra mắt trường oneof video cho tài nguyên Mẫu 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, chinaServingStatus và russiaServingStatus bằng networkPolicyCompliance, platformPolicyCompliance, dealsPolicyCompliance, chinaPolicyCompliance và russiaPolicyCompliance tương ứng.
Ngày 24 tháng 6 năm 2020 Lần ra mắt đầu tiên của API Đặt giá thầu theo thời gian thực, để thay thế cho API Người mua Ad Exchange và API Người mua Ad Exchange II.

Cũ

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ả tài nguyên khác ngoài những tài nguyên dùng cho tính năng Khắc phục sự cố RTB đã 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 phương thức 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 đây và tất 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 pause và resume ở 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_ERROR và LOST_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 beta công khai. Giờ đây, bạn có thể cho phép người mua là khách hàng của mình truy cập trực tiếp vào Authorized Buyers Marketplace để có thể xem, thương lượng và phê duyệt 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 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 trong Authorized Buyers.