Di chuyển sang API Marketplace

Bật API

Tương tự như các Authorized Buyers khác API, bạn cần bật API Marketplace trước đây bạn có thể sử dụng nó. Bạn có thể bật API Marketplace theo các bước sau:

  1. Truy cập API được bật trên Bảng điều khiển của Google API . Chọn dự án bạn dùng để truy cập vào các API Authorized Buyers khác, chẳng hạn như Người mua Ad Exchange II hoặc API Đặt giá thầu theo thời gian thực.
  2. Nhấp vào liên kết + BẬT API VÀ DỊCH VỤ.
  3. Trong hộp tìm kiếm, hãy nhập "Authorized Buyers Marketplace API", rồi nhấn phím Nhập.
  4. Trong kết quả tìm kiếm, hãy chọn Authorized Buyers Marketplace API.
  5. Nhấp vào nút BẬT để bật API Marketplace.
  6. Giờ đây, bạn có thể truy cập vào API Marketplace bằng thông tin đăng nhập được tạo trong dự án này.

Cập nhật thông tin đăng nhập OAuth 2.0 của bạn

Quy trình làm việc OAuth 2.0 hiện có với phạm vi Ad Exchange Buyer II API cần phải đã thay đổi thành sử dụng phạm vi API Marketplace:

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

Bạn nên dùng Tài khoản dịch vụ OAuth 2.0 quy trình truy cập API. Tất cả các luồng OAuth 2.0 được hỗ trợ đều phải chỉ định API mới để yêu cầu một mã thông báo từ Google có thể truy cập API Marketplace.

Liên kết tài nguyên Ad Exchange Buyer II API với API thị trường

Khách hàng

Nếu bạn sử dụng accounts.clients tài nguyên, bạn có thể di chuyển sang API Marketplace buyers.clients nguồn.

Phương thức tài nguyên

API người mua Ad Exchange II API Marketplace
accounts.clients.create buyers.clients.create
accounts.clients.get buyers.clients.get
accounts.clients.list buyers.clients.list

Phương thức này hiện hỗ trợ bộ lọc danh sách.

accounts.clients.update buyers.clients.patch

Phương thức này hiện hỗ trợ cập nhật một phần bằng Tham số updateMask.

Trường tài nguyên

API người mua Ad Exchange II API Marketplace
Client.clientAccountId Client.name

clientAccountId là mã nhận dạng tài nguyên ứng dụng.
Client.role Client.role
Client.status Client.state
Client.clientName Client.displayName
Client.visibleToSeller Client.sellerVisible
Client.entityType

Trường này đã ngừng hoạt động.
Client.entityId

Trường này đã ngừng hoạt động.
Client.entityName

Trường này đã ngừng hoạt động.
Client.partnerClientId Client.partnerClientId

Lời mời và Người dùng

API thị trường kết hợp chức năng của API Người mua II của Ad Exchange accounts.clients.invitations và accounts.clients.users vào một bộ nhớ duy nhất buyers.clients.users nguồn.

Phương thức tài nguyên

API người mua 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

Chỉ những người dùng có state của họ được đặt thành INVITED sẽ tương đương với kết quả được trả về bởi accounts.clients.invitations.list.

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

Bạn không thể vá người dùng ứng dụng bằng API được nữa. Bạn nên mà bạn sử dụng buyers.clients.users.delete để xoá người dùng khách hàng của bạn và tạo lại nó bằng các thay đổi ưu tiên.

Trường tài nguyên

API người mua Ad Exchange II API Marketplace
ClientUserInvitation.invitationId

Trường này đã ngừng hoạt động.
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

Trường này không còn tồn tại đối với người dùng là khách hàng. Thay vào đó, hãy xem clientAccountId trong tên của ứng dụng mẹ.
ClientUser.userId ClientUser.name

userId là mã nhận dạng tài nguyên người dùng.
ClientUser.clientAccountId

Trường này không còn tồn tại đối với người dùng là khách hàng. Thay vào đó, hãy xem clientAccountId trong tên của ứng dụng mẹ.
ClientUser.status ClientUser.state
ClientUser.email ClientUser.email

Sản phẩm

Tài nguyên này và chức năng của nó không có trong API Marketplace.

PublisherProfiles

Nếu bạn sử dụng accounts.publisherProfiles tài nguyên, bạn có thể di chuyển sang API Marketplace buyers.publisherProfiles nguồn.

Phương thức tài nguyên

API người mua Ad Exchange II API Marketplace
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

Phương thức này hiện hỗ trợ bộ lọc danh sách.

Trường tài nguyên

API người mua Ad Exchange II API Marketplace
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId là tài nguyên hồ sơ nhà xuất bản Mã nhận dạng.
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

Trường này đã ngừng hoạt động.
PublisherProfile.googlePlusUrl

Trường này đã ngừng hoạt động.
PublisherProfile.overview PublisherProfile.overview
PublisherProfile.buyerPitchStatement PublisherProfile.pitchStatement
PublisherProfile.topHeadlines PublisherProfile.topHeadlines
PublisherProfile.audienceDescription PublisherProfile.audienceDescription
PublisherProfile.isParent PublisherProfile.isParent

Đề xuất và FinalizedProposals

Nếu bạn sử dụng accounts.proposals tài nguyên, bạn có thể di chuyển sang API Marketplace buyers.proposals nguồn. Giao dịch đã được tách khỏi đề xuất thành buyers.proposals.deals tài nguyên phụ. Đề xuất đã hoàn tất không còn được trình bày trong API, do đó, bạn có quyền kiểm soát chi tiết hơn đối với các giao dịch đã hoàn tất với buyers.finalizedDeals nguồn.

Phương thức tài nguyên

API người mua Ad Exchange II API Marketplace
accounts.proposals.accept buyers.proposals.accept

Chỉ gọi buyers.proposals.accept khi trạng thái của đề xuất là 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

Lưu ý rằng đề xuất này sẽ không còn chứa thông tin về giao dịch.

accounts.proposals.list buyers.proposals.list

Lưu ý rằng các đề xuất được trả về sẽ không còn chứa thông tin về các giao dịch. Nếu bạn sử dụng tính năng lọc danh sách, hãy lưu ý rằng chỉ API Marketplace hỗ trợ cú pháp bộ lọc danh sách.
accounts.proposals.pause buyers.finalizedDeals.pause
accounts.proposals.resume buyers.finalizedDeals.resume
accounts.proposals.update buyers.proposals.patch

Phương thức này hiện hỗ trợ cập nhật một phần bằng Tham số updateMask.
accounts.finalizedProposals.list

Sử dụng buyers.finalizedDeals.list để xem giao dịch đã hoàn tất cho một tài khoản người mua nhất định. Bây giờ, bạn có thể truy xuất các giao dịch đã hoàn tất ở cấp bên đặt giá thầu với bidders.finalizedDeals.list.
accounts.finalizedProposals.pause

Sử dụng buyers.finalizedDeals.pause để tạm dừng từng tài khoản giao dịch đã hoàn tất cho một tài khoản người mua nhất định.
accounts.finalizedProposals.resume

Sử dụng buyers.finalizedDeals.resume để tiếp tục chiến dịch riêng lẻ giao dịch đã hoàn tất cho một tài khoản người mua nhất định.

Trường tài nguyên

Các tài nguyên proposals và finalizedProposals có cùng Proposal và có các bước di chuyển tương tự.

API người mua Ad Exchange II API Marketplace
Proposal.proposalId Proposal.name

proposalId là mã tài nguyên đề xuất.
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

Proposal.proposalRevision và Deal.proposalRevision
Proposal.deals.dealId Deal.name

dealId là mã tài nguyên giao dịch.
Proposal.deals.proposalId Deal.name

proposalId là mã tài nguyên đề xuất gốc.
Proposal.deals.createTime Deal.createTime
Proposal.deals.updateTime Deal.updateTime
Proposal.deals.createProductId

Trường này đã ngừng hoạt động.
Proposal.deals.createProductRevision

Trường này đã ngừng hoạt động.
Proposal.deals.displayName Deal.displayName
Proposal.deals.buyerPrivateData.referenceId

Trường này đã ngừng hoạt động; nó hiện chỉ được hiển thị theo đề xuất cấp độ.
Proposal.deals.dealTerms.description Deal.description
Proposal.deals.dealTerms.brandingType

Trường này đã ngừng hoạt động.
Proposal.deals.dealTerms.estimatedGrossSpend Deal.estimatedGrossSpend
Proposal.deals.dealTerms.estimatedImpressionsPerDay

Trường này đã ngừng hoạt động.
Proposal.deals.dealTerms.sellerTimeZone Deal.sellerTimeZone
Proposal.deals.dealTerms.guaranteedFixedPriceTerms

Deal.programmaticGuaranteedTerms

Xin lưu ý rằng mặc dù guaranteedFixedPriceTerms.fixedPrices là một trường lặp lại, nên trường này không bao giờ được điền nhiều hơn một mục nhập. Như thì API Marketplace programmaticGuaranteedTerms.fixedPrice là tương đương.
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

Xin lưu ý rằng mặc dù nonGuaranteedFixedPriceTerms.fixedPrices là một trường lặp lại, trường này không bao giờ được điền nhiều hơn một mục nhập. Do đó, API Marketplace preferredDealTerms.fixedPrice là tương đương.
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

Xin lưu ý rằng mặc dù nonGuaranteedAuctionTerms.reservePricesPerBuyer là một trường lặp lại, nên trường này không bao giờ được điền nhiều hơn một mục nhập. Như thì API Marketplace privateAuctionTerms.floorPrice là tương đương.
Proposal.deals.webPropertyCode

Trường này đã ngừng hoạt động.
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

Bạn không thể định cấu hình tiêu chí nhắm mục tiêu bằng khoá để xác định danh mục nhắm mục tiêu; tuy nhiên, các danh mục có thể được nhắm mục tiêu trong Deal.targeting. Ví dụ: Khoá GOOG_CREATIVE_SIZE từ Ad Exchange Buyer II đề cập đến API Marketplace Deal.targeting.inventorySizeTargeting
Proposal.deals.targeting Deal.targeting

Các danh mục tiêu chí nhắm mục tiêu bổ sung đã được thêm vào.
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

Trường này đã ngừng hoạt động.
Proposal.deals.syndicationProduct

Trường này đã ngừng hoạt động.
Proposal.deals.creativePreApprovalPolicy Deal.creativeRequirements.creativePreApprovalPolicy
Proposal.deals.creativeSafeFrameCompatibility Deal.creativeRequirements.creativeSafeFrameCompatibility
Proposal.deals.dealServingMetadata

Bạn có thể tìm thấy thông tin tương tự trong Trường FinalizedDeal.dealPausingInfo.
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

Thông tin bổ sung về cách thêm các thỏa thuận.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

Bây giờ, bạn chỉ có thể báo hiệu rằng một giao dịch đã sẵn sàng để phân phát đã hoàn tất. Sử dụng buyers.finalizedDeals.setReadyToServe để cho biết rằng giao dịch Đảm bảo có lập trình đã hoàn tất của bạn là sẵn sàng phân phát.
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

Sử dụng tên hồ sơ nhà xuất bản để xác định người bán. Bạn có thể xem hồ sơ nhà xuất bản có buyers.publisherProfiles nguồn.
Proposal.seller.subAccountId Proposal.publisherProfile

Sử dụng tên hồ sơ nhà xuất bản để xác định người bán. Bạn có thể xem hồ sơ nhà xuất bản có buyers.publisherProfiles nguồn.
Proposal.buyer.accountId

Proposal.buyer hoặc Proposal.client.

Trường được sử dụng sẽ phụ thuộc vào loại tài khoản của thương lượng người mua. Đây là các tên tài nguyên của một API Đặt giá thầu theo thời gian thực Tài nguyên buyers hoặc API Marketplace tài nguyên buyers.clients tương ứng.
Proposal.billedBuyer.accountId Proposal.billedBuyer

Đây là tên tài nguyên tham chiếu đến tài khoản người mua dưới dạng được thể hiện trong buyers của API Đặt giá thầu theo thời gian thực nguồn.
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

Trường này đã ngừng hoạt động.
Proposal.isSetupComplete FinalizedDeal.readyToServe

Giờ đây, bạn có thể truy cập chi tiết hơn nhờ buyers.finalizedDeals.

Proposal.lastUpdaterOrCommentorRole Proposal.lastUpdaterOrCommentorRole
Proposal.notes.proposalRevision

Trường này đã ngừng hoạt động.
Proposal.notes.noteId

Trường này đã ngừng hoạt động.
Proposal.notes.createTime Proposal.notes.createTime
Proposal.notes.creatorRole Proposal.notes.creatorRole
Proposal.notes.note Proposal.notes.note
Proposal.termsAndConditions Proposal.termsAndConditions