Примечания к выпуску

API торговой площадки

Версия 1.0

Дата Примечания
14 декабря 2025 г.
  • Поле accountID в ресурсе mediaPlanners устарело.
10 ноября 2025 года
  • В AuctionPackage добавлено поле floorPriceCpm .
  • Добавлена ​​поддержка функции setReadyToServe на уровне участника торгов.
26 августа 2025 г.
  • При вызове метода buyers.proposals.sendRfp для таргетинга по размеру запасов допускается использовать только размеры запасов в пикселях.
27 февраля 2025 г.
9 декабря 2024 г.
17 июня 2024 г.
6 июня 2024 г.
  • Добавлена ​​поддержка pausing и resuming сделок в рамках программы Preferred.
25 апреля 2024 г.
23 апреля 2024 г. Добавлено значение таргетинга excludedSensitiveCategoryIds в MarketplaceTargeting . Добавлено значение таргетинга vertical_targeting в MarketplaceTargeting .
15 апреля 2024 г.
  • Добавлен bidders.auctionPackages.list для отображения аукционных пакетов на уровне участников торгов. В возвращаемых этим методом аукционных пакетах перечислены медиапланировщики, подписанные на них, с помощью поля ` subscribedMediaPlanners .
  • В AuctionPackage добавлено поле subscribedBuyers .
  • В AuctionPackage добавлено поле subscribedMediaPlanners .
  • В AuctionPackage добавлено поле eligibleSeatIds .
7 марта 2024 г.
  • В PretargetingConfig добавлено значение перечисления PUBLISHER_PROVIDED_ID .
29 февраля 2024 г.
  • В Deal добавлено поле mediaPlanner .
  • В Deal добавлено поле eligibleSeatIds .
  • В поле billedBuyer объекта Deal не будет отображаться информация, если он принадлежит аккаунту медиапланера.
29 ноября 2023 г. Добавлено значение перечисления AUDIO в CreativeFormat . Добавлено значение перечисления LG_TV в AppStoreType .
11 октября 2021 г. Первый запуск API авторизованной торговой площадки для покупателей , который позволяет вам:
  • Предлагать и заключать сделки с издателями.
  • Получение информации о завершенных сделках и показателях их состояния.
  • Управление подписками на аукционные пакеты
  • Управление клиентами и пользователями клиентов.
  • Ознакомьтесь с профилями издателей

Версия 1.0 бета

Дата Примечания
14 декабря 2025 г.
  • В версии 1beta кураторы теперь могут использовать ресурсы curatedPackages и mediaPlanners .
  • Поле accountID в ресурсе mediaPlanners устарело.
11 июня 2025 г.
  • Первый релиз API версии 1beta.
  • Ресурс dataSegments теперь доступен в версии 1beta.
    • В версии v1alpha путь к ресурсу dataSegments изменился с buyers/{accountId}/dataSegments на curators/{accountId}/dataSegments в версии v1beta.

Версия 1.0 альфа

Дата Примечания
14 декабря 2025 г.
  • В версии 1alpha кураторы теперь могут использовать ресурсы curatedPackages и mediaPlanners .
  • Поле accountID в ресурсе mediaPlanners устарело.
12 июня 2024 г.
  • Первая версия API v1alpha.

API для торгов в реальном времени

Версия 1.0

Дата Примечания
1 мая 2025 г. Устаревшее значение GOOGLE_RTB из перечисления BidProtocol .
24 февраля 2025 г. В пространство перечисления AdCategoryTaxonomy добавлено новое значение GOOGLE_AD_CATEGORY_TAXONOMY .
13 февраля 2025 г. Устарели объявленные категории с ограниченным доступом в разделе «Творчество» .
6 августа 2024 г.
30 июля 2024 г.
31 октября 2023 г. buyers.userLists.getRemarketingTag и UrlRestriction устарели и при вызове будут возвращать ошибку. Мы рекомендуем использовать функцию google_ula тега Cookie Matching для добавления пользователей в список пользователей путем размещения тега в браузере. Подробнее см. в документации по Cookie Matching.
12 октября 2023 г. Добавлено значение перечисления RENDERING_PLAYABLE в CreativeAttribute .
17 августа 2023 г. buyers.userLists.getRemarketingTag и UrlRestriction устарели и будут сняты с поддержки 31 октября 2023 года. Используйте функцию google_ula тега Cookie Matching для добавления пользователей в список пользователей, разместив тег в браузере. Подробнее см. в документации по Cookie Matching.
17 марта 2023 г. Добавлено поле missingCertificate в PolicyTopicEntry .
7 февраля 2023 г.

Из объекта 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
8 ноября 2022 г.

Добавлено новое значение перечисления OPENRTB_PROTOBUF для bidders.endpoints.bidProtocol . В дальнейшем будет поддерживаться только одна версия OpenRTB одновременно. Для использования последней поддерживаемой версии OpenRTB в предпочитаемом формате следует использовать OPENRTB_JSON или OpenRTB_PROTOBUF Подробнее см. в нашей статье в блоге об удалении поддержки старых версий OpenRTB .

Следующие поля перечисления из 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
20 сентября 2022 г. Введено экспериментальное поле creatives.renderUrl для пробных запусков FLEDGE.
1 сентября 2022 г. Введен статус CERTIFICATE_REQUIRED для некоторых креативов. Дополнительную информацию см. в политике в отношении азартных игр .
27 апреля 2022 г. Выпущен ресурс publisherConnections . Биржи Open Bidding могут использовать publisherConnections для управления связями с издателями.
1 ноября 2021 г. Добавлена ​​функция bidders.enpoints.patch для обновления конечной точки участника торгов.
27 мая 2021 г. В ресурс Native Creatives добавлено поле `oneof` video , которое принимает либо ` videoVastXml , либо videoUrl .
8 октября 2020 г. Поля openAuctionServingStatus , openBiddingServingStatus , dealsServingStatus , chinaServingStatus и russiaServingStatus заменены на networkPolicyCompliance , platformPolicyCompliance , dealsPolicyCompliance , chinaPolicyCompliance и russiaPolicyCompliance соответственно.
24 июня 2020 г. Первоначальный запуск API для торгов в реальном времени , который в конечном итоге заменит API для покупателей рекламных площадок и Ad Exchange Buyer II.

Наследие

Версия 2.0 (устарела)

Дата Примечания
8/11/2025

В перечисление Status объекта NonBillableWinningBidStatusRow добавлен статус OVERDELIVERED_IMPRESSION .

29.09.2023

Все ресурсы, кроме тех, что использовались для устранения неполадок RTB, устарели и при вызове будут возвращать сообщение об ошибке. Мы рекомендуем перейти на API Marketplace, чтобы продолжить программный доступ к Marketplace. К устаревшим ресурсам относятся следующие и все их подресурсы:

  • accounts.clients
  • accounts.creatives
  • accounts.finalizedProposals
  • accounts.products
  • accounts.proposals
  • accounts.publisherProfiles
  • accounts.clients
24.05.2021

Добавлены методы pause и resume сделки на уровне отдельных транзакций.

20.08.2020

Добавлено поле detail в BidMetricsRow .

05.06.2020

Добавлено поле reachedQueries в BidMetricsRow . Добавлены FATAL_VAST_ERROR и LOST_IN_MEDIATION в перечисление Status объекта NonBillableWinningBidStatusRow .

03.09.2016

Выпущена открытая бета-версия доступа для клиентов . Теперь вы можете разрешить покупателям ваших клиентов напрямую получать доступ к торговой площадке авторизованных покупателей, чтобы просматривать, обсуждать и утверждать сделки. Кроме того, ваше приложение может программно выполнять операции, которые ранее приходилось делать вручную в разделе «Клиенты» на вкладке «Настройки учетной записи покупателя авторизованных покупателей».