Bermigrasi ke Marketplace API

Mengaktifkan API

Serupa dengan Authorized Buyers lainnya API, Anda harus mengaktifkan Marketplace API sebelum Anda dapat menggunakannya. Anda dapat mengaktifkan Marketplace API dengan langkah-langkah berikut:

  1. Buka API yang Diaktifkan Konsol API Google halaman kami. Pilih yang Anda gunakan untuk mengakses Authorized Buyers API lainnya, seperti Pembeli Ad Exchange II atau API Bidding Real-time
  2. Klik link + ENABLE APIS AND SERVICES.
  3. Di kotak penelusuran, ketik "Authorized Buyers Marketplace API", dan tekan Tekan Enter.
  4. Di hasil penelusuran, pilih Authorized Buyers Marketplace API.
  5. Klik tombol ENABLE untuk mengaktifkan Marketplace API.
  6. Sekarang Anda dapat mengakses Marketplace API dengan kredensial yang dibuat dalam project ini.

Memperbarui kredensial OAuth 2.0 Anda

Alur kerja OAuth 2.0 yang ada dengan cakupan Ad Exchange Buyer II API harus diubah untuk menggunakan cakupan API Marketplace:

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

Sebaiknya gunakan OAuth 2.0 Akun Layanan untuk mengakses API. Semua alur OAuth 2.0 yang didukung harus menetapkan API yang baru cakupan untuk meminta token dari Google yang dapat mengakses Marketplace API.

Memetakan sumber daya API Pembeli Ad Exchange II ke Marketplace API

Klien

Jika Anda menggunakan API Pembeli Ad Exchange accounts.clients Anda dapat bermigrasi ke API Marketplace buyers.clients resource Anda

Metode resource

API Pembeli Ad Exchange II API Marketplace
accounts.clients.create buyers.clients.create
accounts.clients.get buyers.clients.get
accounts.clients.list buyers.clients.list

Metode ini sekarang mendukung filter daftar.

accounts.clients.update buyers.clients.patch

Metode ini sekarang mendukung update parsial dengan Parameter updateMask.

Kolom resource

API Pembeli Ad Exchange II API Marketplace
Client.clientAccountId Client.name

clientAccountId adalah ID resource klien.
Client.role Client.role
Client.status Client.state
Client.clientName Client.displayName
Client.visibleToSeller Client.sellerVisible
Client.entityType

Kolom ini telah dihentikan.
Client.entityId

Kolom ini telah dihentikan.
Client.entityName

Kolom ini telah dihentikan.
Client.partnerClientId Client.partnerClientId

Undangan & Pengguna

Marketplace API menggabungkan fungsi API Pembeli Ad Exchange accounts.clients.invitations dan accounts.clients.users resource menjadi satu buyers.clients.users resource Anda

Metode resource

API Pembeli Ad Exchange II API Marketplace
accounts.clients.invitations.create buyers.clients.users.create
accounts.clients.invitations.get buyers.clients.users.get
accounts.clients.invitations.list buyers.clients.users.list

Hanya pengguna dengan state mereka yang ditetapkan ke INVITED akan setara dengan nilai yang dikembalikan oleh accounts.clients.invitations.list.

accounts.clients.users.get buyers.clients.users.get
accounts.clients.users.list buyers.clients.users.list
accounts.clients.users.update

Anda tidak lagi dapat membuat patch pengguna klien dengan API. Saran dari kami yang Anda gunakan buyers.clients.users.delete untuk menghapus pengguna klien dan membuatnya kembali dengan perubahan yang disukai.

Kolom resource

API Pembeli Ad Exchange II API Marketplace
ClientUserInvitation.invitationId

Kolom ini telah dihentikan.
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

Kolom ini sudah tidak ada untuk pengguna klien. Sebagai gantinya, lihat clientAccountId atas nama klien induk.
ClientUser.userId ClientUser.name

userId adalah ID resource pengguna.
ClientUser.clientAccountId

Kolom ini sudah tidak ada untuk pengguna klien. Sebagai gantinya, lihat clientAccountId atas nama klien induk.
ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

Produk

Resource ini beserta fungsinya tidak tersedia di Marketplace API.

PublisherProfiles

Jika Anda menggunakan API Pembeli Ad Exchange accounts.publisherProfiles Anda dapat bermigrasi ke API Marketplace buyers.publisherProfiles resource Anda

Metode resource

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

Metode ini sekarang mendukung filter daftar.

Kolom resource

API Pembeli Ad Exchange II API Marketplace
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId adalah resource profil penayang ke 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

Kolom ini telah dihentikan.
PublisherProfile.googlePlusUrl

Kolom ini telah dihentikan.
PublisherProfile.overview PublisherProfile.overview
PublisherProfile.buyerPitchStatement PublisherProfile.pitchStatement
PublisherProfile.topHeadlines PublisherProfile.topHeadlines
PublisherProfile.audienceDescription PublisherProfile.audienceDescription
PublisherProfile.isParent PublisherProfile.isParent

Proposal & FinalizedProposals

Jika Anda menggunakan API Pembeli Ad Exchange accounts.proposals Anda dapat bermigrasi ke API Marketplace buyers.proposals resource Anda Transaksi telah dipisahkan dari proposal ke dalam buyers.proposals.deals sub-resource tertentu. Proposal yang telah diselesaikan tidak lagi direpresentasikan di API, sehingga kontrol yang lebih terperinci atas transaksi yang diselesaikan dengan buyers.finalizedDeals resource Anda

Metode resource

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

Hanya panggil buyers.proposals.accept jika status proposal adalah BUYER_ACCEPTANCE_REQUESTED.
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

Perlu diketahui bahwa proposal tidak akan lagi berisi informasi tentang transaksi.

accounts.proposals.list buyers.proposals.list

Perhatikan bahwa proposal yang dikembalikan tidak akan lagi berisi informasi tentang penawaran. Jika Anda menggunakan pemfilteran daftar, perhatikan bahwa hanya Marketplace API mendukung sintaksis filter daftar.
accounts.proposals.pause buyers.finalizedDeals.pause
accounts.proposals.resume buyers.finalizedDeals.resume
accounts.proposals.update buyers.proposals.patch

Metode ini sekarang mendukung update parsial dengan Parameter updateMask.
accounts.finalizedProposals.list

Gunakan buyers.finalizedDeals.list untuk melihat transaksi yang diselesaikan untuk akun pembeli tertentu. Sekarang Anda dapat mengambil transaksi yang diselesaikan pada tingkat bidder dengan bidders.finalizedDeals.list.
accounts.finalizedProposals.pause

Gunakan buyers.finalizedDeals.pause untuk menjeda satu per satu transaksi yang diselesaikan untuk akun pembeli tertentu.
accounts.finalizedProposals.resume

Gunakan buyers.finalizedDeals.resume untuk melanjutkan satu per satu transaksi yang diselesaikan untuk akun pembeli tertentu.

Kolom resource

Resource proposals dan finalizedProposals memiliki Proposal yang sama dan memiliki langkah-langkah migrasi yang serupa.

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

proposalId adalah ID resource proposal.
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

Proposal.proposalRevision dan Deal.proposalRevision
Proposal.deals.dealId Deal.name

dealId adalah ID resource transaksi.
Proposal.deals.proposalId Deal.name

proposalId adalah ID resource proposal induk.
Proposal.deals.createTime Deal.createTime
Proposal.deals.updateTime Deal.updateTime
Proposal.deals.createProductId

Kolom ini telah dihentikan.
Proposal.deals.createProductRevision

Kolom ini telah dihentikan.
Proposal.deals.displayName Deal.displayName
Proposal.deals.buyerPrivateData.referenceId

Bidang ini telah terbenam; sekarang hanya diekspos dalam proposal level organisasi.
Proposal.deals.dealTerms.description Deal.description
Proposal.deals.dealTerms.brandingType

Kolom ini telah dihentikan.
Proposal.deals.dealTerms.estimatedGrossSpend Deal.estimatedGrossSpend
Proposal.deals.dealTerms.estimatedImpressionsPerDay

Kolom ini telah dihentikan.
Proposal.deals.dealTerms.sellerTimeZone Deal.sellerTimeZone
Proposal.deals.dealTerms.guaranteedFixedPriceTerms

Deal.programmaticGuaranteedTerms

Perhatikan bahwa meskipun guaranteedFixedPriceTerms.fixedPrices adalah berulang, tidak pernah diisi dengan lebih dari satu entri. Sebagai Oleh karena itu, API Marketplace programmaticGuaranteedTerms.fixedPrice setara.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

Perhatikan bahwa meskipun nonGuaranteedFixedPriceTerms.fixedPrices adalah isian berulang, maka tidak pernah diisi dengan lebih dari satu entri. Akibatnya, API Marketplace preferredDealTerms.fixedPrice setara.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

Perhatikan bahwa meskipun nonGuaranteedAuctionTerms.reservePricesPerBuyer adalah berulang, tidak pernah diisi dengan lebih dari satu entri. Sebagai Oleh karena itu, API Marketplace privateAuctionTerms.floorPrice setara.
Proposal.deals.webPropertyCode

Kolom ini telah dihentikan.
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

Anda tidak dapat lagi mengonfigurasi penargetan menggunakan kunci untuk menentukan kategori penargetan; namun, kategori yang dapat yang ditargetkan dapat ditemukan di Deal.targeting. Misalnya, Kunci GOOG_CREATIVE_SIZE dari Pembeli Ad Exchange II mengacu pada Marketplace API Deal.targeting.inventorySizeTargeting.
Proposal.deals.targeting Deal.targeting

Kategori kriteria penargetan tambahan telah ditambahkan.
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

Kolom ini telah dihentikan.
Proposal.deals.syndicationProduct

Kolom ini telah dihentikan.
Proposal.deals.creativePreApprovalPolicy Deal.creativeRequirements.creativePreApprovalPolicy
Proposal.deals.creativeSafeFrameCompatibility Deal.creativeRequirements.creativeSafeFrameCompatibility
Proposal.deals.dealServingMetadata

Informasi serupa dapat ditemukan di Kolom FinalizedDeal.dealPausingInfo.
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

Detail tambahan tentang cara menambahkan transaksi.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

Anda sekarang hanya dapat menandakan bahwa transaksi siap ditayangkan jika diselesaikan. Menggunakan buyers.finalizedDeals.setReadyToServe untuk menunjukkan bahwa transaksi Dijamin Terprogram yang diselesaikan siap tayang.
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

Gunakan nama profil penayang untuk mengidentifikasi penjual. Anda dapat melihat profil penayang dengan buyers.publisherProfiles resource Anda
Proposal.seller.subAccountId Proposal.publisherProfile

Gunakan nama profil penayang untuk mengidentifikasi penjual. Anda dapat melihat profil penayang dengan buyers.publisherProfiles resource Anda
Proposal.buyer.accountId

Proposal.buyer atau Proposal.client.

Kolom yang digunakan akan bergantung pada jenis akun negosiasi pembeli. Ini adalah nama resource dari Real-time Bidding API Resource buyers, atau Marketplace API masing-masing resource buyers.clients.
Proposal.billedBuyer.accountId Proposal.billedBuyer

Sekarang ini menjadi nama resource yang mengacu ke akun pembeli sebagai yang direpresentasikan dalam buyers Real-time Bidding API resource Anda
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

Kolom ini telah dihentikan.
Proposal.isSetupComplete FinalizedDeal.readyToServe

Sekarang diakses secara lebih terperinci dengan buyers.finalizedDeals.

Proposal.lastUpdaterOrCommentorRole Proposal.lastUpdaterOrCommentorRole
Proposal.notes.proposalRevision

Kolom ini telah dihentikan.
Proposal.notes.noteId

Kolom ini telah dihentikan.
Proposal.notes.createTime Proposal.notes.createTime
Proposal.notes.creatorRole Proposal.notes.creatorRole
Proposal.notes.note Proposal.notes.note
Proposal.termsAndConditions Proposal.termsAndConditions