ย้ายข้อมูลไปยัง Marketplace API

เปิดใช้ API

คล้ายกับของ Authorized Buyers รายอื่นๆ API คุณต้องเปิดใช้ Marketplace API ก่อน ก็ใช้งานได้เลย คุณเปิดใช้ Marketplace API ได้โดยทำตามขั้นตอนต่อไปนี้

  1. ไปที่ API ที่เปิดใช้งานคอนโซล Google API เลือก โปรเจ็กต์ที่คุณใช้เพื่อเข้าถึง Authorized Buyers API อื่นๆ เช่น ผู้ซื้อ Ad Exchange II หรือ Real-time Bidding API
  2. คลิกลิงก์ + เปิดใช้ API และบริการ
  3. ในช่องค้นหา ให้พิมพ์ "Authorized Buyers Marketplace API" แล้วกด Enter
  4. ในผลการค้นหา ให้เลือก Authorized Buyers Marketplace API
  5. คลิกปุ่มเปิดใช้เพื่อเปิดใช้ Marketplace API
  6. ตอนนี้คุณควรเข้าถึง Marketplace API ด้วยข้อมูลเข้าสู่ระบบได้แล้ว ที่สร้างขึ้นภายใต้โปรเจ็กต์นี้

อัปเดตข้อมูลเข้าสู่ระบบ OAuth 2.0

เวิร์กโฟลว์ OAuth 2.0 ที่มีอยู่และมีขอบเขต Ad Exchange Buyer II API จะต้อง เปลี่ยนไปใช้ขอบเขต API ของ Marketplace:

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 ทรัพยากร

วิธีการสำหรับแหล่งข้อมูล

API ผู้ซื้อ Ad Exchange II API สำหรับ Marketplace
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

ช่องทรัพยากร

API ผู้ซื้อ Ad Exchange II API สำหรับ Marketplace
Client.clientAccountId Client.name

clientAccountId คือรหัสทรัพยากรไคลเอ็นต์
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 ทรัพยากร

วิธีการสำหรับแหล่งข้อมูล

API ผู้ซื้อ Ad Exchange 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

เฉพาะผู้ใช้ที่ตั้งค่า 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 เพื่อลบ ผู้ใช้ของลูกค้า แล้วสร้างใหม่ด้วยการเปลี่ยนแปลงที่ต้องการ

ช่องทรัพยากร

API ผู้ซื้อ Ad Exchange II API สำหรับ Marketplace
ClientUserInvitation.invitationId

ฟิลด์นี้เลิกใช้งานแล้ว
ClientUserInvitation.email ClientUser.email
ClientUserInvitation.clientAccountId

ไม่มีช่องนี้สำหรับผู้ใช้ของลูกค้าแล้ว โปรดดู clientAccountId ในชื่อไคลเอ็นต์หลัก
ClientUser.userId ClientUser.name

userId คือรหัสทรัพยากรของผู้ใช้
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 ทรัพยากร

วิธีการสำหรับแหล่งข้อมูล

API ผู้ซื้อ Ad Exchange II API สำหรับ Marketplace
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

ตอนนี้เมธอดนี้รองรับ ตัวกรองรายการ

ช่องทรัพยากร

API ผู้ซื้อ Ad Exchange II API สำหรับ Marketplace
PublisherProfile.publisherProfileId PublisherProfile.name

publisherProfileId เป็นทรัพยากรของโปรไฟล์ผู้เผยแพร่โฆษณา ID
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 ทรัพยากร

วิธีการสำหรับแหล่งข้อมูล

API ผู้ซื้อ Ad Exchange II API สำหรับ Marketplace
accounts.proposals.accept buyers.proposals.accept

เรียกใช้ buyers.proposals.accept เฉพาะเมื่อสถานะของข้อเสนอคือ 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

โปรดทราบว่าข้อเสนอจะไม่มีข้อมูลเกี่ยวกับดีลอีกต่อไป

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 เดียวกัน และมีขั้นตอนการย้ายข้อมูล ที่คล้ายกัน

API ผู้ซื้อ Ad Exchange II API สำหรับ Marketplace
Proposal.proposalId Proposal.name

proposalId คือรหัสทรัพยากรข้อเสนอ
Proposal.updateTime Proposal.updateTime
Proposal.proposalRevision

Proposal.proposalRevision และ วันที่ Deal.proposalRevision
Proposal.deals.dealId Deal.name

dealId คือรหัสทรัพยากรของดีล
Proposal.deals.proposalId Deal.name

proposalId คือรหัสทรัพยากรข้อเสนอระดับบนสุด
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 จะเป็น ที่ซ้ำได้ ไม่ได้มีการป้อนข้อมูลมากกว่า 1 รายการ อาส API ของ Marketplace programmaticGuaranteedTerms.fixedPrice เทียบเท่ากับ
Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms

Deal.preferredDealTerms

โปรดทราบว่าแม้ว่า nonGuaranteedFixedPriceTerms.fixedPrices จะ ลงในฟิลด์ที่ซ้ำได้ โดยไม่มีการป้อนข้อมูลมากกว่า 1 รายการ ดังนั้น API ของ Marketplace preferredDealTerms.fixedPrice เทียบเท่ากับ
Proposal.deals.dealTerms.NonGuaranteedAuctionTerms

Deal.privateAuctionTerms

โปรดทราบว่าแม้ว่า nonGuaranteedAuctionTerms.reservePricesPerBuyer เป็น ที่ซ้ำได้ ไม่ได้มีการป้อนข้อมูลมากกว่า 1 รายการ อาส API ของ Marketplace 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 ตัวอย่างเช่น พารามิเตอร์ GOOG_CREATIVE_SIZE คีย์จากผู้ซื้อ Ad Exchange II หมายถึง API ของ Marketplace 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

ฟิลด์ที่ใช้จะขึ้นอยู่กับประเภทบัญชีของการเจรจาต่อรอง ผู้ซื้อ ชื่อเหล่านี้เป็นชื่อทรัพยากรของ Real-time Bidding API ทรัพยากร buyers หรือ Marketplace API buyers.clients ทรัพยากรตามลำดับ
Proposal.billedBuyer.accountId Proposal.billedBuyer

ขณะนี้เป็นชื่อทรัพยากรที่อ้างถึงบัญชีผู้ซื้อเป็น แสดงอยู่ในbuyersของ 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

เข้าถึงแบบละเอียดยิ่งขึ้นด้วย 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