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 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.
- Klicken Sie auf den Link + APIS UND DIENSTE AKTIVIEREN.
- Geben Sie in das Suchfeld Authorized Buyers Marketplace API 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 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 |
Ressourcenfelder
API für Ad Exchange-Käufer II | 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 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 |
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
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 |
ClientUser.userId |
ClientUser.name
|
ClientUser.clientAccountId |
Dieses Feld gibt es für Kundennutzer nicht mehr. Sehen Sie sich stattdessen die |
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
|
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 |
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 |
accounts.finalizedProposals.list |
Verwenden Sie
|
accounts.finalizedProposals.pause |
Verwenden Sie
|
accounts.finalizedProposals.resume |
Verwenden Sie
|
Ressourcenfelder
Die proposals
- und finalizedProposals
-Ressourcen haben dieselbe Proposal
-Darstellung und ähnliche Migrationsschritte.
Ad Exchange Buyers 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 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 |
|
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms |
|
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms |
|
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 |
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 |
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 |
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 |
Proposal.seller.subAccountId |
Proposal.publisherProfile
Verwenden Sie den Namen des Publisher-Profils, um den Verkäufer zu identifizieren. Mit der Ressource |
Proposal.buyer.accountId |
Welches Feld verwendet wird, hängt vom Kontotyp des verhandelnden Käufers ab. Dies sind die Ressourcennamen einer Realtime Bidding API |
Proposal.billedBuyer.accountId |
Proposal.billedBuyer
Dies ist jetzt ein Ressourcenname, der sich auf ein Käuferkonto bezieht, wie es in der |
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 |
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 |