Informacje o wersjach

Marketplace API

Wersja 1.0

Data Uwagi
14 grudnia 2025 r.
  • Pole accountID w zasobie mediaPlanners zostało wycofane.
10 listopada 2025 r.
26 sierpnia 2025 r.
  • W przypadku kierowania na rozmiar zasobów reklamowych podczas wywoływania metody buyers.proposals.sendRfp dozwolone są tylko rozmiary zasobów reklamowych PIXEL.
27 lutego 2025 r.
9 grudnia 2024 r.
17 czerwca 2024 r.
6 czerwca 2024 r.
25 kwietnia 2024 r.
23 kwietnia 2024 r. Dodano wartość kierowania excludedSensitiveCategoryIds do: MarketplaceTargeting. Dodano wartość kierowania vertical_targeting do MarketplaceTargeting.
15 kwietnia 2024 r.
  • Wprowadziliśmy metodę bidders.auctionPackages.list, która umożliwia wyświetlanie listy pakietów aukcji na poziomie licytującego. Pakiety aukcji zwracane przez tę metodę zawierają listę media plannerów, którzy je subskrybują, w polu subscribedMediaPlanners.
  • Wprowadziliśmy pole subscribedBuyers w AuctionPackage.
  • Wprowadziliśmy pole subscribedMediaPlanners w AuctionPackage.
  • Wprowadziliśmy pole eligibleSeatIds w AuctionPackage.
7 marca 2024 r.
29 lutego 2024 r.
  • Wprowadziliśmy pole mediaPlanner w Deal.
  • Wprowadziliśmy pole eligibleSeatIds w Deal.
  • Wartość billedBuyer umowy nie zostanie wypełniona, jeśli należy ona do konta planera mediów.
29 listopada 2023 r. Dodano wartość typu wyliczeniowego AUDIO do CreativeFormat. Dodano wartość typu wyliczeniowego LG_TV do AppStoreType.
11 października 2021 r. Pierwsza wersja Authorized Buyers Marketplace API, który umożliwia:
  • Proponowanie i negocjowanie umów z wydawcami
  • pobieranie sfinalizowanych umów i wskaźników ich stanu;
  • Zarządzanie subskrypcjami pakietów aukcji
  • Zarządzanie klientami i użytkownikami klientów
  • Odkrywanie profili wydawców

Wersja 1.0 beta

Data Uwagi
19 października 2026 r.
  • Wprowadziliśmy parametr mediaPlanners.search, który umożliwia wyszukiwanie kont planera mediów według identyfikatora stanowiska na platformie DSP.
25 sierpnia 2026 r.
20 lipca 2026 r.
29 czerwca 2026 r.
14 grudnia 2025 r.
  • Zasoby curatedPackages i mediaPlanners są teraz dostępne dla kuratorów w wersji v1beta.
  • Pole accountID w zasobie mediaPlanners zostało wycofane.
11 czerwca 2025 r.
  • Pierwsza wersja interfejsu API w wersji 1 beta.
  • Zasób dataSegments jest już dostępny w wersji 1beta.
    • Ścieżka zasobu dataSegments zmieniła się z buyers/{accountId}/dataSegments w wersji v1alpha na curators/{accountId}/dataSegments w wersji v1beta

Wersja 1.0 alfa

Data Uwagi
19 października 2026 r.
  • Wprowadziliśmy parametr mediaPlanners.search, który umożliwia wyszukiwanie kont planera mediów według identyfikatora konta na platformie DSP.
25 sierpnia 2026 r.
20 lipca 2026 r.
29 czerwca 2026 r.
14 grudnia 2025 r.
  • Zasoby curatedPackages i mediaPlanners są teraz dostępne dla kuratorów w wersji v1alpha.
  • Pole accountID w zasobie mediaPlanners zostało wycofane.
12 czerwca 2024 r.
  • Pierwsza wersja interfejsu API v1alpha.

Real-time Bidding API

Wersja 1.0

Data Uwagi
10 listopada 2026 r. Wprowadziliśmy parametr zapytania adCategoryTaxonomyOverride do metod buyers.creatives.get, buyers.creatives.list i bidders.creatives.list, aby umożliwić licytującym zastępowanie parametru AdCategoryTaxonomy używanego w odpowiedzi. Dodano wartość typu wyliczeniowego IAB_CONTENT_2_2 do AdCategoryTaxonomy. Taksonomii treści IAB w wersji 2.2 nie można obecnie skonfigurować jako taksonomii kategorii reklam na kontach Authorized Buyers ani Otwartego ustalania stawek.
20 września 2026 r. Wycofaliśmy stan CERTIFICATE_REQUIRED i pole missingCertificate po aktualizacji zasad, zgodnie z którą certyfikaty nie są już wymagane w przypadku hazardu i społecznościowych gier hazardowych.
10 września 2026 r. Wprowadziliśmy metodę addDeals w zasobie buyers.creatives, która umożliwia kupującym powiązanie identyfikatorów umów (w tym automatyzacji gwarantowanej, aukcji prywatnej, umowy preferencyjnej i pakietu rynkowego) z kreacją.
9 lipca 2026 r. Wycofano pole allowed_user_targeting_modes i typ wyliczeniowy UserTargetingMode w  PretargetingConfig.
1 maja 2025 r. Wycofana wartość GOOGLE_RTB z przestrzeni typu wyliczeniowego BidProtocol.
24 lutego 2025 r. Dodano nową wartość GOOGLE_AD_CATEGORY_TAXONOMY do typu wyliczeniowego AdCategoryTaxonomy.
13 lutego 2025 r. Wycofano zadeklarowane kategorie objęte ograniczeniami w obiekcie Creative.
6 sierpnia 2024 r.
30 lipca 2024 r.
31 października 2023 r. buyers.userLists.getRemarketingTag i UrlRestriction zostały wycofane i w przypadku wywołania zwrócą błąd. Zalecamy użycie funkcji google_ula tagu dopasowania plików cookie, aby dodawać użytkowników do listy użytkowników przez umieszczenie tagu z przeglądarek. Więcej informacji znajdziesz w dokumentacji dotyczącej dopasowywania plików cookie.
12 października 2023 r. Dodano wartość typu wyliczeniowego RENDERING_PLAYABLE do CreativeAttribute.
17 sierpnia 2023 r. buyers.userLists.getRemarketingTag i UrlRestriction zostały wycofane i zostaną wyłączone 31 października 2023 r. Użyj funkcji google_ula tagu dopasowania plików cookie, aby dodawać użytkowników do listy użytkowników przez umieszczenie tagu z przeglądarek. Więcej informacji znajdziesz w dokumentacji dotyczącej dopasowywania plików cookie.
17 marca 2023 r. Dodano pole missingCertificate do PolicyTopicEntry.
7 lutego 2023 r.

Usunięto te wycofane wartości typu wyliczeniowego z 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 listopada 2022 r.

Dodaliśmy nową wartość typu wyliczeniowego OPENRTB_PROTOBUF dla bidders.endpoints.bidProtocol. W przyszłości będzie obsługiwana tylko jedna wersja OpenRTB naraz. Aby używać najnowszej obsługiwanej wersji OpenRTB w preferowanym formacie, użyj OPENRTB_JSON lub OpenRTB_PROTOBUF. Więcej informacji znajdziesz w poście na blogu o wycofaniu obsługi starszych wersji OpenRTB.

Te pola typu wyliczeniowego z bidders.endpoints.bidProtocol zostały oznaczone jako wycofane:

  • 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 września 2022 r. Wprowadziliśmy eksperymentalne pole creatives.renderUrl na potrzeby testowania origin FLEDGE.
1 września 2022 r. Wprowadziliśmy stan CERTIFICATE_REQUIRED w przypadku niektórych kreacji. Więcej informacji znajdziesz w zasadach dotyczących hazardu i gier.
27 kwietnia 2022 r. Zwolnienie zasobu publisherConnections. Giełdy korzystające z Otwartego ustalania stawek mogą używać publisherConnections do zarządzania połączeniami z wydawcami.
1 listopada 2021 r. Wprowadziliśmy metodę bidders.enpoints.patch, która umożliwia aktualizowanie punktu końcowego licytującego.
27 maja 2021 r. Wprowadziliśmy pole oneof video w zasobie Kreacje natywne, które akceptuje videoVastXml lub videoUrl.
8 października 2020 r. Zastąpiono pola openAuctionServingStatus, openBiddingServingStatus, dealsServingStatus, chinaServingStatus i russiaServingStatus odpowiednio polami networkPolicyCompliance, platformPolicyCompliance, dealsPolicyCompliance, chinaPolicyCompliance i russiaPolicyCompliance.
24 czerwca 2020 r. Pierwsze uruchomienie interfejsu API określania stawek w czasie rzeczywistym, który ostatecznie zastąpi interfejsy Ad Exchange Buyer i Ad Exchange Buyer II.

Starsza wersja

Wersja 2.0 (wycofana)

Data Uwagi
11.08.2025

Dodano stan OVERDELIVERED_IMPRESSION do typu wyliczeniowego Status w NonBillableWinningBidStatusRow.

29.09.2023

Wszystkie zasoby inne niż te używane do rozwiązywania problemów z RTB zostały wycofane i w przypadku wywołania zwrócą odpowiedź o błędzie. Zalecamy przejście na interfejs Marketplace API, aby nadal mieć dostęp do Marketplace w sposób zautomatyzowany. Zasoby Sunset obejmują te zasoby i wszystkie ich zasoby podrzędne:

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

Dodano metody pause i resume na poziomie umowy.

20.08.2020

Dodano pole detail do BidMetricsRow.

6 maja 2020 r.

Dodano pole reachedQueries do BidMetricsRow. Dodano FATAL_VAST_ERROR i LOST_IN_MEDIATION do typu wyliczeniowego Status w NonBillableWinningBidStatusRow.

3/9/2016

Udostępniliśmy dostęp klienta w otwartej wersji beta. Możesz teraz zezwolić kupującym, którzy są Twoimi klientami, na bezpośredni dostęp do rynku Authorized Buyers, aby mogli wyświetlać, negocjować i zatwierdzać umowy. Aplikacja może też automatycznie wykonywać operacje, które wcześniej trzeba było wykonywać ręcznie w sekcji Klienci na karcie Ustawienia konta kupującego w Authorized Buyers.