Abilita l'API
Analogamente ad altre API di Authorized Buyers, devi abilitare l'API Marketplace prima di poterla utilizzare. Per abilitare l'API Marketplace:
- 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.
- Fai clic sul link + ABILITA API E SERVIZI.
- Nella casella di ricerca, digita "API Authorized Buyers Marketplace" e premi Invio.
- Nei risultati di ricerca, seleziona API Authorized Buyers Marketplace.
- Fai clic sul pulsante ENABLE per abilitare l'API Marketplace.
- 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 |
Campi delle risorse
API Ad Exchange per acquirente II | API Marketplace |
---|---|
Client.clientAccountId |
Client.name
|
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 |
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
|
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 |
ClientUser.userId |
ClientUser.name
|
ClientUser.clientAccountId |
Questo campo non esiste più per gli utenti del cliente. Visualizza invece |
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
|
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 |
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 |
accounts.finalizedProposals.list |
Utilizza
|
accounts.finalizedProposals.pause |
Utilizza
|
accounts.finalizedProposals.resume |
Utilizza
|
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
|
Proposal.updateTime |
Proposal.updateTime |
Proposal.proposalRevision |
|
Proposal.deals.dealId |
Deal.name
|
Proposal.deals.proposalId |
Deal.name
|
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 |
Tieni presente che sebbene |
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms |
Tieni presente che sebbene |
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms |
Tieni presente che sebbene |
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 |
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 |
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 |
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 |
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 |
Proposal.buyer.accountId |
Il campo utilizzato dipenderà dal tipo di account dell'acquirente
in fase di negoziazione. Questi sono i nomi delle risorse rispettivamente di una risorsa |
Proposal.billedBuyer.accountId |
Proposal.billedBuyer
Ora è il nome di una risorsa che fa riferimento a un account acquirente rappresentato nella 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
Accesso più granulare con |
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 |