หน้านี้ได้รับการแปลโดย Cloud Translation API

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

เปิดใช้ 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` วิธีนี้รองรับการอัปเดตบางส่วนด้วยพารามิเตอร์ `updateMask` แล้ว

ช่องข้อมูลของทรัพยากร

API ผู้ซื้อของ Ad Exchange II	API ตลาดกลาง
`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 รวมฟังก์ชันการทำงานของทรัพยากร 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` เฉพาะผู้ใช้ที่ตั้งค่า `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 ตลาดกลาง
`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

หากคุณใช้ทรัพยากร 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` `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`

ข้อเสนอและข้อเสนอที่สรุปผลแล้ว

หากคุณใช้ทรัพยากร accounts.proposals ของ Ad Exchange Buyer II API คุณสามารถย้ายข้อมูลไปยังทรัพยากร buyers.proposals ของ Marketplace API ได้ ระบบแยกดีลออกจากข้อเสนอลงในทรัพยากรย่อยของ buyers.proposals.deals แล้ว ข้อเสนอที่สรุปผลแล้วจะไม่แสดงใน API อีกต่อไป คุณจึงควบคุมดีลที่สรุปผลแล้วได้ละเอียดยิ่งขึ้นด้วยทรัพยากร buyers.finalizedDeals

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

API ผู้ซื้อของ Ad Exchange II	API ตลาดกลาง
`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 ตลาดกลาง
`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 รายการ ด้วยเหตุนี้ `programmaticGuaranteedTerms.fixedPrice` ของ Marketplace API จึงเทียบเท่ากัน
`Proposal.deals.dealTerms.nonGuaranteedFixedPriceTerms`	`Deal.preferredDealTerms` โปรดทราบว่าแม้ `nonGuaranteedFixedPriceTerms.fixedPrices` จะเป็นช่องที่ซ้ำ แต่ก็ไม่เคยมีการป้อนข้อมูลมากกว่า 1 รายการ ด้วยเหตุนี้ `preferredDealTerms.fixedPrice` ของ Marketplace API จึงเทียบเท่ากัน
`Proposal.deals.dealTerms.NonGuaranteedAuctionTerms`	`Deal.privateAuctionTerms` โปรดทราบว่าแม้ `nonGuaranteedAuctionTerms.reservePricesPerBuyer` จะเป็นช่องที่ซ้ำ แต่ก็ไม่เคยมีการป้อนข้อมูลมากกว่า 1 รายการ ด้วยเหตุนี้ `privateAuctionTerms.floorPrice` ของ Marketplace API จึงเทียบเท่ากัน
`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 Buyer II อ้างอิงถึง 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` ช่องที่ใช้จะขึ้นอยู่กับประเภทบัญชีของผู้ซื้อที่เจรจาต่อรอง ชื่อเหล่านี้เป็นชื่อทรัพยากรของทรัพยากร `buyers` API การเสนอราคาแบบเรียลไทม์ หรือทรัพยากร Marketplace API `buyers.clients` ตามลำดับ
`Proposal.billedBuyer.accountId`	`Proposal.billedBuyer` ชื่อนี้คือชื่อทรัพยากรที่อ้างถึงบัญชีผู้ซื้อตามที่แสดงในทรัพยากร `buyers` ของ Real-time Bidding 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`