Zur Marketplace API migrieren

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:

  1. Rufen Sie die Seite für aktivierte APIs in der Google API Console auf. Wählen Sie das Projekt aus, mit dem Sie auf andere Authorized Buyers APIs wie Ad Exchange Buyer II oder die Real-time Bidding API zugreifen.
  2. Klicken Sie auf den Link + APIS UND DIENSTE AKTIVIEREN.
  3. Geben Sie in das Suchfeld Authorized Buyers Marketplace API ein und drücken Sie die Eingabetaste.
  4. Wählen Sie in den Suchergebnissen Authorized Buyers Marketplace API aus.
  5. Klicken Sie auf die Schaltfläche AKTIVIEREN, um die Marketplace API zu aktivieren.
  6. Sie sollten jetzt mit den unter 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 „Ad Exchange Buyer II“ müssen so geändert werden, dass der API-Bereich „Marketplace“ verwendet wird:

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

Wir empfehlen, den OAuth 2.0-Ablauf für Dienstkonten für den Zugriff auf die API zu verwenden. Für alle unterstützten OAuth 2.0-Abläufe muss der neue API-Bereich angegeben werden, um ein Token von Google anzufordern, das auf die Marketplace API zugreifen kann.

Ad Exchange Buyers II API-Ressourcen der Marketplace API zuordnen

Clients

Wenn Sie die Ressource accounts.clients der Ad Exchange Buyer II API verwenden, können Sie zur Ressource buyers.clients der Marketplace API migrieren.

Ressourcenmethoden

Ad Exchange Buyers 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 auch Teilaktualisierungen mit dem Parameter updateMask.

Ressourcenfelder

API für Ad Exchange-Käufer II Marketplace API
Client.clientAccountId Client.name

clientAccountId ist die Clientressourcen-ID.
Client.role Client.role
Client.status Client.state
Client.clientName Client.displayName
Client.visibleToSeller Client.sellerVisible
Client.entityType

Dieses Feld wird nicht mehr verwendet.
Client.entityId

Dieses Feld wird nicht mehr verwendet.
Client.entityName

Dieses Feld wird nicht mehr unterstützt.
Client.partnerClientId Client.partnerClientId

Einladungen und Nutzer

Die Marketplace API kombiniert die Funktionen der Ressourcen accounts.clients.invitations und accounts.clients.users der Ad Exchange Buyer II API in einer einzigen Ressource buyers.clients.users.

Ressourcenmethoden

Ad Exchange Buyers 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, deren state auf INVITED festgelegt ist, entsprechen denjenigen, die von accounts.clients.invitations.list zurückgegeben werden.

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 buyers.clients.users.delete zu löschen und mit den bevorzugten Änderungen neu zu erstellen.

Ressourcenfelder

API für Ad Exchange-Käufer II Marketplace API
ClientUserInvitation.invitationId

Dieses Feld wird nicht mehr unterstützt.
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

Dieses Feld gibt es für Kundennutzer nicht mehr. Sehen Sie sich stattdessen die clientAccountId im Namen des übergeordneten Clients an.
ClientUser.userId ClientUser.name

userId ist die Nutzerressourcen-ID.
ClientUser.clientAccountId

Dieses Feld gibt es für Kundennutzer nicht mehr. Sehen Sie sich stattdessen die clientAccountId im Namen des übergeordneten Clients an.
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 Ressource accounts.publisherProfiles der Ad Exchange Buyer II API verwenden, können Sie zur Ressource buyers.publisherProfiles der Marketplace API migrieren.

Ressourcenmethoden

Ad Exchange Buyers II API Marketplace API
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

Diese Methode unterstützt jetzt Listenfilter.

Ressourcenfelder

API für Ad Exchange-Käufer II Marketplace-API
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId ist die ID der Publisher-Profilressource.
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 wird nicht mehr unterstützt.
PublisherProfile.googlePlusUrl

Dieses Feld wird nicht mehr verwendet.
PublisherProfile.overview PublisherProfile.overview
PublisherProfile.buyerPitchStatement PublisherProfile.pitchStatement
PublisherProfile.topHeadlines PublisherProfile.topHeadlines
PublisherProfile.audienceDescription PublisherProfile.audienceDescription
PublisherProfile.isParent PublisherProfile.isParent

Vorschläge und abgeschlossene Vorschläge

Wenn Sie die Ressource accounts.proposals der Ad Exchange Buyer II API verwenden, können Sie zur Ressource buyers.proposals der Marketplace API migrieren. Angebote wurden von Vorschlägen in die untergeordnete Ressource buyers.proposals.deals verschoben. Abgeschlossene Vorschläge werden nicht mehr in der API dargestellt. Mit der Ressource buyers.finalizedDeals können Sie abgeschlossene Deals genauer verwalten.

Ressourcenmethoden

Ad Exchange Buyers II API Marketplace API
accounts.proposals.accept buyers.proposals.accept

Rufe buyers.proposals.accept nur auf, wenn der Status des Angebots BUYER_ACCEPTANCE_REQUESTED ist.
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 Vorschläge enthalten keine Informationen zu Angeboten. Wenn Sie die Listenfilterung verwenden, beachten Sie, dass die Marketplace API nur die Syntax für Listenfilter 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 auch Teilaktualisierungen mit dem Parameter updateMask.
accounts.finalizedProposals.list

Verwenden Sie buyers.finalizedDeals.list, um abgeschlossene Deals für ein bestimmtes Käuferkonto aufzurufen. Mit bidders.finalizedDeals.list können jetzt abgeschlossene Deals auf Bieterebene abgerufen werden.
accounts.finalizedProposals.pause

Verwenden Sie buyers.finalizedDeals.pause, um einzelne abgeschlossene Deals für ein bestimmtes Käuferkonto zu pausieren.
accounts.finalizedProposals.resume

Verwenden Sie buyers.finalizedDeals.resume, um einzelne abgeschlossene Deals für ein bestimmtes Käuferkonto fortzusetzen.

Ressourcenfelder

Die proposals- und finalizedProposals-Ressourcen haben dieselbe Proposal-Darstellung und ähnliche Migrationsschritte.

Ad Exchange Buyers II API Marketplace API
Proposal.proposalId Proposal.name

proposalId ist die ID der Vorschlagsressource.
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

Proposal.proposalRevision und Deal.proposalRevision
Proposal.deals.dealId Deal.name

dealId ist die ID der Dealressource.
Proposal.deals.proposalId Deal.name

proposalId ist die ID der übergeordneten Vorschlagsressource.
Proposal.deals.createTime Deal.createTime
Proposal.deals.updateTime Deal.updateTime
Proposal.deals.createProductId

Dieses Feld wird nicht mehr unterstützt.
Proposal.deals.createProductRevision

Dieses Feld wird nicht mehr unterstützt.
Proposal.deals.displayName Deal.displayName
Proposal.deals.buyerPrivateData.referenceId

Dieses Feld wird nicht mehr unterstützt und ist jetzt nur noch auf Angebotsebene sichtbar.
Proposal.deals.dealTerms.description Deal.description
Proposal.deals.dealTerms.brandingType

Dieses Feld wird nicht mehr unterstützt.
Proposal.deals.dealTerms.estimatedGrossSpend Deal.estimatedGrossSpend
Proposal.deals.dealTerms.estimatedImpressionsPerDay

Dieses Feld wird nicht mehr verwendet.
Proposal.deals.dealTerms.sellerTimeZone Deal.sellerTimeZone
Proposal.deals.dealTerms.guaranteedFixedPriceTerms

Deal.programmaticGuaranteedTerms

guaranteedFixedPriceTerms.fixedPrices ist zwar ein wiederkehrendes Feld, wurde aber nie mit mehr als einem einzigen Eintrag ausgefüllt. Daher ist programmaticGuaranteedTerms.fixedPrice der Marketplace API äquivalent.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

nonGuaranteedFixedPriceTerms.fixedPrices ist zwar ein wiederkehrendes Feld, wurde aber nie mit mehr als einem einzigen Eintrag ausgefüllt. Daher ist preferredDealTerms.fixedPrice der Marketplace API äquivalent.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

nonGuaranteedAuctionTerms.reservePricesPerBuyer ist zwar ein wiederkehrendes Feld, wurde aber nie mit mehr als einem einzigen Eintrag ausgefüllt. Daher ist privateAuctionTerms.floorPrice der Marketplace API äquivalent.
Proposal.deals.webPropertyCode

Dieses Feld wird nicht mehr unterstützt.
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 mit einem Schlüssel zu konfigurieren, um die Targeting-Kategorie zu bestimmen. Kategorien, auf die ausgerichtet werden kann, finden Sie jedoch unter Deal.targeting. Beispiel: Der Schlüssel GOOG_CREATIVE_SIZE von Ad Exchange Buyer II bezieht sich auf Deal.targeting.inventorySizeTargeting der Marketplace API.
Proposal.deals.targeting Deal.targeting

Es wurden zusätzliche 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 wird nicht mehr unterstützt.
Proposal.deals.syndicationProduct

Dieses Feld wird nicht mehr unterstützt.
Proposal.deals.creativePreApprovalPolicy Deal.creativeRequirements.creativePreApprovalPolicy
Proposal.deals.creativeSafeFrameCompatibility Deal.creativeRequirements.creativeSafeFrameCompatibility
Proposal.deals.dealServingMetadata

Ähnliche Informationen finden Sie im Feld FinalizedDeal.dealPausingInfo.
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

Es wurden zusätzliche Informationen dazu hinzugefügt, wie Angebote präsentiert werden.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

Sie können jetzt nur signalisieren, dass ein Deal bereit zur Auslieferung ist, wenn er abgeschlossen ist. Verwenden Sie die Methode buyers.finalizedDeals.setReadyToServe, um anzugeben, dass Ihr endgültiger programmatisch garantierter Deal für die Auslieferung bereit ist.
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

Verwenden Sie den Namen des Publisher-Profils, um den Verkäufer zu identifizieren. Mit der Ressource buyers.publisherProfiles können Sie sich Publisher-Profile ansehen.
Proposal.seller.subAccountId Proposal.publisherProfile

Verwenden Sie den Namen des Publisher-Profils, um den Verkäufer zu identifizieren. Mit der Ressource buyers.publisherProfiles können Sie sich Publisher-Profile ansehen.
Proposal.buyer.accountId

Proposal.buyer oder Proposal.client.

Welches Feld verwendet wird, hängt vom Kontotyp des verhandelnden Käufers ab. Dies sind die Ressourcennamen einer Realtime Bidding APIbuyers-Ressource bzw. einer Marketplace APIbuyers.clients-Ressource.
Proposal.billedBuyer.accountId Proposal.billedBuyer

Dies ist jetzt ein Ressourcenname, der sich auf ein Käuferkonto bezieht, wie es in der buyers-Ressource der Realtime Bidding API dargestellt ist.
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 wird nicht mehr unterstützt.
Proposal.isSetupComplete FinalizedDeal.readyToServe

Mit buyers.finalizedDeals können Sie jetzt noch detaillierter darauf zugreifen.

Proposal.lastUpdaterOrCommentorRole Proposal.lastUpdaterOrCommentorRole
Proposal.notes.proposalRevision

Dieses Feld wird nicht mehr unterstützt.
Proposal.notes.noteId

Dieses Feld wird nicht mehr unterstützt.
Proposal.notes.createTime Proposal.notes.createTime
Proposal.notes.creatorRole Proposal.notes.creatorRole
Proposal.notes.note Proposal.notes.note
Proposal.termsAndConditions Proposal.termsAndConditions