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

Marketplace API

Версия 1.0

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

Версия 1.0 (бета)

Дата Примечания
19 октября 2026 г.
  • Добавлен метод mediaPlanners.search для поиска аккаунтов менеджеров по медиапланированию по идентификатору места на платформе покупателя.
25 августа 2026 г.
  • В DataSegment добавлено поле userListId.
20 июля 2026 г.
29 июня 2026 г.
14 декабря 2025 г.
  • Ресурсы curatedPackages и mediaPlanners теперь доступны кураторам в версии v1beta.
  • Поле accountID в ресурсе mediaPlanners больше не поддерживается.
11 июня 2025 г.
  • Первый выпуск API v1beta.
  • Ресурс dataSegments теперь доступен в версии v1beta.
    • Путь к ресурсу dataSegments изменен с buyers/{accountId}/dataSegments в v1alpha на curators/{accountId}/dataSegments в v1beta.

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

Дата Примечания
19 октября 2026 г.
  • Добавлен метод mediaPlanners.search для поиска аккаунтов менеджеров по медиапланированию по идентификатору места на платформе покупателя.
25 августа 2026 г.
  • В DataSegment добавлено поле userListId.
20 июля 2026 г.
29 июня 2026 г.
14 декабря 2025 г.
  • Ресурсы curatedPackages и mediaPlanners теперь доступны для кураторов в версии v1alpha.
  • Поле accountID в ресурсе mediaPlanners больше не поддерживается.
12 июня 2024 г.
  • Первый выпуск API v1alpha.

Real-time Bidding API

Версия 1.0

Дата Примечания
20 сентября 2026 г. Статус CERTIFICATE_REQUIRED и поле missingCertificate объявлены устаревшими в связи с изменением правил, согласно которому сертификаты для азартных игр и их симуляторов больше не требуются.
10 сентября 2026 г. В ресурс buyers.creatives добавлен метод addDeals, позволяющий покупателям связывать идентификаторы сделок (в том числе гарантированных сделок с алгоритмической продажей, частных аукционов, приоритетных сделок и пакетов для торговых площадок) с креативами.
9 июля 2026 г. Прекращена поддержка поля allowed_user_targeting_modes и перечисления UserTargetingMode в PretargetingConfig.
1 мая 2025 г. Значение GOOGLE_RTB из перечисления BidProtocol больше не поддерживается.
24 февраля 2025 г. В пространство перечисления AdCategoryTaxonomy добавлено новое значение GOOGLE_AD_CATEGORY_TAXONOMY.
13 февраля 2025 г. Прекращена поддержка объявленных категорий с ограничениями в объекте Creative.
6 августа 2024 г.
  • В ресурс CreativeServingDecision добавлены поля detectedCategoriesTaxonomy и detectedCategories.
30 июля 2024 г.
31 октября 2023 г. Поддержка buyers.userLists.getRemarketingTag и UrlRestriction прекращена. При вызове этих методов будет возвращаться ошибка. Рекомендуем использовать функцию google_ula тега сопоставления файлов cookie, чтобы добавлять пользователей в список, размещая тег из браузеров. Подробную информацию вы найдете в документации по сопоставлению файлов cookie.
12 октября 2023 г. В CreativeAttribute добавлено значение перечисления RENDERING_PLAYABLE.
17 августа 2023 г. Поддержка buyers.userLists.getRemarketingTag и UrlRestriction прекращена, и они будут удалены 31 октября 2023 г. Используйте функцию google_ula тега сопоставления файлов cookie, чтобы добавлять пользователей в список, размещая тег из браузеров. Подробную информацию вы найдете в документации по сопоставлению файлов cookie.
17 марта 2023 г. В PolicyTopicEntry добавлено поле missingCertificate.
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 назначения ставок в реальном времени, который в конечном итоге заменит Ad Exchange Buyer API и Ad Exchange Buyer II API.

Устаревшая версия

Версия 2.0 (поддержка прекращена)

Дата Примечания
11.08.2025

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

29.09.2023

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

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

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

20.08.2020

В BidMetricsRow добавлено поле detail.

05.06.2020

В BidMetricsRow добавлено поле reachedQueries. В перечисление Status ресурса NonBillableWinningBidStatusRow добавлены значения FATAL_VAST_ERROR и LOST_IN_MEDIATION.

09.03.2016

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