遷移至 Marketplace API

啟用 API

與其他 Authorized Buyers 相似API 時，您必須啟用 Marketplace API 。您可以按照下列步驟啟用 Marketplace API：

  1. 前往已啟用 Google API 控制台的 API 頁面。選取 其他 Authorized Buyers API 專案，例如 Ad Exchange 買方 II 或 即時出價 API：
  2. 按一下「+ 啟用 API 和服務」連結。
  3. 在搜尋框中輸入「Authorized Buyers Marketplace API」，然後按下 Enter 鍵。
  4. 在搜尋結果中，選取「Authorized Buyers Marketplace API」。
  5. 按一下「啟用」按鈕啟用 Marketplace API。
  6. 您現在應該可以使用憑證存取 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 範圍，要求取得可存取 Marketplace API 的 Google 權杖。

將 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

這個方法現在支援使用 updateMask 參數。

資源欄位

Ad Exchange Buyer II API Marketplace API
Client.clientAccountId Client.name

clientAccountId 是用戶端資源 ID。
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

邀請與位使用者

市集 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

只有state設為「INVITED」的使用者 與 accounts.clients.invitations.list。

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

您無法再透過 API 修補用戶端使用者。建議做法 您使用 buyers.clients.users.delete 刪除 並以所需的變更重新建立。

資源欄位

Ad Exchange Buyer II API Marketplace API
ClientUserInvitation.invitationId

這個欄位已停用。
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

客戶使用者已無法再使用這個欄位。只要查看 clientAccountId。
ClientUser.userId ClientUser.name

userId 是使用者資源 ID。
ClientUser.clientAccountId

客戶使用者已無法再使用這個欄位。只要查看 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

publisherProfileId 是發布商簡介資源 編號。
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

提案與FinalizedProposals

如果您使用 Ad Exchange Buyer II API 的 accounts.proposals敬上 您可以遷移至 Marketplace API buyers.proposals。 資源。交易已經與提案區隔 buyers.proposals.deals敬上 子資源。API 中不會再顯示敲定的提案，因此 想要更精細地控管敲定交易 buyers.finalizedDeals敬上 資源。

資源方法

Ad Exchange Buyer II API Marketplace API
accounts.proposals.accept buyers.proposals.accept

只在提案狀態為 BUYER_ACCEPTANCE_REQUESTED 時呼叫 buyers.proposals.accept。
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

請注意，提案不會再包含交易相關資訊。

accounts.proposals.list buyers.proposals.list

請注意，傳回的提案將不再包含資訊 提供特惠資訊請注意，如果您使用清單篩選功能，則只有 Marketplace API 支援 清單篩選器語法。
accounts.proposals.pause buyers.finalizedDeals.pause
accounts.proposals.resume buyers.finalizedDeals.resume
accounts.proposals.update buyers.proposals.patch

這個方法現在支援使用 updateMask 參數。
accounts.finalizedProposals.list

使用 buyers.finalizedDeals.list即可查看敲定的交易 建立特定買方帳戶的帳單您現在可以擷取敲定的交易 於出價工具層級提供 bidders.finalizedDeals.list。
accounts.finalizedProposals.pause

使用 buyers.finalizedDeals.pause：暫停個別帳戶 特定買方帳戶的交易。
accounts.finalizedProposals.resume

使用 buyers.finalizedDeals.resume恢復個人資格 特定買方帳戶的交易。

資源欄位

proposals 和 finalizedProposals 資源共用相同的Proposal 且有類似的遷移步驟

Ad Exchange Buyer II API Marketplace API
Proposal.proposalId Proposal.name

proposalId 是提案資源 ID。
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

「Proposal.proposalRevision」和 Deal.proposalRevision
Proposal.deals.dealId Deal.name

dealId 是交易資源 ID。
Proposal.deals.proposalId Deal.name

proposalId 是父項提案資源 ID。
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

Deal.programmaticGuaranteedTerms

請注意，guaranteedFixedPriceTerms.fixedPrices 是 重複欄位，則一律不會填入超過一個項目。阿斯 因此 Marketplace API 的 programmaticGuaranteedTerms.fixedPrice 等於。
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

請注意，nonGuaranteedFixedPriceTerms.fixedPrices 重複欄位，則一律不會填入超過一個項目。 因此 Marketplace API 的 preferredDealTerms.fixedPrice 等於。
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

請注意， nonGuaranteedAuctionTerms.reservePricesPerBuyer是 重複欄位，則一律不會填入超過一個項目。阿斯 因此 Marketplace API 的 privateAuctionTerms.floorPrice 等於。
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

您無法再使用鍵來設定指定目標， 決定指定類別不過 可在 Deal.targeting 中找到舉例來說， Ad Exchange 買方 II 的 GOOG_CREATIVE_SIZE 鍵是指 Marketplace API Deal.targeting.inventorySizeTargeting。
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

如需類似資訊，請前往 「FinalizedDeal.dealPausingInfo」欄位。
Proposal.deals.programmaticCreativeSource Deal.creativeRequirements.programmaticCreativeSource
Proposal.deals.deliveryControl Deal.deliveryControl

有關交易新增方式的其他詳細資料。
Proposal.deals.isSetupComplete FinalizedDeal.readyToServe

您現在只能表示交易已可放送 最終定案。使用「buyers.finalizedDeals.setReadyToServe」 表示您已敲定的程式輔助保證交易 隨時可供放送
Proposal.originatorRole Proposal.originatorRole
Proposal.seller.accountId Proposal.publisherProfile

使用發布商簡介名稱來識別賣方。你可以查看 包含 buyers.publisherProfiles 的發布商簡介 資源。
Proposal.seller.subAccountId Proposal.publisherProfile

使用發布商簡介名稱來識別賣方。你可以查看 包含 buyers.publisherProfiles 的發布商簡介 資源。
Proposal.buyer.accountId

Proposal.buyer 或 Proposal.client。

使用的欄位視協議的帳戶類型而定 買方。這些是即時出價 API 的資源名稱 buyers 項資源或 Marketplace API buyers.clients 資源。
Proposal.billedBuyer.accountId Proposal.billedBuyer

這現在稱為買家帳戶的資源名稱，也就是 在即時出價 API 的 buyers 中表示 資源。
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

現在可以使用 buyers.finalizedDeals 以更精細的方式存取帳戶。

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