Esegui la migrazione all'API Marketplace

Abilita l'API

Come per le altre API di Authorized Buyers, devi abilitare l'API Marketplace prima di poterla utilizzare. Per abilitare l'API Marketplace, segui questi passaggi:

  1. Vai alla pagina API abilitate nella console API di Google. Seleziona il progetto che utilizzi per accedere ad altre API Authorized Buyers, ad esempio Ad Exchange Buyer II o API Real-time Bidding.
  2. Fai clic sul link + ABILITA API E SERVIZI.
  3. Nella casella di ricerca, digita "API Marketplace di Authorized Buyers" e premi Invio.
  4. Nei risultati di ricerca, seleziona API Marketplace di Authorized Buyers.
  5. Fai clic sul pulsante ABILITA per abilitare l'API Marketplace.
  6. Ora dovresti essere in grado di accedere all'API Marketplace con le credenziali create in questo progetto.

Aggiorna le credenziali OAuth 2.0

I flussi di lavoro OAuth 2.0 esistenti con l'ambito dell'API Buyer II di Ad Exchange devono essere modificati per utilizzare l'ambito dell'API Marketplace:

https://www.googleapis.com/auth/authorized-buyers-marketplace

Ti consigliamo di utilizzare il flusso OAuth 2.0 per gli account di servizio per accedere all'API. Tutti i flussi OAuth 2.0 supportati devono specificare il nuovo ambito API per richiedere a Google un token che possa accedere all'API Marketplace.

Mappatura delle risorse dell'API Ad Exchange Buyer II all'API Marketplace

Clienti

Se utilizzi la risorsa accounts.clients dell'API Buyer II di Ad Exchange, puoi eseguire la migrazione alla risorsa buyers.clients dell'API Marketplace.

Metodi delle risorse

API Buyer II di Ad Exchange API Marketplace
accounts.clients.create buyers.clients.create
accounts.clients.get buyers.clients.get
accounts.clients.list buyers.clients.list

Questo metodo ora supporta filtri elenco.

accounts.clients.update buyers.clients.patch

Questo metodo ora supporta gli aggiornamenti parziali con il parametro updateMask.

Campi delle risorse

API Buyer II di Ad Exchange API Marketplace
Client.clientAccountId Client.name

clientAccountId è l'ID risorsa client.
Client.role Client.role
Client.status Client.state
Client.clientName Client.displayName
Client.visibleToSeller Client.sellerVisible
Client.entityType

Questo campo è stato ritirato.
Client.entityId

Questo campo è stato ritirato.
Client.entityName

Questo campo è stato ritirato.
Client.partnerClientId Client.partnerClientId

Inviti e utenti

L'API Marketplace combina le funzionalità delle risorse accounts.clients.invitations e accounts.clients.users dell'API Buyer II di Ad Exchange in un'unica buyers.clients.users risorsa.

Metodi delle risorse

API Buyer II di Ad Exchange API Marketplace
accounts.clients.invitations.create buyers.clients.users.create
accounts.clients.invitations.get buyers.clients.users.get
accounts.clients.invitations.list buyers.clients.users.list

Solo gli utenti con state impostato su INVITED saranno equivalenti a quelli restituiti da accounts.clients.invitations.list.

accounts.clients.users.get buyers.clients.users.get
accounts.clients.users.list buyers.clients.users.list
accounts.clients.users.update

Non puoi più applicare patch agli utenti client con l'API. Ti consigliamo di utilizzare buyers.clients.users.delete per eliminare l'utente client e ricrearlo con le modifiche preferite.

Campi delle risorse

API Buyer II di Ad Exchange API Marketplace
ClientUserInvitation.invitationId

Questo campo è stato ritirato.
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

Questo campo non esiste più per gli utenti client. Visualizza invece il valore clientAccountId nel nome del client principale.
ClientUser.userId ClientUser.name

userId è l'ID risorsa utente.
ClientUser.clientAccountId

Questo campo non esiste più per gli utenti client. Visualizza invece il valore clientAccountId nel nome del client principale.
ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

Prodotti

Questa risorsa e le relative funzionalità non sono disponibili nell'API Marketplace.

PublisherProfiles

Se utilizzi la risorsa accounts.publisherProfiles dell'API Buyer II di Ad Exchange, puoi eseguire la migrazione alla risorsa buyers.publisherProfiles dell'API Marketplace.

Metodi delle risorse

API Buyer II di Ad Exchange API Marketplace
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

Questo metodo ora supporta filtri degli elenchi.

Campi delle risorse

API Buyer II di Ad Exchange API Marketplace
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId è l'ID risorsa del profilo del publisher.
PublisherProfile.seller.accountId PublisherProfile.seller.accountId
PublisherProfile.seller.subAccountId PublisherProfile.seller.subAccountId
PublisherProfile.displayName PublisherProfile.displayName
PublisherProfile.domains PublisherProfile.domains
PublisherProfile.mobileApps PublisherProfile.mobileApps
PublisherProfile.logoUrl PublisherProfile.logoUrl
PublisherProfile.directDealsContact PublisherProfile.directDealsContact
PublisherProfile.programmaticDealsContact PublisherProfile.programmaticDealsContact
PublisherProfile.mediaKitUrl PublisherProfile.mediaKitUrl
PublisherProfile.samplePageUrl PublisherProfile.samplePageUrl
PublisherProfile.rateCardUrl

Questo campo è stato ritirato.
PublisherProfile.googlePlusUrl

Questo campo è stato ritirato.
PublisherProfile.overview PublisherProfile.overview
PublisherProfile.buyerPitchStatement PublisherProfile.pitchStatement
PublisherProfile.topHeadlines PublisherProfile.topHeadlines
PublisherProfile.audienceDescription PublisherProfile.audienceDescription
PublisherProfile.isParent PublisherProfile.isParent

Proposals e FinalizedProposals

Se utilizzi la risorsa accounts.proposals dell'API Ad Exchange Buyer II, puoi eseguire la migrazione alla risorsa buyers.proposals dell'API Marketplace. Le offerte sono state separate dalle proposte nella risorsa secondaria buyers.proposals.deals. Le proposte finalizzate non sono più rappresentate nell'API, il che ti consente di avere un controllo più granulare dei deal finalizzati con la risorsa buyers.finalizedDeals.

Metodi delle risorse

API Buyer II di Ad Exchange API Marketplace
accounts.proposals.accept buyers.proposals.accept

Chiama buyers.proposals.accept solo quando lo stato della proposta è BUYER_ACCEPTANCE_REQUESTED.
accounts.proposals.addNote buyers.proposals.addNote
accounts.proposals.cancelNegotiation buyers.proposals.cancelNegotiation
accounts.proposals.completeSetup buyers.finalizedDeals.setReadyToServe
accounts.proposals.create buyers.proposals.sendRfp
accounts.proposals.get buyers.proposals.get

Tieni presente che la proposta non conterrà più informazioni sui deal.

accounts.proposals.list buyers.proposals.list

Tieni presente che le proposte restituite non conterranno più informazioni sui deal. Se utilizzi i filtri degli elenchi, tieni presente che l'API Marketplace supporta solo la sintassi dei filtri degli elenchi.
accounts.proposals.pause buyers.finalizedDeals.pause
accounts.proposals.resume buyers.finalizedDeals.resume
accounts.proposals.update buyers.proposals.patch

Questo metodo ora supporta gli aggiornamenti parziali con il parametro updateMask.
accounts.finalizedProposals.list

Utilizza buyers.finalizedDeals.list per visualizzare i deal finalizzati per un determinato account acquirente. Ora è possibile recuperare i deal definitivi a livello di offerente con bidders.finalizedDeals.list.
accounts.finalizedProposals.pause

Utilizza buyers.finalizedDeals.pause per mettere in pausa i singoli deal finalizzati per un determinato account acquirente.
accounts.finalizedProposals.resume

Utilizza buyers.finalizedDeals.resume per riprendere i singoli deal finalizzati per un determinato account acquirente.

Campi delle risorse

Le risorse proposals e finalizedProposals condividono la stessa rappresentazione Proposal e prevedono passaggi di migrazione simili.

API Ad Exchange Buyer II API Marketplace
Proposal.proposalId Proposal.name

proposalId è l'ID risorsa della proposta.
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

Proposal.proposalRevision e Deal.proposalRevision
Proposal.deals.dealId Deal.name

dealId è l'ID risorsa del deal.
Proposal.deals.proposalId Deal.name

proposalId è l'ID della risorsa della proposta padre.
Proposal.deals.createTime Deal.createTime
Proposal.deals.updateTime Deal.updateTime
Proposal.deals.createProductId

Questo campo è stato ritirato.
Proposal.deals.createProductRevision

Questo campo è stato ritirato.
Proposal.deals.displayName Deal.displayName
Proposal.deals.buyerPrivateData.referenceId

Questo campo è stato ritirato. Ora è esposto solo a livello di proposta.
Proposal.deals.dealTerms.description Deal.description
Proposal.deals.dealTerms.brandingType

Questo campo è stato ritirato.
Proposal.deals.dealTerms.estimatedGrossSpend Deal.estimatedGrossSpend
Proposal.deals.dealTerms.estimatedImpressionsPerDay

Questo campo è stato ritirato.
Proposal.deals.dealTerms.sellerTimeZone Deal.sellerTimeZone
Proposal.deals.dealTerms.guaranteedFixedPriceTerms

Deal.programmaticGuaranteedTerms

Tieni presente che, anche se guaranteedFixedPriceTerms.fixedPrices è un campo ripetuto, non è mai stato compilato con più di una voce. Di conseguenza, il valore programmaticGuaranteedTerms.fixedPrice dell'API Marketplace è equivalente.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

Tieni presente che, anche se nonGuaranteedFixedPriceTerms.fixedPrices è un campo ripetuto, non è mai stato compilato con più di una voce. Di conseguenza, il valore preferredDealTerms.fixedPrice dell'API Marketplace è equivalente.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

Tieni presente che, anche se nonGuaranteedAuctionTerms.reservePricesPerBuyer è un campo ripetuto, non è mai stato compilato con più di una voce. Di conseguenza, il valore privateAuctionTerms.floorPrice dell'API Marketplace è equivalente.
Proposal.deals.webPropertyCode

Questo campo è stato ritirato.
Proposal.deals.sellerContacts Proposal.sellerContacts
Proposal.deals.availableStartTime Proposal.flightStartTime
Proposal.deals.availableEndTime Proposal.flightEndTime
Proposal.deals.description Proposal.description
Proposal.deals.targetingCriterion Deal.targeting

Non è più possibile configurare il targeting utilizzando una chiave per determinare la categoria di targeting. Tuttavia, le categorie che possono essere scelte come target sono disponibili in Deal.targeting. Ad esempio, la chiave GOOG_CREATIVE_SIZE di Ad Exchange Buyer II fa riferimento a Deal.targeting.inventorySizeTargeting dell'API Marketplace.
Proposal.deals.targeting Deal.targeting

Sono state aggiunte categorie di criteri di targeting aggiuntivi.
Proposal.deals.creativeRestrictions.creativeFormat Deal.creativeRequirements.creativeFormat
Proposal.deals.creativeRestrictions.skippableAdType Deal.creativeRequirements.skippableAdType
Proposal.deals.creativeRestrictions.creativeSpecifications.creativeSize Deal.targeting.inventorySizeTargeting
Proposal.deals.externalDealId

Questo campo è stato ritirato.
Proposal.deals.syndicationProduct

Questo campo è stato ritirato.
Proposal.deals.creativePreApprovalPolicy Deal.creativeRequirements.creativePreApprovalPolicy
Proposal.deals.creativeSafeFrameCompatibility Deal.creativeRequirements.creativeSafeFrameCompatibility
Proposal.deals.dealServingMetadata

Puoi trovare informazioni simili nel campo FinalizedDeal.dealPausingInfo.
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

Sono stati aggiunti ulteriori dettagli su come verranno pubblicati i deal.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

Ora puoi indicare che un deal è pronto per la pubblicazione solo se è stato finalizzato. Utilizza il metodo buyers.finalizedDeals.setReadyToServe per indicare che il deal di pubblicità programmatica garantita finalizzato è pronto per la pubblicazione.
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

Utilizza il nome del profilo del publisher per identificare il venditore. Puoi visualizzare i profili dei publisher con la risorsa buyers.publisherProfiles.
Proposal.seller.subAccountId Proposal.publisherProfile

Utilizza il nome del profilo del publisher per identificare il venditore. Puoi visualizzare i profili dei publisher con la risorsa buyers.publisherProfiles.
Proposal.buyer.accountId

Proposal.buyer o Proposal.client.

Il campo utilizzato dipenderà dal tipo di account dell'acquirente in fase di negoziazione. Si tratta dei nomi delle risorse di un'API Real-time Biddingbuyers o di un'API Marketplacebuyers.buyers.clients
Proposal.billedBuyer.accountId Proposal.billedBuyer

Ora si tratta di un nome della risorsa che fa riferimento a un account acquirente come rappresentato nella risorsa buyers dell'API Real-time Bidding.
Proposal.displayName Proposal.displayName
Proposal.proposalState Proposal.state
Proposal.isRenegotiating Proposal.isRenegotiating
Proposal.buyerPrivateData Proposal.buyerPrivateData
Proposal.sellerContacts Proposal.sellerContacts
Proposal.buyerContacts Proposal.buyerContacts
Proposal.privateAuctionId

Questo campo è stato ritirato.
Proposal.isSetupComplete FinalizedDeal.readyToServe

Ora è possibile accedere in modo più granulare con buyers.finalizedDeals.

Proposal.lastUpdaterOrCommentorRole Proposal.lastUpdaterOrCommentorRole
Proposal.notes.proposalRevision

Questo campo è stato ritirato.
Proposal.notes.noteId

Questo campo è stato ritirato.
Proposal.notes.createTime Proposal.notes.createTime
Proposal.notes.creatorRole Proposal.notes.creatorRole
Proposal.notes.note Proposal.notes.note
Proposal.termsAndConditions Proposal.termsAndConditions