啟用 API
與其他 Authorized Buyers API 一樣,您必須先啟用 Marketplace API 才能使用該 API。您可以按照下列步驟啟用 Marketplace API:
- 前往「Google API 控制台已啟用的 API」頁面。選取要用來存取其他 Authorized Buyers API 的專案,例如 Ad Exchange Buyer II 或 即時出價 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 |