Diese Seite wurde von der Cloud Translation API übersetzt.

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:

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 `updateMask`.

Ressourcenfelder

Ad Exchange-Käufer-II-API	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 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 `state` auf `INVITED` gesetzt ist, entsprechen den von `accounts.clients.invitations.list` zurückgegebenen Nutzern.
`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 gewünschten Änderungen neu zu erstellen.

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 `clientAccountId` im Namen des übergeordneten Clients an.
`ClientUser.userId`	`ClientUser.name` `userId` ist die Nutzerressourcen-ID.
`ClientUser.clientAccountId`	Dieses Feld ist für Kundennutzer nicht mehr vorhanden. Sehen Sie sich stattdessen `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 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` `publisherProfileId` ist die Ressourcen-ID des Publisher-Profils.
`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 `buyers.proposals.accept` nur auf, wenn der Status des Angebots `BUYER_ACCEPTANCE_REQUESTED` lautet.
`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 `updateMask`.
`accounts.finalizedProposals.list`	Mit `buyers.finalizedDeals.list` kannst du abgeschlossene Deals für ein bestimmtes Käuferkonto aufrufen. Mit `bidders.finalizedDeals.list` können jetzt abgeschlossene Deals auf Bieterebene abgerufen werden.
`accounts.finalizedProposals.pause`	Mit `buyers.finalizedDeals.pause` können Sie einzelne abgeschlossene Deals für ein bestimmtes Käuferkonto pausieren.
`accounts.finalizedProposals.resume`	Verwenden Sie `buyers.finalizedDeals.resume`, um einzelne abgeschlossene Deals für ein bestimmtes Käuferkonto fortzusetzen.

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` `proposalId` ist die ID der Angebotsressource.
`Proposal.updateTime`	`Proposal.updateTime`
`Proposal.proposalRevision`	`Proposal.proposalRevision` und `Deal.proposalRevision`
`Proposal.deals.dealId`	`Deal.name` `dealId` ist die Ressourcen-ID des Deals.
`Proposal.deals.proposalId`	`Deal.name` `proposalId` ist die übergeordnete Ressourcen-ID des Angebots.
`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`	`Deal.programmaticGuaranteedTerms` Obwohl `guaranteedFixedPriceTerms.fixedPrices` ein wiederkehrendes Feld ist, wurde es nie mit mehr als einem Eintrag gefüllt. Daher ist der `programmaticGuaranteedTerms.fixedPrice` der Marketplace API äquivalent.
`Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms`	`Deal.preferredDealTerms` Obwohl `nonGuaranteedFixedPriceTerms.fixedPrices` ein wiederkehrendes Feld ist, wurde es nie mit mehr als einem Eintrag gefüllt. Daher ist der `preferredDealTerms.fixedPrice` der Marketplace API äquivalent.
`Proposal.deals.dealTerms.NonGuaranteedAuctionTerms`	`Deal.privateAuctionTerms` Obwohl `nonGuaranteedAuctionTerms.reservePricesPerBuyer` ein wiederkehrendes Feld ist, wurde es nie mit mehr als einem Eintrag gefüllt. Daher ist der `privateAuctionTerms.floorPrice` der Marketplace API äquivalent.
`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 `Deal.targeting`. Beispielsweise bezieht sich der Schlüssel `GOOG_CREATIVE_SIZE` aus Ad Exchange für Käufer II auf die `Deal.targeting.inventorySizeTargeting` der Marketplace API.
`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 `FinalizedDeal.dealPausingInfo`.
`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 `buyers.finalizedDeals.setReadyToServe` können Sie angeben, dass der abgeschlossene programmatisch garantierte Deal ausgeliefert werden kann.
`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 `buyers.publisherProfiles` aufgerufen werden.
`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 `buyers.publisherProfiles` aufgerufen werden.
`Proposal.buyer.accountId`	`Proposal.buyer` oder `Proposal.client`. Das verwendete Feld hängt vom Kontotyp des verhandelnden Käufers ab. Das sind die Ressourcennamen der `buyers`-Ressource der Real-time Bidding API bzw. der `buyers.clients` der Marketplace API.
`Proposal.billedBuyer.accountId`	`Proposal.billedBuyer` Dies ist jetzt ein Ressourcenname, der auf ein Käuferkonto verweist, das in der Ressource `buyers` der Real-time Bidding API dargestellt wird.
`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 `buyers.finalizedDeals` detaillierter zugreifen.
`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`