Bật API
Tương tự như các API khác của Authorized Buyers, bạn cần bật API Marketplace trước khi có thể sử dụng. Bạn có thể bật Marketplace API bằng các bước sau:
- Truy cập vào trang API được bật trong Bảng điều khiển API của Google. Chọn dự án bạn sử dụng để truy cập vào các API khác của Authorized Buyers, chẳng hạn như Ad Exchange Buyer II hoặc API Đặt giá thầu theo thời gian thực.
- Nhấp vào liên kết + BẬT API VÀ DỊCH VỤ.
- Trong hộp tìm kiếm, hãy nhập "Authorized Buyers Marketplace API" rồi nhấn Enter.
- Trong kết quả tìm kiếm, hãy chọn Authorized Buyers Marketplace API.
- Nhấp vào nút BẬT để bật API Marketplace.
- Giờ đây, bạn có thể truy cập vào API Marketplace bằng thông tin đăng nhập đã tạo trong dự án này.
Cập nhật thông tin xác thực OAuth 2.0
Quy trình làm việc OAuth 2.0 hiện tại có phạm vi API Ad Exchange Buyer II cần thay đổi để 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 API OAuth 2.0 của Tài khoản dịch vụ để truy cập API. Tất cả quy trình OAuth 2.0 được hỗ trợ phải chỉ định phạm vi API mới để yêu cầu Google cấp một mã thông báo có thể truy cập vào API Marketplace.
Liên kết tài nguyên API Ad Exchange Buyer II tới API Marketplace
Khách hàng
Nếu sử dụng tài nguyên accounts.clients
của API Ad Exchange Buyer II, bạn có thể di chuyển sang tài nguyên buyers.clients
của API Marketplace.
Phương thức tài nguyên
API Ad Exchange Buyer 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ợ các bộ lọc danh sách. |
accounts.clients.update |
buyers.clients.patch
Phương thức này hiện hỗ trợ việc cập nhật một phần bằng tham số |
Trường tài nguyên
API Ad Exchange Buyer II | API Marketplace |
---|---|
Client.clientAccountId |
Client.name
|
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 Marketplace kết hợp chức năng của tài nguyên accounts.clients.invitations
và accounts.clients.users
của API Ad Exchange Buyer II vào một tài nguyên buyers.clients.users
.
Phương thức tài nguyên
API Ad Exchange Buyer 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ó |
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á lỗi người dùng ứng dụng bằng API nữa. Bạn nên sử dụng
|
Trường tài nguyên
API Ad Exchange Buyer 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 cho người dùng là khách hàng nữa. Thay vào đó, hãy xem |
ClientUser.userId |
ClientUser.name
|
ClientUser.clientAccountId |
Trường này không còn tồn tại cho người dùng là khách hàng nữa. Thay vào đó, hãy xem |
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 sử dụng tài nguyên accounts.publisherProfiles
của API Ad Exchange Buyer II, bạn có thể di chuyển sang tài nguyên buyers.publisherProfiles
của API Marketplace.
Phương thức tài nguyên
API Ad Exchange Buyer 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ợ các bộ lọc danh sách. |
Trường tài nguyên
API Ad Exchange Buyer II | API Marketplace |
---|---|
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 |
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 hoàn thiện
Nếu sử dụng tài nguyên accounts.proposals
của API Ad Exchange Buyer 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 trong tài nguyên phụ buyers.proposals.deals
. Đề xuất đã hoàn tất không còn được thể hiện trong API, giúp 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 bằng tài nguyên buyers.finalizedDeals
.
Phương thức tài nguyên
API Ad Exchange Buyer II | API Marketplace |
---|---|
accounts.proposals.accept |
buyers.proposals.accept
Chỉ gọi |
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 này sẽ không còn chứa thông tin về 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ề các giao dịch nữa. Nếu bạn dùng tính năng lọc danh sách, xin lưu ý rằng API Marketplace chỉ hỗ trợ cú pháp 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ợ việc cập nhật một phần bằng tham số |
accounts.finalizedProposals.list |
Sử dụng
|
accounts.finalizedProposals.pause |
Sử dụng
|
accounts.finalizedProposals.resume |
Sử dụng
|
Trường tài nguyên
Các tài nguyên proposals
và finalizedProposals
có cùng cách trình bày Proposal
và có các bước di chuyển tương tự.
API Ad Exchange Buyer II | API Marketplace |
---|---|
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 |
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 |
Hãy lưu ý rằng mặc dù |
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms |
Xin lưu ý rằng mặc dù |
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms |
Xin lưu ý rằng mặc dù |
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 còn có 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, bạn có thể tìm thấy các danh mục có thể nhắm mục tiêu trong |
Proposal.deals.targeting |
Deal.targeting
Đã thêm các danh mục tiêu chí nhắm mục tiêu bổ sung. |
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 |
Proposal.deals.programmaticCreativeSource |
Deal.creativeRequirements.programmaticCreativeSource |
Proposal.deals.deliveryControl |
Deal.deliveryControl
Thông tin bổ sung về cách thêm thoả thuận. |
Proposal.deals.isSetupComplete |
FinalizedDeal.readyToServe
Giờ đây, bạn chỉ có thể báo hiệu rằng một giao dịch đã sẵn sàng phân phát nếu giao dịch đó đã hoàn tất. Hãy sử dụng phương thức |
Proposal.originatorRole |
Proposal.originatorRole |
Proposal.seller.accountId |
Proposal.publisherProfile
Hãy 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 |
Proposal.seller.subAccountId |
Proposal.publisherProfile
Hãy 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 |
Proposal.buyer.accountId |
Trường được sử dụng sẽ phụ thuộc vào loại tài khoản của người mua
thương lượng. Đây là tên tài nguyên của tài nguyên API Đặt giá thầu theo thời gian thực |
Proposal.billedBuyer.accountId |
Proposal.billedBuyer
Đây hiện là tên tài nguyên tham chiếu đến tài khoản người mua như được thể hiện trong tài nguyê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
Hiện đã được truy cập chi tiết hơn bằng |
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 |