Di chuyển sang API Marketplace

Bật API

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

  1. Chuyển đến trang API đã bật trong Google API Console. Chọn dự án bạn sử dụng để truy cập vào các API Authorized Buyers khác, chẳng hạn như Ad Exchange Buyer II hoặc API Đặt giá thầu theo thời gian thực.
  2. Nhấp vào đường 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 Enter.
  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 xác thực đượ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

Bạn cần thay đổi quy trình làm việc hiện có của OAuth 2.0 có phạm vi API Người mua Ad Exchange II để sử dụng phạm vi API Marketplace:

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

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

Liên kết tài nguyên API Ad Exchange Buyer II với API Marketplace

Khách hàng

Nếu sử dụng tài nguyên accounts.clients của Ad Exchange Buyer II API, bạn có thể di chuyển sang tài nguyên buyers.clients của API Thị trường.

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

Ad Exchange Buyer II API API Thị trường
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

Marketplace API kết hợp chức năng của các tài nguyên accounts.clients.invitations và accounts.clients.users của API Người mua Ad Exchange II thành một tài nguyên buyers.clients.users duy nhất.

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

Ad Exchange Buyer II API API Thị trường
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 đặt thành INVITED mới tương đương với những người dùng được accounts.clients.invitations.list trả về.

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 nữa. Bạn nên sử dụng buyers.clients.users.delete để xoá người dùng ứng dụng và tạo lại người dùng đó bằng các thay đổi ưu tiên.

Trường tài nguyên

API người mua Ad Exchange II API Thị trường
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 ứng dụng. Thay vào đó, hãy xem clientAccountId theo 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 ứng dụng. Thay vào đó, hãy xem clientAccountId theo 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 tài nguyên này không có trong Marketplace API.

PublisherProfiles

Nếu sử dụng tài nguyên accounts.publisherProfiles của Ad Exchange Buyer II API, bạn có thể di chuyển sang tài nguyên buyers.publisherProfiles của API Thị trường.

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

Ad Exchange Buyer II API API Thị trường
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 Thị trường
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId là mã nhận dạng tài nguyên hồ sơ nhà xuất bản.
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à Đề xuất đã kết thúc

Nếu sử dụng tài nguyên accounts.proposals của API Người mua Ad Exchange II, bạn có thể di chuyển sang tài nguyên buyers.proposals của API Marketplace. Các giao dịch đã được tách khỏi đề xuất thành tài nguyên phụ buyers.proposals.deals. Các đề xuất đã hoàn tất không còn được trình bày trong API nữa, giúp bạn kiểm soát chặt chẽ hơn các giao dịch đã hoàn tất bằng tài nguyên buyers.finalizedDeals.

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

Ad Exchange Buyer II API API Thị trường
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

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

accounts.proposals.list buyers.proposals.list

Xin lưu ý rằng các đề xuất được trả về sẽ không còn chứa thông tin về 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 Marketplace API chỉ 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 các giao dịch đã hoàn tất cho một tài khoản người mua nhất định. Giờ đây, bạn có thể truy xuất các giao dịch đã hoàn tất ở cấp bên đặt giá thầu bằng bidders.finalizedDeals.list.
accounts.finalizedProposals.pause

Sử dụng buyers.finalizedDeals.pause để tạm dừng từng 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 các giao dịch đã hoàn tất riêng lẻ 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 cách biểu diễn Proposal và có các bước di chuyển tương tự nhau.

Ad Exchange Buyer II API API Thị trường
Proposal.proposalId Proposal.name

proposalId là mã nhận dạng 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; hiện chỉ hiển thị ở cấp đề xuất.
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, nhưng trường này chưa bao giờ được điền nhiều mục nhập. Do đó, programmaticGuaranteedTerms.fixedPrice của API Marketplace 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, nhưng trường này chưa bao giờ được điền nhiều mục nhập. Do đó, preferredDealTerms.fixedPrice của API Marketplace 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, nhưng trường này chưa bao giờ được điền nhiều mục nhập. Do đó, privateAuctionTerms.floorPrice của API Marketplace sẽ 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 cách sử dụng khoá để xác định danh mục nhắm mục tiêu nữa; tuy nhiên, bạn có thể tìm thấy các danh mục có thể được nhắm mục tiêu trong Deal.targeting. Ví dụ: khoá GOOG_CREATIVE_SIZE của Người mua Ad Exchange II tham chiếu đến Deal.targeting.inventorySizeTargeting của API Marketplace.
Proposal.deals.targeting Deal.targeting

Thêm các danh mục tiêu chí nhắm mục tiêu khác.
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

Chúng tôi đã thêm thông tin chi tiết khác về cách đặt ưu đãi.
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

Giờ đây, bạn chỉ có thể báo hiệu rằng một thoả thuận đã sẵn sàng phân phát nếu thoả thuận đó đã được hoàn tất. Hãy sử dụng phương thức buyers.finalizedDeals.setReadyToServe để cho biết rằng giao dịch Đảm bảo có lập trình sau cùng của bạn đã 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 bằng tài nguyên buyers.publisherProfiles.
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 bằng tài nguyên buyers.publisherProfiles.
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 người mua đang thương lượng. Đây lần lượt là tên tài nguyên của tài nguyên buyers của API Đặt giá thầu theo thời gian thực hoặc buyers.clients của API Thị trường.
Proposal.billedBuyer.accountId Proposal.billedBuyer

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