Migrer vers l'API Marketplace

Activer l'API

Semblable à celui des autres acheteurs Authorized Buyers API, vous devez activer API Marketplace avant vous pouvez l'utiliser. Vous pouvez activer l'API Marketplace en procédant comme suit:

  1. Accédez aux API pour lesquelles la console Google APIs est activée. . Sélectionnez l'icône que vous utilisez pour accéder à d'autres API Authorized Buyers, Ad Exchange Buyer II ou API Real-time Bidding :
  2. Cliquez sur le lien + ACTIVER LES API ET LES SERVICES.
  3. Dans le champ de recherche, saisissez API Marketplace Authorized Buyers, puis appuyez sur Entrée.
  4. Dans les résultats de recherche, sélectionnez API Marketplace Authorized Buyers.
  5. Cliquez sur le bouton ACTIVER pour activer l'API Marketplace.
  6. Vous devriez maintenant pouvoir accéder à l'API Marketplace à l'aide d'identifiants créés dans ce projet.

Mettre à jour vos identifiants OAuth 2.0

Les flux de travail OAuth 2.0 existants avec le champ d'application de l'API Ad Exchange pour acheteur II doivent être modifié pour utiliser le champ d'application de l'API Marketplace:

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

Nous vous recommandons d'utiliser le protocole OAuth 2.0 du compte de service. pour accéder à l'API. Tous les flux OAuth 2.0 compatibles doivent spécifier la nouvelle API pour demander à Google un jeton pouvant accéder à l'API Marketplace.

Mise en correspondance des ressources de l'API Ad Exchange pour acheteur II et de l'API Marketplace

Clients

Si vous utilisez l'API Ad Exchange pour acheteur II accounts.clients ressource, vous pouvez migrer vers des API Marketplace buyers.clients ressource.

Méthodes des ressources

API Ad Exchange pour acheteur II API Marketplace
accounts.clients.create buyers.clients.create
accounts.clients.get buyers.clients.get
accounts.clients.list buyers.clients.list

Cette méthode prend désormais en charge Filtres de liste.

accounts.clients.update buyers.clients.patch

Cette méthode accepte désormais les mises à jour partielles avec Paramètre updateMask.

Champs de la ressource

API Ad Exchange pour acheteur II API Marketplace
Client.clientAccountId Client.name

clientAccountId est l'ID de ressource client.
Client.role Client.role
Client.status Client.state
Client.clientName Client.displayName
Client.visibleToSeller Client.sellerVisible
Client.entityType

Ce champ a été arrêté.
Client.entityId

Ce champ a été arrêté.
Client.entityName

Ce champ a été arrêté.
Client.partnerClientId Client.partnerClientId

Invitations et Utilisateurs

L'API Marketplace combine les fonctionnalités de l'API Ad Exchange pour acheteur II. accounts.clients.invitations et accounts.clients.users de ressources en un seul buyers.clients.users ressource.

Méthodes des ressources

API Ad Exchange pour acheteur 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

Uniquement les utilisateurs dont le paramètre state est défini sur INVITED seront équivalentes à celles renvoyées par accounts.clients.invitations.list

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

Vous ne pouvez plus corriger les utilisateurs du client avec l'API. Nous vous recommandons que vous utilisez buyers.clients.users.delete pour supprimer l'utilisateur du client et le recrée avec les modifications souhaitées.

Champs de la ressource

API Ad Exchange pour acheteur II API Marketplace
ClientUserInvitation.invitationId

Ce champ a été arrêté.
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

Ce champ n'existe plus pour les utilisateurs du client. Consultez plutôt clientAccountId dans le nom du client parent.
ClientUser.userId ClientUser.name

userId est l'ID de ressource utilisateur.
ClientUser.clientAccountId

Ce champ n'existe plus pour les utilisateurs du client. Consultez plutôt clientAccountId dans le nom du client parent.
ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

Produits

Cette ressource et ses fonctionnalités ne sont pas disponibles dans l'API Marketplace.

PublisherProfiles

Si vous utilisez l'API Ad Exchange pour acheteur II accounts.publisherProfiles ressource, vous pouvez migrer vers des API Marketplace buyers.publisherProfiles ressource.

Méthodes des ressources

API Ad Exchange pour acheteur II API Marketplace
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

Cette méthode prend désormais en charge Filtres de liste.

Champs de la ressource

API Ad Exchange pour acheteur II API Marketplace
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId est la ressource de profil d'éditeur. 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

Ce champ a été arrêté.
PublisherProfile.googlePlusUrl

Ce champ a été arrêté.
PublisherProfile.overview PublisherProfile.overview
PublisherProfile.buyerPitchStatement PublisherProfile.pitchStatement
PublisherProfile.topHeadlines PublisherProfile.topHeadlines
PublisherProfile.audienceDescription PublisherProfile.audienceDescription
PublisherProfile.isParent PublisherProfile.isParent

Propositions et FinalizedProposals

Si vous utilisez l'API Ad Exchange pour acheteur II accounts.proposals ressource, vous pouvez migrer vers des API Marketplace buyers.proposals ressource. Les accords ont été séparés des propositions dans buyers.proposals.deals sous-ressource. Les propositions finalisées ne sont plus représentées dans l'API. un contrôle plus précis des accords finalisés buyers.finalizedDeals ressource.

Méthodes des ressources

API Ad Exchange pour acheteur II API Marketplace
accounts.proposals.accept buyers.proposals.accept

N'appelez buyers.proposals.accept que lorsque l'état de la proposition est 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

Notez que la proposition ne contiendra plus d'informations sur les accords.

accounts.proposals.list buyers.proposals.list

Notez que les propositions renvoyées ne contiendront plus d'informations. sur les accords. Si vous utilisez le filtrage de liste, notez que l'API Marketplace uniquement compatible avec la syntaxe des filtres de liste.
accounts.proposals.pause buyers.finalizedDeals.pause
accounts.proposals.resume buyers.finalizedDeals.resume
accounts.proposals.update buyers.proposals.patch

Cette méthode accepte désormais les mises à jour partielles avec Paramètre updateMask.
accounts.finalizedProposals.list

Utiliser buyers.finalizedDeals.list pour afficher les accords finalisés pour un compte acheteur donné. Il est désormais possible de récupérer les accords finalisés au niveau de l'enchérisseur avec bidders.finalizedDeals.list.
accounts.finalizedProposals.pause

Utiliser buyers.finalizedDeals.pause pour mettre en veille les accords finalisés pour un compte acheteur donné.
accounts.finalizedProposals.resume

Utiliser buyers.finalizedDeals.resume pour réactiver les accords finalisés pour un compte acheteur donné.

Champs de la ressource

Les ressources proposals et finalizedProposals partagent le même Proposal et ont des étapes de migration similaires.

API Ad Exchange pour acheteur II API Marketplace
Proposal.proposalId Proposal.name

proposalId est l'ID de ressource de la proposition.
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

Proposal.proposalRevision et Deal.proposalRevision
Proposal.deals.dealId Deal.name

dealId est l'ID de ressource de l'accord.
Proposal.deals.proposalId Deal.name

proposalId est l'ID de ressource de la proposition parente.
Proposal.deals.createTime Deal.createTime
Proposal.deals.updateTime Deal.updateTime
Proposal.deals.createProductId

Ce champ a été arrêté.
Proposal.deals.createProductRevision

Ce champ a été arrêté.
Proposal.deals.displayName Deal.displayName
Proposal.deals.buyerPrivateData.referenceId

Ce champ a été arrêté. il n'est alors exposé qu'au niveau de la d'application.
Proposal.deals.dealTerms.description Deal.description
Proposal.deals.dealTerms.brandingType

Ce champ a été arrêté.
Proposal.deals.dealTerms.estimatedGrossSpend Deal.estimatedGrossSpend
Proposal.deals.dealTerms.estimatedImpressionsPerDay

Ce champ a été arrêté.
Proposal.deals.dealTerms.sellerTimeZone Deal.sellerTimeZone
Proposal.deals.dealTerms.guaranteedFixedPriceTerms

Deal.programmaticGuaranteedTerms

Notez que même si guaranteedFixedPriceTerms.fixedPrices est un champ répété, il n'a jamais été rempli avec plus d'une entrée. En tant que C'est pourquoi l'API Marketplace programmaticGuaranteedTerms.fixedPrice est équivalent.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

Notez que si nonGuaranteedFixedPriceTerms.fixedPrices est un champ répété, il n'a jamais été rempli avec plus d'une entrée. Par conséquent, les fonctionnalités preferredDealTerms.fixedPrice est équivalent.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

Notez que même si nonGuaranteedAuctionTerms.reservePricesPerBuyer est un champ répété, il n'a jamais été rempli avec plus d'une entrée. En tant que C'est pourquoi l'API Marketplace privateAuctionTerms.floorPrice est équivalent.
Proposal.deals.webPropertyCode

Ce champ a été arrêté.
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

Il n'est plus possible de configurer le ciblage à l'aide d'une clé pour déterminer la catégorie de ciblage ; Toutefois, les catégories qui pourraient être ciblé se trouve dans Deal.targeting. Par exemple, La clé GOOG_CREATIVE_SIZE de l'acheteur Ad Exchange II fait référence à API Marketplace Deal.targeting.inventorySizeTargeting
Proposal.deals.targeting Deal.targeting

Des catégories de critères de ciblage supplémentaires ont été ajoutées.
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

Ce champ a été arrêté.
Proposal.deals.syndicationProduct

Ce champ a été arrêté.
Proposal.deals.creativePreApprovalPolicy Deal.creativeRequirements.creativePreApprovalPolicy
Proposal.deals.creativeSafeFrameCompatibility Deal.creativeRequirements.creativeSafeFrameCompatibility
Proposal.deals.dealServingMetadata

Vous trouverez des informations similaires dans le FinalizedDeal.dealPausingInfo.
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

Des informations supplémentaires sur la manière dont les offres vont être effectuées ont été ajoutées.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

Vous ne pouvez désormais signaler qu'un accord est prêt à être diffusé finalisée. Utiliser le buyers.finalizedDeals.setReadyToServe pour indiquer que votre accord de programmatique garanti finalisé prêts à être diffusés.
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

Utilisez le nom de profil de l'éditeur pour identifier le vendeur. Vous pouvez afficher les profils d'éditeurs avec le buyers.publisherProfiles ressource.
Proposal.seller.subAccountId Proposal.publisherProfile

Utilisez le nom de profil de l'éditeur pour identifier le vendeur. Vous pouvez afficher les profils d'éditeurs avec le buyers.publisherProfiles ressource.
Proposal.buyer.accountId

Proposal.buyer ou Proposal.client.

Le champ utilisé dépend du type de compte de l'acheteur acheteur. Il s'agit des noms de ressources d'une API Real-time Bidding Ressource buyers ou API Marketplace buyers.clients, respectivement.
Proposal.billedBuyer.accountId Proposal.billedBuyer

Il s'agit désormais d'un nom de ressource faisant référence à un compte acheteur en tant que représentées dans le buyers de l'API Real-time Bidding. ressource.
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

Ce champ a été arrêté.
Proposal.isSetupComplete FinalizedDeal.readyToServe

Désormais accessible de manière plus précise avec buyers.finalizedDeals.

Proposal.lastUpdaterOrCommentorRole Proposal.lastUpdaterOrCommentorRole
Proposal.notes.proposalRevision

Ce champ a été arrêté.
Proposal.notes.noteId

Ce champ a été arrêté.
Proposal.notes.createTime Proposal.notes.createTime
Proposal.notes.creatorRole Proposal.notes.creatorRole
Proposal.notes.note Proposal.notes.note
Proposal.termsAndConditions Proposal.termsAndConditions