Esegui la migrazione all'API Marketplace

Abilita l'API

Analogamente ad altre API di Authorized Buyers, devi abilitare l'API Marketplace prima di poterla utilizzare. Per abilitare l'API Marketplace:

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

Aggiornare le credenziali OAuth 2.0

Per utilizzare l'ambito dell'API Marketplace, è necessario modificare i flussi di lavoro OAuth 2.0 esistenti con l'ambito dell'API Authorized Buyers II di Ad Exchange:

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

Consigliamo di utilizzare il flusso OAuth 2.0 dell'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 in grado di accedere all'API Marketplace.

Mappatura delle risorse dell'API Ad Exchange per l'acquirente II all'API Marketplace

Clienti

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

Metodi delle risorse

API Ad Exchange per acquirente 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 i filtri elenco.

accounts.clients.update buyers.clients.patch

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

Campi delle risorse

API Ad Exchange per acquirente 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à delle risorse accounts.clients.invitations e accounts.clients.users dell'API Ad Exchange Buyers II in un'unica risorsa buyers.clients.users.

Metodi delle risorse

API Ad Exchange per acquirente 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 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 Ad Exchange per acquirente II API Marketplace
ClientUserInvitation.invitationId

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

Questo campo non esiste più per gli utenti del cliente. Visualizza invece 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 del cliente. Visualizza invece clientAccountId nel nome del client principale.
ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

Prodotti

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

PublisherProfiles

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

Metodi delle risorse

API Ad Exchange per acquirente II API Marketplace
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

Questo metodo ora supporta i filtri elenco.

Campi delle risorse

API Ad Exchange per acquirente II 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

Proposte e proposte definitive

Se utilizzi la risorsa accounts.proposals dell'API Ad Exchange Buyers II, puoi eseguire la migrazione alla risorsa buyers.proposals dell'API Marketplace. I deal sono stati separati dalle proposte nella risorsa secondaria buyers.proposals.deals. Le proposte finalizzate non sono più rappresentate nell'API, offrendoti un controllo più granulare dei deal finalizzati con la risorsa buyers.finalizedDeals.

Metodi delle risorse

API Ad Exchange per acquirente 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 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 finalizzati 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 di Proposal e prevedono passaggi di migrazione simili.

API Ad Exchange per acquirente 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 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 sebbene guaranteedFixedPriceTerms.fixedPrices sia un campo ripetuto, non è mai stato compilato con più di una singola voce. Di conseguenza, programmaticGuaranteedTerms.fixedPrice dell'API Marketplace è equivalente.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

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

Deal.privateAuctionTerms

Tieni presente che sebbene nonGuaranteedAuctionTerms.reservePricesPerBuyer sia un campo ripetuto, non è mai stato compilato con più di una singola voce. Di conseguenza, 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 è possibile scegliere come target sono disponibili in Deal.targeting. Ad esempio, la chiave GOOG_CREATIVE_SIZE di Ad Exchange Buyers II si riferisce all'elemento Deal.targeting.inventorySizeTargeting dell'API Marketplace.
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 nel campo FinalizedDeal.dealPausingInfo.
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

Sono stati aggiunti ulteriori dettagli su come verranno posizionati 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. Questi sono i nomi delle risorse rispettivamente di una risorsa buyers dell'API Real-Time Bidding o di una risorsa buyers.clients dell'API Marketplace.
Proposal.billedBuyer.accountId Proposal.billedBuyer

Ora è il nome di una risorsa che fa riferimento a un account acquirente 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

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