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:
- 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.
- Fai clic sul link + ABILITA API E SERVIZI.
- Nella casella di ricerca, digita "API Marketplace di Authorized Buyers" e premi Invio.
- Nei risultati di ricerca, seleziona API Marketplace di Authorized Buyers.
- Fai clic sul pulsante ABILITA per abilitare l'API Marketplace.
- 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 |
Campi delle risorse
API Ad Exchange Buyers 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à 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 |
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
|
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
|
ClientUser.userId |
ClientUser.name
|
ClientUser.clientAccountId |
Questo campo non esiste più per gli utenti cliente. Puoi visualizzare 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 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
|
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 |
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 |
accounts.finalizedProposals.list |
Utilizza
|
accounts.finalizedProposals.pause |
Utilizza
|
accounts.finalizedProposals.resume |
Utilizza
|
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
|
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 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 |
Tieni presente che, mentre |
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms |
Tieni presente che, mentre |
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms |
Tieni presente che mentre
|
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 |
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 |
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 |
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 |
Proposal.seller.subAccountId |
Proposal.publisherProfile
Utilizza il nome del profilo del publisher per identificare il venditore. Puoi visualizzare
i profili dei publisher con |
Proposal.buyer.accountId |
Il campo utilizzato dipenderà dal tipo di account della negoziazione
acquirente. Questi sono i nomi delle risorse di un'API Real-Time Bidding
|
Proposal.billedBuyer.accountId |
Proposal.billedBuyer
Questo è un nome risorsa che fa riferimento a un account acquirente come
rappresentati in |
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 |
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 |