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:
- 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 :
- Cliquez sur le lien + ACTIVER LES API ET LES SERVICES.
- Dans le champ de recherche, saisissez API Marketplace Authorized Buyers, puis appuyez sur Entrée.
- Dans les résultats de recherche, sélectionnez API Marketplace Authorized Buyers.
- Cliquez sur le bouton ACTIVER pour activer l'API Marketplace.
- 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 |
Champs de la ressource
API Ad Exchange pour acheteur 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 |
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 |
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
|
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
|
ClientUser.userId |
ClientUser.name
|
ClientUser.clientAccountId |
Ce champ n'existe plus pour les utilisateurs du client. Consultez plutôt
|
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
|
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 |
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 |
accounts.finalizedProposals.list |
Utiliser
|
accounts.finalizedProposals.pause |
Utiliser
|
accounts.finalizedProposals.resume |
Utiliser
|
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
|
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 |
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 |
Notez que même si |
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms |
Notez que si |
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms |
Notez que même si
|
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 |
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
|
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 |
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 |
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 |
Proposal.buyer.accountId |
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 |
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 |
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 |
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 |