API aktivieren
Ähnlich wie bei anderen Authorized Buyers APIs müssen Sie die Marketplace API aktivieren, bevor Sie sie verwenden können. So aktivieren Sie die Marketplace API:
- Rufen Sie die Seite mit den für die Google API Console aktivierten APIs auf. Wählen Sie das Projekt aus, mit dem Sie auf andere Authorized Buyers APIs zugreifen, z. B. Ad Exchange Buyer II oder die Real-time Bidding API.
- Klicken Sie auf den Link + APIS UND DIENSTE AKTIVIEREN.
- Geben Sie Authorized Buyers Marketplace API in das Suchfeld ein und drücken Sie die Eingabetaste.
- Wählen Sie in den Suchergebnissen Authorized Buyers Marketplace API aus.
- Klicken Sie auf die Schaltfläche AKTIVIEREN, um die Marketplace API zu aktivieren.
- Sie sollten jetzt mit den in diesem Projekt erstellten Anmeldedaten auf die Marketplace API zugreifen können.
OAuth 2.0-Anmeldedaten aktualisieren
Vorhandene OAuth 2.0-Workflows mit dem API-Bereich für Ad Exchange-Käufer II müssen geändert werden, um den Bereich der Marketplace API zu verwenden:
https://www.googleapis.com/auth/authorized-buyers-marketplace
Wir empfehlen, für den Zugriff auf die API den OAuth 2.0-Vorgang für das Dienstkonto zu verwenden. In allen unterstützten OAuth 2.0-Abläufen muss der neue API-Bereich angegeben werden, um ein Token von Google anzufordern, das auf die Marketplace API zugreifen kann.
Zuordnen von Ressourcen der Ad Exchange-Käufer-II-API zur Marketplace-API
Im Namen der Kunden meines Arbeitgebers
Wenn Sie die accounts.clients
-Ressource der Ad Exchange-Käufer II-API verwenden, können Sie zur Ressource buyers.clients
der Marketplace API migrieren.
Ressourcenmethoden
Ad Exchange-Käufer-II-API | Marketplace-API |
---|---|
accounts.clients.create |
buyers.clients.create |
accounts.clients.get |
buyers.clients.get |
accounts.clients.list |
buyers.clients.list
Diese Methode unterstützt jetzt Listenfilter. |
accounts.clients.update |
buyers.clients.patch
Diese Methode unterstützt jetzt Teilaktualisierungen mit dem Parameter |
Ressourcenfelder
Ad Exchange-Käufer-II-API | Marketplace-API |
---|---|
Client.clientAccountId |
Client.name
|
Client.role |
Client.role |
Client.status |
Client.state |
Client.clientName |
Client.displayName |
Client.visibleToSeller |
Client.sellerVisible |
Client.entityType |
Dieses Feld wurde eingestellt. |
Client.entityId |
Dieses Feld wurde eingestellt. |
Client.entityName |
Dieses Feld wurde eingestellt. |
Client.partnerClientId |
Client.partnerClientId |
Einladungen und Nutzer
In der Marketplace API werden die Funktionen der Ressourcen accounts.clients.invitations
und accounts.clients.users
der Ad Exchange-Käufer II-API in einer einzigen Ressource buyers.clients.users
zusammengefasst.
Ressourcenmethoden
Ad Exchange-Käufer-II-API | Marketplace-API |
---|---|
accounts.clients.invitations.create |
buyers.clients.users.create |
accounts.clients.invitations.get |
buyers.clients.users.get |
accounts.clients.invitations.list |
buyers.clients.users.list
Nur Nutzer, bei denen |
accounts.clients.users.get |
buyers.clients.users.get |
accounts.clients.users.list |
buyers.clients.users.list
|
accounts.clients.users.update |
Sie können Clientnutzer nicht mehr mit der API patchen. Wir empfehlen, den Clientnutzer mit
|
Ressourcenfelder
Ad Exchange-Käufer-II-API | Marketplace-API |
---|---|
ClientUserInvitation.invitationId |
Dieses Feld wurde eingestellt. |
ClientUserInvitation.email |
ClientUser.email |
ClientUserInvitation.clientAccountId |
Dieses Feld ist für Kundennutzer nicht mehr vorhanden. Sehen Sie sich stattdessen |
ClientUser.userId |
ClientUser.name
|
ClientUser.clientAccountId |
Dieses Feld ist für Kundennutzer nicht mehr vorhanden. Sehen Sie sich stattdessen |
ClientUser.status |
ClientUser.state |
ClientUser.email |
ClientUser.email |
Produkte
Diese Ressource und ihre Funktionen sind in der Marketplace API nicht verfügbar.
PublisherProfiles
Wenn Sie die accounts.publisherProfiles
-Ressource der Ad Exchange-Käufer II-API verwenden, können Sie zur Ressource buyers.publisherProfiles
der Marketplace API migrieren.
Ressourcenmethoden
Ad Exchange-Käufer-II-API | Marketplace-API |
---|---|
accounts.publisherProfiles.get |
buyers.publisherProfiles.get |
accounts.publisherProfiles.list |
buyers.publisherProfiles.list
Diese Methode unterstützt jetzt Listenfilter. |
Ressourcenfelder
Ad Exchange-Käufer-II-API | Marketplace-API |
---|---|
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 |
Dieses Feld wurde eingestellt. |
PublisherProfile.googlePlusUrl |
Dieses Feld wurde eingestellt. |
PublisherProfile.overview |
PublisherProfile.overview |
PublisherProfile.buyerPitchStatement |
PublisherProfile.pitchStatement |
PublisherProfile.topHeadlines |
PublisherProfile.topHeadlines |
PublisherProfile.audienceDescription |
PublisherProfile.audienceDescription |
PublisherProfile.isParent |
PublisherProfile.isParent |
Angebote und abgeschlossene Angebote
Wenn Sie die accounts.proposals
-Ressource der Ad Exchange-Käufer II-API verwenden, können Sie zur Ressource buyers.proposals
der Marketplace API migrieren. Deals wurden von Angeboten in der Unterressource buyers.proposals.deals
getrennt. Abgeschlossene Angebote werden nicht mehr in der API dargestellt, sodass Sie eine detailliertere Kontrolle über abgeschlossene Deals mit der Ressource buyers.finalizedDeals
haben.
Ressourcenmethoden
Ad Exchange-Käufer-II-API | Marketplace-API |
---|---|
accounts.proposals.accept |
buyers.proposals.accept
Rufen Sie |
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
Das Angebot enthält dann keine Informationen zu Deals mehr. |
accounts.proposals.list |
buyers.proposals.list
Die zurückgegebenen Angebote enthalten dann keine Informationen zu Deals mehr. Beachten Sie bei der Verwendung der Listenfilterung, dass die Marketplace API nur die Syntax von Listenfiltern unterstützt. |
accounts.proposals.pause |
buyers.finalizedDeals.pause |
accounts.proposals.resume |
buyers.finalizedDeals.resume |
accounts.proposals.update |
buyers.proposals.patch
Diese Methode unterstützt jetzt Teilaktualisierungen mit dem Parameter |
accounts.finalizedProposals.list |
Mit
|
accounts.finalizedProposals.pause |
Mit
|
accounts.finalizedProposals.resume |
Verwenden Sie
|
Ressourcenfelder
Die Ressourcen proposals
und finalizedProposals
verwenden dieselbe Proposal
-Darstellung und haben ähnliche Migrationsschritte.
Ad Exchange-Käufer-II-API | Marketplace-API |
---|---|
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 |
Dieses Feld wurde eingestellt. |
Proposal.deals.createProductRevision |
Dieses Feld wurde eingestellt. |
Proposal.deals.displayName |
Deal.displayName |
Proposal.deals.buyerPrivateData.referenceId |
Dieses Feld wurde eingestellt und ist jetzt nur noch auf Angebotsebene verfügbar. |
Proposal.deals.dealTerms.description |
Deal.description |
Proposal.deals.dealTerms.brandingType |
Dieses Feld wurde eingestellt. |
Proposal.deals.dealTerms.estimatedGrossSpend |
Deal.estimatedGrossSpend |
Proposal.deals.dealTerms.estimatedImpressionsPerDay |
Dieses Feld wurde eingestellt. |
Proposal.deals.dealTerms.sellerTimeZone |
Deal.sellerTimeZone |
Proposal.deals.dealTerms.guaranteedFixedPriceTerms |
Obwohl |
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms |
Obwohl |
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms |
Obwohl |
Proposal.deals.webPropertyCode |
Dieses Feld wurde eingestellt. |
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
Es ist nicht mehr möglich, das Targeting mithilfe eines Schlüssels zu konfigurieren, um die Targeting-Kategorie zu bestimmen. Kategorien, die für das Targeting verwendet werden können, finden Sie jedoch in |
Proposal.deals.targeting |
Deal.targeting
Es wurden weitere Kategorien für Targeting-Kriterien hinzugefügt. |
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 |
Dieses Feld wurde eingestellt. |
Proposal.deals.syndicationProduct |
Dieses Feld wurde eingestellt. |
Proposal.deals.creativePreApprovalPolicy |
Deal.creativeRequirements.creativePreApprovalPolicy |
Proposal.deals.creativeSafeFrameCompatibility |
Deal.creativeRequirements.creativeSafeFrameCompatibility
|
Proposal.deals.dealServingMetadata |
Ähnliche Informationen finden Sie im Feld |
Proposal.deals.programmaticCreativeSource |
Deal.creativeRequirements.programmaticCreativeSource |
Proposal.deals.deliveryControl |
Deal.deliveryControl
Zusätzliche Details zum Platzieren von Angeboten wurden hinzugefügt. |
Proposal.deals.isSetupComplete |
FinalizedDeal.readyToServe
Sie können jetzt nur angeben, dass ein Deal zur Auslieferung bereit ist, wenn er abgeschlossen ist. Mit der Methode |
Proposal.originatorRole |
Proposal.originatorRole |
Proposal.seller.accountId |
Proposal.publisherProfile
Verwenden Sie den Namen des Publisher-Profils, um den Verkäufer zu identifizieren. Publisher-Profile können mit der Ressource |
Proposal.seller.subAccountId |
Proposal.publisherProfile
Verwenden Sie den Namen des Publisher-Profils, um den Verkäufer zu identifizieren. Publisher-Profile können mit der Ressource |
Proposal.buyer.accountId |
Das verwendete Feld hängt vom Kontotyp des verhandelnden Käufers ab. Das sind die Ressourcennamen der |
Proposal.billedBuyer.accountId |
Proposal.billedBuyer
Dies ist jetzt ein Ressourcenname, der auf ein Käuferkonto verweist, das in der 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 |
Dieses Feld wurde eingestellt. |
Proposal.isSetupComplete |
FinalizedDeal.readyToServe
Jetzt mit |
Proposal.lastUpdaterOrCommentorRole |
Proposal.lastUpdaterOrCommentorRole |
Proposal.notes.proposalRevision |
Dieses Feld wurde eingestellt. |
Proposal.notes.noteId |
Dieses Feld wurde eingestellt. |
Proposal.notes.createTime |
Proposal.notes.createTime |
Proposal.notes.creatorRole |
Proposal.notes.creatorRole |
Proposal.notes.note |
Proposal.notes.note |
Proposal.termsAndConditions |
Proposal.termsAndConditions |