啟用 API
與其他授權買家 API 類似,您必須先啟用 Marketplace API,才能使用該 API。您可以按照下列步驟啟用 Marketplace API:
- 前往 Google API 控制台「已啟用的 API」頁面。選取您用來存取其他 Authorized Buyers API 的專案,例如 Ad Exchange Buyer II 或 Real-time Bidding API。
- 按一下「+ 啟用 API 和服務」連結。
- 在搜尋框中輸入「Authorized Buyers Marketplace API」,然後按下 Enter 鍵。
- 在搜尋結果中選取「Authorized Buyers Marketplace API」。
- 按一下「啟用」按鈕啟用 Marketplace API。
- 您現在應該可以使用在此專案下建立的憑證存取 Marketplace API。
更新 OAuth 2.0 憑證
採用 Ad Exchange Buyer II API 範圍的現有 OAuth 2.0 工作流程,則必須改為使用 Marketplace API 範圍:
https://www.googleapis.com/auth/authorized-buyers-marketplace
建議您使用服務帳戶 OAuth 2.0 流程存取 API。所有支援的 OAuth 2.0 流程都必須指定新的 API 範圍,才能向 Google 要求可存取 Marketplace API 的權杖。
將 Ad Exchange Buyer II API 資源對應至 Marketplace API
客戶
如果您使用 Ad Exchange Buyer II API 的 accounts.clients
資源,可以遷移至 Marketplace API 的 buyers.clients
資源。
資源方法
Ad Exchange Buyer II API | Marketplace API |
---|---|
accounts.clients.create |
buyers.clients.create |
accounts.clients.get |
buyers.clients.get |
accounts.clients.list |
buyers.clients.list
這個方法現在支援清單篩選器。 |
accounts.clients.update |
buyers.clients.patch
這個方法現在支援使用 |
資源欄位
Ad Exchange Buyer II API | Marketplace API |
---|---|
Client.clientAccountId |
Client.name
|
Client.role |
Client.role |
Client.status |
Client.state |
Client.clientName |
Client.displayName |
Client.visibleToSeller |
Client.sellerVisible |
Client.entityType |
這個欄位已停用。 |
Client.entityId |
這個欄位已停用。 |
Client.entityName |
這個欄位已停用。 |
Client.partnerClientId |
Client.partnerClientId |
邀請和使用者
Marketplace API 將 Ad Exchange Buyer II API 的 accounts.clients.invitations
和 accounts.clients.users
資源的功能合併為單一 buyers.clients.users
資源。
資源方法
Ad Exchange Buyer 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
只有將 |
accounts.clients.users.get |
buyers.clients.users.get |
accounts.clients.users.list |
buyers.clients.users.list
|
accounts.clients.users.update |
您無法再透過 API 修補用戶端使用者。建議您使用
|
資源欄位
Ad Exchange Buyer II API | Marketplace API |
---|---|
ClientUserInvitation.invitationId |
這個欄位已停用。 |
ClientUserInvitation.email |
ClientUser.email |
ClientUserInvitation.clientAccountId |
此欄位已不再適用於用戶端使用者。請改為查看父項用戶端名稱中的 |
ClientUser.userId |
ClientUser.name
|
ClientUser.clientAccountId |
客戶使用者已無法再使用這個欄位。請改為查看父項用戶端名稱中的 |
ClientUser.status |
ClientUser.state |
ClientUser.email |
ClientUser.email |
產品
Marketplace API 不提供這項資源及其功能。
PublisherProfiles
如果您使用 Ad Exchange Buyer II API 的 accounts.publisherProfiles
資源,可以遷移至 Marketplace API 的 buyers.publisherProfiles
資源。
資源方法
Ad Exchange Buyer II API | Marketplace API |
---|---|
accounts.publisherProfiles.get |
buyers.publisherProfiles.get |
accounts.publisherProfiles.list |
buyers.publisherProfiles.list
這個方法現在支援清單篩選器。 |
資源欄位
Ad Exchange Buyer II API | 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 |
這個欄位已停用。 |
PublisherProfile.googlePlusUrl |
這個欄位已停用。 |
PublisherProfile.overview |
PublisherProfile.overview |
PublisherProfile.buyerPitchStatement |
PublisherProfile.pitchStatement |
PublisherProfile.topHeadlines |
PublisherProfile.topHeadlines |
PublisherProfile.audienceDescription |
PublisherProfile.audienceDescription |
PublisherProfile.isParent |
PublisherProfile.isParent |
提案與敲定提案
如果您使用 Ad Exchange Buyer II API 的 accounts.proposals
資源,可以遷移至 Marketplace API 的 buyers.proposals
資源。已將交易與 buyers.proposals.deals
子資源分開。API 不會再顯示最終的提案,方便您使用 buyers.finalizedDeals
資源更精細地控管最終交易。
資源方法
資源欄位
proposals
和 finalizedProposals
資源採用相同的 Proposal
表示法,且擁有類似的遷移步驟。
Ad Exchange Buyer 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 |
這個欄位已停用。 |
Proposal.deals.createProductRevision |
這個欄位已停用。 |
Proposal.deals.displayName |
Deal.displayName |
Proposal.deals.buyerPrivateData.referenceId |
這個欄位已淘汰,目前只會在提案層級顯示。 |
Proposal.deals.dealTerms.description |
Deal.description |
Proposal.deals.dealTerms.brandingType |
這個欄位已停用。 |
Proposal.deals.dealTerms.estimatedGrossSpend |
Deal.estimatedGrossSpend |
Proposal.deals.dealTerms.estimatedImpressionsPerDay |
這個欄位已停用。 |
Proposal.deals.dealTerms.sellerTimeZone |
Deal.sellerTimeZone |
Proposal.deals.dealTerms.guaranteedFixedPriceTerms |
請注意,雖然 |
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms |
請注意,雖然 |
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms |
請注意,雖然 |
Proposal.deals.webPropertyCode |
這個欄位已停用。 |
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
您已無法再使用鍵設定指定目標,但無法使用鍵來設定指定目標類別;不過,您可以在 |
Proposal.deals.targeting |
Deal.targeting
新增其他指定條件類別。 |
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 |
這個欄位已停用。 |
Proposal.deals.syndicationProduct |
這個欄位已停用。 |
Proposal.deals.creativePreApprovalPolicy |
Deal.creativeRequirements.creativePreApprovalPolicy |
Proposal.deals.creativeSafeFrameCompatibility |
Deal.creativeRequirements.creativeSafeFrameCompatibility
|
Proposal.deals.dealServingMetadata |
您可以在 |
Proposal.deals.programmaticCreativeSource |
Deal.creativeRequirements.programmaticCreativeSource |
Proposal.deals.deliveryControl |
Deal.deliveryControl
有關交易新增方式的其他詳細資料。 |
Proposal.deals.isSetupComplete |
FinalizedDeal.readyToServe
您現在只能在交易完成後,才可傳送交易已就緒的訊號。使用 |
Proposal.originatorRole |
Proposal.originatorRole |
Proposal.seller.accountId |
Proposal.publisherProfile
使用發布商個人資料名稱來識別賣方。您可以使用 |
Proposal.seller.subAccountId |
Proposal.publisherProfile
使用發布商個人資料名稱來識別賣方。您可以使用 |
Proposal.buyer.accountId |
所使用的欄位將視協商買家帳戶類型而定。這些是即時出價 API |
Proposal.billedBuyer.accountId |
Proposal.billedBuyer
這個資源名稱現在是指向買方帳戶的名稱,如同在即時出價 API 的 |
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 |
這個欄位已停用。 |
Proposal.isSetupComplete |
FinalizedDeal.readyToServe
現可透過 |
Proposal.lastUpdaterOrCommentorRole |
Proposal.lastUpdaterOrCommentorRole |
Proposal.notes.proposalRevision |
這個欄位已停用。 |
Proposal.notes.noteId |
這個欄位已停用。 |
Proposal.notes.createTime |
Proposal.notes.createTime |
Proposal.notes.creatorRole |
Proposal.notes.creatorRole |
Proposal.notes.note |
Proposal.notes.note |
Proposal.termsAndConditions |
Proposal.termsAndConditions |