เปิดใช้ API
เช่นเดียวกับ API ของ Authorized Buyers อื่นๆ คุณจะต้องเปิดใช้ Marketplace API ก่อนจึงจะใช้งานได้ คุณเปิดใช้ Marketplace API ได้โดยทำตามขั้นตอนต่อไปนี้
- ไปที่หน้า API ที่เปิดใช้คอนโซล Google 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
เวิร์กโฟลว์ OAuth 2.0 ที่มีอยู่ซึ่งมีขอบเขต API ผู้ซื้อของ Ad Exchange II ต้องเปลี่ยนไปใช้ขอบเขต Marketplace API ดังนี้
https://www.googleapis.com/auth/authorized-buyers-marketplace
เราขอแนะนำให้ใช้ขั้นตอน Service Account OAuth 2.0 เพื่อเข้าถึง API ขั้นตอน OAuth 2.0 ที่รองรับทั้งหมดต้องระบุขอบเขต API ใหม่เพื่อขอโทเค็นจาก Google ที่เข้าถึง Marketplace API ได้
การแมปทรัพยากร Ad Exchange Buyer II API กับ Marketplace API
ในนามของลูกค้า
หากคุณใช้ทรัพยากร accounts.clients
ของ Ad Exchange Buyer II API คุณสามารถย้ายข้อมูลไปยังทรัพยากร buyers.clients
ของ Marketplace API ได้
วิธีการของแหล่งข้อมูล
API ผู้ซื้อของ Ad Exchange II | 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
วิธีนี้รองรับการอัปเดตบางส่วนด้วยพารามิเตอร์ |
ช่องข้อมูลของทรัพยากร
API ผู้ซื้อของ Ad Exchange II | 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 รวมฟังก์ชันการทำงานของทรัพยากร accounts.clients.invitations
และ accounts.clients.users
ของ Ad Exchange Buyer II API เข้าด้วยกันเป็นทรัพยากร buyers.clients.users
แหล่งเดียว
วิธีการของแหล่งข้อมูล
API ผู้ซื้อของ Ad Exchange II | 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 ได้อีกต่อไป เราขอแนะนำให้คุณใช้
|
ช่องข้อมูลของทรัพยากร
API ผู้ซื้อของ Ad Exchange II | 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
หากคุณใช้ทรัพยากร accounts.publisherProfiles
ของ Ad Exchange Buyer II API คุณสามารถย้ายข้อมูลไปยังทรัพยากร buyers.publisherProfiles
ของ Marketplace API ได้
วิธีการของแหล่งข้อมูล
API ผู้ซื้อของ Ad Exchange II | API ตลาดกลาง |
---|---|
accounts.publisherProfiles.get |
buyers.publisherProfiles.get |
accounts.publisherProfiles.list |
buyers.publisherProfiles.list
วิธีนี้รองรับตัวกรองรายการแล้วในตอนนี้ |
ช่องข้อมูลของทรัพยากร
API ผู้ซื้อของ Ad Exchange II | 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 |
ข้อเสนอและข้อเสนอที่สรุปผลแล้ว
หากคุณใช้ทรัพยากร accounts.proposals
ของ Ad Exchange Buyer II API คุณสามารถย้ายข้อมูลไปยังทรัพยากร buyers.proposals
ของ Marketplace API ได้ ระบบแยกดีลออกจากข้อเสนอลงในทรัพยากรย่อยของ buyers.proposals.deals
แล้ว ข้อเสนอที่สรุปผลแล้วจะไม่แสดงใน API อีกต่อไป คุณจึงควบคุมดีลที่สรุปผลแล้วได้ละเอียดยิ่งขึ้นด้วยทรัพยากร buyers.finalizedDeals
วิธีการของแหล่งข้อมูล
ช่องข้อมูลของทรัพยากร
ทรัพยากร proposals
และ finalizedProposals
เป็นตัวแทน Proposal
เดียวกันและมีขั้นตอนการย้ายข้อมูลที่คล้ายกัน
API ผู้ซื้อของ Ad Exchange II | 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 |
ช่องที่ใช้จะขึ้นอยู่กับประเภทบัญชีของผู้ซื้อที่เจรจาต่อรอง ชื่อเหล่านี้เป็นชื่อทรัพยากรของทรัพยากร |
Proposal.billedBuyer.accountId |
Proposal.billedBuyer
ชื่อนี้คือชื่อทรัพยากรที่อ้างถึงบัญชีผู้ซื้อตามที่แสดงในทรัพยากร |
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 |