Note di rilascio

API Marketplace

Versione 1.0

Data Note
14 dicembre 2025
  • Il campo accountID nella risorsa mediaPlanners è stato deprecato.
10 novembre 2025
26 agosto 2025
  • Quando chiami buyers.proposals.sendRfp, per il targeting per dimensione dell'inventario sono consentite solo le dimensioni dell'inventario PIXEL.
27 febbraio 2025
9 dicembre 2024
17 giugno 2024
6 giugno 2024
25 aprile 2024
23 aprile 2024 È stato aggiunto il valore di targeting excludedSensitiveCategoryIds a MarketplaceTargeting. È stato aggiunto il valore di targeting vertical_targeting a MarketplaceTargeting.
15 aprile 2024
  • È stato introdotto bidders.auctionPackages.list per elencare i pacchetti di aste a livello di offerente. I pacchetti di aste restituiti da questo metodo elencano i media planner che li hanno sottoscritti con il campo subscribedMediaPlanners.
  • È stato introdotto il campo subscribedBuyers in AuctionPackage.
  • È stato introdotto il campo subscribedMediaPlanners in AuctionPackage.
  • È stato introdotto il campo eligibleSeatIds in AuctionPackage.
7 marzo 2024
29 febbraio 2024
  • È stato introdotto il campo mediaPlanner in Deal.
  • È stato introdotto il campo eligibleSeatIds in Deal.
  • Il campo billedBuyer del deal non verrà compilato se appartiene a un account Media Planner.
29 novembre 2023 È stato aggiunto il valore enum AUDIO a CreativeFormat. È stato aggiunto il valore enum LG_TV a AppStoreType.
11 ottobre 2021 Lancio iniziale dell'API Marketplace di Authorized Buyers, che ti consente di:
  • Proporre e negoziare deal con i publisher
  • Recupera i deal finalizzati e le metriche sullo stato dei deal
  • Gestisci le sottoscrizioni ai pacchetti di aste
  • Gestisci i clienti e gli utenti dei clienti
  • Scopri i profili dei publisher

Versione 1.0 beta

Data Note
19 ottobre 2026
  • È stato introdotto mediaPlanners.search per cercare gli account Media Planner in base all'ID seat DSP.
25 agosto 2026
  • È stato introdotto il campo userListId in DataSegment.
20 luglio 2026
29 giugno 2026
14 dicembre 2025
  • Le risorse curatedPackages e mediaPlanners sono ora disponibili per i curatori nella versione v1beta.
  • Il campo accountID nella risorsa mediaPlanners è stato ritirato.
11 giugno 2025
  • Release iniziale dell'API v1beta.
  • La risorsa dataSegments è ora disponibile nella versione v1beta.
    • Il percorso della risorsa per dataSegments è cambiato da buyers/{accountId}/dataSegments in v1alpha a curators/{accountId}/dataSegments in v1beta

Versione 1.0 alpha

Data Note
19 ottobre 2026
  • È stato introdotto mediaPlanners.search per cercare gli account Media Planner in base all'ID seat DSP.
25 agosto 2026
  • È stato introdotto il campo userListId in DataSegment.
20 luglio 2026
29 giugno 2026
14 dicembre 2025
  • Le risorse curatedPackages e mediaPlanners sono ora disponibili per i curatori nella versione v1alpha.
  • Il campo accountID nella risorsa mediaPlanners è stato ritirato.
12 giugno 2024
  • Release iniziale dell'API v1alpha.

Real-time Bidding API

Versione 1.0

Data Note
20 settembre 2026 È stato ritirato lo stato CERTIFICATE_REQUIRED e il campo missingCertificate in seguito agli aggiornamenti delle norme che non richiedono più certificati per giochi e scommesse e giochi da casinò social.
10 settembre 2026 È stato introdotto il metodo addDeals nella risorsa buyers.creatives, consentendo agli acquirenti di associare gli ID deal (tra cui pubblicità programmatica garantita, asta privata, preferred deal e pacchetto marketplace) a una creatività.
9 luglio 2026 Il campo allowed_user_targeting_modes e l'enum UserTargetingMode in PretargetingConfig sono stati ritirati.
1° maggio 2025 Valore deprecato GOOGLE_RTB dallo spazio enum BidProtocol.
24 febbraio 2025 È stato aggiunto il nuovo valore GOOGLE_AD_CATEGORY_TAXONOMY allo spazio enum AdCategoryTaxonomy.
13 febbraio 2025 Categorie con restrizioni dichiarate ritirate in Creatività.
6 agosto 2024
30 luglio 2024
31 ottobre 2023 buyers.userLists.getRemarketingTag e UrlRestriction sono stati ritirati e restituiranno una risposta di errore se chiamati. Ti consigliamo di utilizzare la funzionalità google_ula del tag di cookie matching per aggiungere utenti all'elenco di utenti inserendo un tag dai browser. Scopri di più nella documentazione sulla corrispondenza dei cookie
12 ottobre 2023 È stato aggiunto il valore enum RENDERING_PLAYABLE a CreativeAttribute.
17 agosto 2023 buyers.userLists.getRemarketingTag e UrlRestriction sono deprecati e verranno ritirati il 31/10/2023. Utilizza la funzionalità google_ula del tag di cookie matching per aggiungere utenti all'elenco di utenti inserendo un tag dai browser. Scopri di più nella documentazione sulla corrispondenza dei cookie
17 marzo 2023 Aggiunto il campo missingCertificate a PolicyTopicEntry.
7 febbraio 2023

Sono stati rimossi i seguenti valori enum deprecati da 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 novembre 2022

Aggiunto un nuovo valore enum OPENRTB_PROTOBUF per bidders.endpoints.bidProtocol. In futuro, verrà supportata una sola versione di OpenRTB alla volta. Devi utilizzare OPENRTB_JSON o OpenRTB_PROTOBUF per utilizzare l'ultima versione supportata di OpenRTB nel formato che preferisci. Per maggiori dettagli, consulta il nostro post del blog sulla rimozione del supporto per le versioni precedenti di OpenRTB.

I seguenti campi enum di bidders.endpoints.bidProtocol sono stati contrassegnati come deprecati:

  • 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 settembre 2022 Introdotto il campo sperimentale creatives.renderUrl per le origin trial di FLEDGE.
1° settembre 2022 È stato introdotto lo stato CERTIFICATE_REQUIRED per alcune creatività. Per saperne di più, consulta le norme relative a giochi e scommesse.
27 aprile 2022 Rilascio della risorsa publisherConnections. Le piattaforme di scambio Open Bidding possono utilizzare publisherConnections per gestire le connessioni con i publisher.
1° nov 2021 Introdotto bidders.enpoints.patch per aggiornare l'endpoint di un offerente.
27 maggio 2021 È stato introdotto il campo oneof video nella risorsa Native Creatives, che accetta videoVastXml o videoUrl.
8 ottobre 2020 I campi openAuctionServingStatus, openBiddingServingStatus, dealsServingStatus, chinaServingStatus e russiaServingStatus sono stati sostituiti rispettivamente con networkPolicyCompliance, platformPolicyCompliance, dealsPolicyCompliance, chinaPolicyCompliance e russiaPolicyCompliance.
24 giugno 2020 Lancio iniziale dell'API Offerte in tempo reale, che alla fine sostituirà le API Ad Exchange Buyer e Ad Exchange Buyer II.

Legacy

Versione 2.0 (ritirata)

Data Note
11/8/2025

Aggiunto lo stato OVERDELIVERED_IMPRESSION all'enum Status di NonBillableWinningBidStatusRow.

29/09/2023

Tutte le risorse diverse da quelle utilizzate per la risoluzione dei problemi di RTB sono state ritirate e restituiranno una risposta di errore se chiamate. Ti consigliamo di eseguire la migrazione all'API Marketplace per continuare ad accedere a Marketplace in modo programmatico. Le risorse ritirate includono le seguenti e tutte le relative risorse secondarie:

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

Aggiunti i metodi pause e resume a livello di deal.

20/08/2020

Aggiunto il campo detail a BidMetricsRow.

6/5/2020

Aggiunto il campo reachedQueries a BidMetricsRow. Abbiamo aggiunto FATAL_VAST_ERROR e LOST_IN_MEDIATION all'enum Status di NonBillableWinningBidStatusRow.

9/3/2016

Rilascio di Accesso client come beta aperta. Ora puoi consentire ai tuoi acquirenti clienti di accedere direttamente al Marketplace di Authorized Buyers per visualizzare, negoziare e approvare i deal. Inoltre, la tua applicazione può eseguire in modo programmatico operazioni che in precedenza dovevano essere eseguite manualmente nella sezione Clienti della scheda Impostazioni account acquirente di Authorized Buyers.