Esegui la migrazione all'API Marketplace

Abilita l'API

Simile ad altri acquirenti Authorized Buyers API, devi abilitare API Marketplace prima del giorno puoi utilizzarlo. Puoi abilitare l'API Marketplace con i seguenti passaggi:

  1. Vai alle API abilitate per la console API di Google . Seleziona il progetto che utilizzi per accedere ad altre API di Authorized Buyers, come Acquirente II di Ad Exchange oppure 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 creati in questo progetto.

Aggiornare le credenziali OAuth 2.0

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

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

È consigliabile utilizzare OAuth 2.0 dell'account di servizio per accedere all'API. Tutti i flussi OAuth 2.0 supportati devono specificare la nuova API per richiedere a Google un token che possa accedere all'API Marketplace.

Mappare le risorse dell'API Ad Exchange Buyer II all'API Marketplace

Clienti

Se utilizzi l'API di Ad Exchange Buyer II accounts.clients puoi eseguire la migrazione alle API Marketplace buyers.clients risorsa.

Metodi delle risorse

API Ad Exchange Buyers II 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 Parametro updateMask.

Campi delle risorse

API Ad Exchange Buyers II API Marketplace
Client.clientAccountId Client.name

clientAccountId è l'ID risorsa del 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 la funzionalità dell'API Ad Exchange Buyer II accounts.clients.invitations e accounts.clients.users in un unico buyers.clients.users risorsa.

Metodi delle risorse

API Ad Exchange Buyers II 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 il valore state impostato su INVITED saranno equivalenti a quelle restituite 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. I nostri suggerimenti che utilizzi buyers.clients.users.delete per eliminare dell'utente e ricrearlo con le modifiche preferite.

Campi delle risorse

API Ad Exchange Buyers II API Marketplace
ClientUserInvitation.invitationId

Questo campo è stato ritirato.

ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

Questo campo non esiste più per gli utenti cliente. Puoi visualizzare invece clientAccountId nel nome del client padre.

ClientUser.userId ClientUser.name

userId è l'ID risorsa utente.

ClientUser.clientAccountId

Questo campo non esiste più per gli utenti cliente. Puoi visualizzare invece clientAccountId nel nome del client padre.

ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

Prodotti

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

PublisherProfiles

Se utilizzi l'API di Ad Exchange Buyer II accounts.publisherProfiles puoi eseguire la migrazione alle API Marketplace buyers.publisherProfiles risorsa.

Metodi delle risorse

API Ad Exchange Buyers II API Marketplace
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

Questo metodo ora supporta filtri elenco.

Campi delle risorse

API Ad Exchange Buyers II API Marketplace
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId è la risorsa del profilo del publisher ID.

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

Proposte e FinalizedProposals

Se utilizzi l'API di Ad Exchange Buyer II accounts.proposals puoi eseguire la migrazione alle API Marketplace buyers.proposals risorsa. I deal sono stati separati dalle proposte buyers.proposals.deals risorsa secondaria. Le proposte finalizzate non sono più rappresentate nell'API, un controllo più granulare dei deal definitivi con buyers.finalizedDeals risorsa.

Metodi delle risorse

API Ad Exchange Buyers II 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 sulle offerte. Se utilizzi i filtri degli elenchi, tieni presente che solo l'API Marketplace supporta sintassi del filtro elenco.

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 Parametro updateMask.

accounts.finalizedProposals.list

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

accounts.finalizedProposals.pause

Utilizza buyers.finalizedDeals.pause per mettere in pausa singoli i deal definitivi per un determinato account acquirente.

accounts.finalizedProposals.resume

Utilizza buyers.finalizedDeals.resume per ripristinare la modalità individuale i deal definitivi per un determinato account acquirente.

Campi delle risorse

Le risorse proposals e finalizedProposals condividono lo stesso Proposal e prevedono passaggi di migrazione simili.

API Ad Exchange Buyers 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 alla proposta livello.

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, mentre guaranteedFixedPriceTerms.fixedPrices è un ripetuto, non è mai stato compilato con più di una singola voce. Come Di conseguenza, l'API Marketplace programmaticGuaranteedTerms.fixedPrice è equivalente.

Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

Tieni presente che, mentre nonGuaranteedFixedPriceTerms.fixedPrices è un campo ripetuto, non è mai stato compilato con più di una singola voce. Di conseguenza, l'API Marketplace preferredDealTerms.fixedPrice è equivalente.

Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

Tieni presente che mentre nonGuaranteedAuctionTerms.reservePricesPerBuyer è un ripetuto, non è mai stato compilato con più di una singola voce. Come Di conseguenza, l'API Marketplace privateAuctionTerms.floorPrice è 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 Stabilire la categoria di targeting; tuttavia, categorie che potrebbero essere scelto come target è disponibile in Deal.targeting. Ad esempio, La chiave GOOG_CREATIVE_SIZE di Ad Exchange Acquirente II si riferisce a delle API Marketplace Deal.targeting.inventorySizeTargeting.

Proposal.deals.targeting Deal.targeting

Sono state aggiunte altre categorie di criteri di targeting.

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

Informazioni simili sono disponibili nei campo FinalizedDeal.dealPausingInfo.

Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

Sono stati aggiunti ulteriori dettagli sulla modalità di posizionamento dei deal.

Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

Ora puoi indicare che un deal è pronto per la pubblicazione solo se è stato finalizzato. Usa 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 buyers.publisherProfiles risorsa.

Proposal.seller.subAccountId Proposal.publisherProfile

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

Proposal.buyer.accountId

Proposal.buyer o Proposal.client.

Il campo utilizzato dipenderà dal tipo di account della negoziazione acquirente. Questi sono i nomi delle risorse di un'API Real-Time Bidding buyers risorsa oppure API Marketplace rispettivamente buyers.clients.

Proposal.billedBuyer.accountId Proposal.billedBuyer

Questo è un nome risorsa che fa riferimento a un account acquirente come rappresentati in buyers dell'API delle offerte in tempo reale risorsa.

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 accesso 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