Diese Seite wurde von der Cloud Translation API übersetzt.

Zur Marketplace API migrieren

API aktivieren

Ähnlich wie bei anderen Authorized Buyers-Nutzern APIs aktiviert haben, müssen Sie den Marketplace API vor dem können Sie sie verwenden. So aktivieren Sie die Marketplace API:

Zu den in der Google API Console aktivierten APIs . Wählen Sie das das Sie verwenden, um auf andere Authorized Buyers-APIs zuzugreifen, z. B. Ad Exchange-Käufer II oder Real-time Bidding API:
Klicken Sie auf den Link + APIS UND DIENSTE AKTIVIEREN.
Geben Sie Authorized Buyers Marketplace API in das Suchfeld ein und klicken Sie auf 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 Anmeldedaten auf die Marketplace API zugreifen können die in diesem Projekt erstellt wurden.

OAuth 2.0-Anmeldedaten aktualisieren

Vorhandene OAuth 2.0-Workflows mit dem API-Bereich für Ad Exchange Buyer II müssen zur Verwendung des Bereichs Marketplace API geändert:

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

Wir empfehlen die Verwendung des Dienstkonto-OAuth 2.0. um auf die API zuzugreifen. In allen unterstützten OAuth 2.0-Abläufen muss die neue API angegeben werden -Bereich, um ein Token von Google anzufordern, das auf die Marketplace API zugreifen kann.

Ressourcen der Ad Exchange Buyer II API der Marketplace API zuordnen

Clients

Wenn Sie Ad Exchange Buyer II APIs verwenden accounts.clients können Sie zu Marketplace APIs migrieren, buyers.clients .

Ressourcenmethoden

API für Ad Exchange-Käufer II	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 der `updateMask`-Parameter.

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 verwendet.
`Client.partnerClientId`	`Client.partnerClientId`

Einladungen und Nutzer*innen

Das Marketplace-API kombiniert die Funktionen der APIs von Ad Exchange Buyer II accounts.clients.invitations und accounts.clients.users in einer einzigen buyers.clients.users .

Ressourcenmethoden

API für Ad Exchange-Käufer II	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 den zurückgegebenen Werten von `accounts.clients.invitations.list`
`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, mit `buyers.clients.users.delete`, um den und erstellen Sie ihn mit den bevorzugten Änderungen neu.

Ressourcenfelder

API für Ad Exchange-Käufer II	Marketplace-API
`ClientUserInvitation.invitationId`	Dieses Feld wird nicht mehr verwendet.
`ClientUserInvitation.email`	`ClientUser.email`
`ClientUserInvitation.clientAccountId`	Dieses Feld ist für Kundennutzer nicht mehr vorhanden. Sehen Sie sich stattdessen die `clientAccountId` im Namen des übergeordneten Clients.
`ClientUser.userId`	`ClientUser.name` `userId` ist die Nutzerressourcen-ID.
`ClientUser.clientAccountId`	Dieses Feld ist für Kundennutzer nicht mehr vorhanden. Sehen Sie sich stattdessen die `clientAccountId` im Namen des übergeordneten Clients.
`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 Ad Exchange Buyer II APIs verwenden accounts.publisherProfiles können Sie zu Marketplace APIs migrieren buyers.publisherProfiles .

Ressourcenmethoden

API für Ad Exchange-Käufer II	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 Ressource für das Publisher-Profil 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`	Dieses Feld wird nicht mehr verwendet.
`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 FinalizedProposals

Wenn Sie Ad Exchange Buyer II APIs verwenden accounts.proposals können Sie zu Marketplace APIs migrieren buyers.proposals . Deals wurden von Angeboten getrennt in buyers.proposals.deals Unterressource. Abgeschlossene Angebote werden nicht mehr in der API angezeigt, haben Sie eine genauere Kontrolle über abgeschlossene Deals. buyers.finalizedDeals .

Ressourcenmethoden

API für Ad Exchange-Käufer II	Marketplace-API
`accounts.proposals.accept`	`buyers.proposals.accept` Rufen Sie `buyers.proposals.accept` nur dann 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 Angebote enthalten dann keine Informationen mehr. über Angebote informieren. Wenn Sie Listenfilter verwenden, beachten Sie, dass die Marketplace API unterstützt Listenfiltersyntax auf.
`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 der `updateMask`-Parameter.
`accounts.finalizedProposals.list`	verwenden `buyers.finalizedDeals.list`, um abgeschlossene Deals aufzurufen für ein bestimmtes Käuferkonto. Endgültige Deals können jetzt abgerufen werden auf Bieterebene mit `bidders.finalizedDeals.list`
`accounts.finalizedProposals.pause`	verwenden `buyers.finalizedDeals.pause`, um einen einzelnen Nutzer zu pausieren für ein bestimmtes Käuferkonto abgeschlossen.
`accounts.finalizedProposals.resume`	verwenden `buyers.finalizedDeals.resume`, um einzelne Personen wieder zu aktivieren für ein bestimmtes Käuferkonto abgeschlossen.

Ressourcenfelder

Die Ressourcen proposals und finalizedProposals verwenden denselben Proposal und ähnliche Migrationsschritte haben.

API für Ad Exchange-Käufer II	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 ID der Dealressource.
`Proposal.deals.proposalId`	`Deal.name` `proposalId` ist die ID der übergeordneten Angebotsressource.
`Proposal.deals.createTime`	`Deal.createTime`
`Proposal.deals.updateTime`	`Deal.updateTime`
`Proposal.deals.createProductId`	Dieses Feld wird nicht mehr verwendet.
`Proposal.deals.createProductRevision`	Dieses Feld wird nicht mehr verwendet.
`Proposal.deals.displayName`	`Deal.displayName`
`Proposal.deals.buyerPrivateData.referenceId`	Dieses Feld wird nicht mehr verwendet. ist es jetzt nur noch im Angebot
`Proposal.deals.dealTerms.description`	`Deal.description`
`Proposal.deals.dealTerms.brandingType`	Dieses Feld wird nicht mehr verwendet.
`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` Beachten Sie, dass `guaranteedFixedPriceTerms.fixedPrices` zwar ein wiederholt wurde, wurde es nie mit mehr als einem Eintrag gefüllt. Als führt dazu, dass die `programmaticGuaranteedTerms.fixedPrice` ist äquivalent.
`Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms`	`Deal.preferredDealTerms` Beachten Sie, dass `nonGuaranteedFixedPriceTerms.fixedPrices` zwar ein wiederkehrendes Feld wurde, wurde es nie mit mehr als einem einzigen Eintrag gefüllt. Daher werden die `preferredDealTerms.fixedPrice` ist äquivalent.
`Proposal.deals.dealTerms.NonGuaranteedAuctionTerms`	`Deal.privateAuctionTerms` Hinweis: Während `nonGuaranteedAuctionTerms.reservePricesPerBuyer` ist ein wiederholten Feld enthält, wurde er nie mit mehr als einem Eintrag gefüllt. Als führt dazu, dass die `privateAuctionTerms.floorPrice` ist äquivalent.
`Proposal.deals.webPropertyCode`	Dieses Feld wird nicht mehr verwendet.
`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, Targeting-Kategorie bestimmen Kategorien, die u. U. finden Sie in `Deal.targeting`. Beispiel: Der Parameter Der `GOOG_CREATIVE_SIZE`-Schlüssel von Ad Exchange für Käufer II bezieht sich auf Marketplace-APIs `Deal.targeting.inventorySizeTargeting`.
`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 wird nicht mehr verwendet.
`Proposal.deals.syndicationProduct`	Dieses Feld wird nicht mehr verwendet.
`Proposal.deals.creativePreApprovalPolicy`	`Deal.creativeRequirements.creativePreApprovalPolicy`
`Proposal.deals.creativeSafeFrameCompatibility`	`Deal.creativeRequirements.creativeSafeFrameCompatibility`
`Proposal.deals.dealServingMetadata`	Ähnliche Informationen finden Sie in der `FinalizedDeal.dealPausingInfo`.
`Proposal.deals.programmaticCreativeSource`	`Deal.creativeRequirements.programmaticCreativeSource`
`Proposal.deals.deliveryControl`	`Deal.deliveryControl` Es wurden zusätzliche Informationen zum Hinzufügen von Angeboten hinzugefügt.
`Proposal.deals.isSetupComplete`	`FinalizedDeal.readyToServe` Sie können jetzt nur signalisieren, dass ein Deal ausgeliefert werden kann, wenn er abgeschlossen ist. `buyers.finalizedDeals.setReadyToServe` verwenden um anzugeben, dass der endgültige programmatisch garantierte Deal und kann bereitgestellt werden.
`Proposal.originatorRole`	`Proposal.originatorRole`
`Proposal.seller.accountId`	`Proposal.publisherProfile` Verwenden Sie den Namen des Publisher-Profils, um den Verkäufer zu identifizieren. Hier finden Sie Publisher-Profile mit `buyers.publisherProfiles` .
`Proposal.seller.subAccountId`	`Proposal.publisherProfile` Verwenden Sie den Namen des Publisher-Profils, um den Verkäufer zu identifizieren. Hier finden Sie Publisher-Profile mit `buyers.publisherProfiles` .
`Proposal.buyer.accountId`	`Proposal.buyer` oder `Proposal.client`. Welches Feld verwendet wird, richtet sich nach dem Kontotyp des Käufer. Dies sind die Ressourcennamen einer Real-time Bidding API. `buyers`-Ressource oder Marketplace API `buyers.clients`.
`Proposal.billedBuyer.accountId`	`Proposal.billedBuyer` Dies ist jetzt ein Ressourcenname, der sich auf ein Käuferkonto bezieht: dargestellt in der `buyers` der Real-time Bidding API .
`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 verwendet.
`Proposal.isSetupComplete`	`FinalizedDeal.readyToServe` Jetzt mit `buyers.finalizedDeals` noch detaillierter zugänglich.
`Proposal.lastUpdaterOrCommentorRole`	`Proposal.lastUpdaterOrCommentorRole`
`Proposal.notes.proposalRevision`	Dieses Feld wird nicht mehr verwendet.
`Proposal.notes.noteId`	Dieses Feld wird nicht mehr verwendet.
`Proposal.notes.createTime`	`Proposal.notes.createTime`
`Proposal.notes.creatorRole`	`Proposal.notes.creatorRole`
`Proposal.notes.note`	`Proposal.notes.note`
`Proposal.termsAndConditions`	`Proposal.termsAndConditions`