Marketplace API पर माइग्रेट करें

इस एपीआई को चालू करें

दूसरे Authorized Buyers की तरह API के लिए, आपको Marketplace API से पहले तो इसका इस्तेमाल किया जा सकता है. Marketplace API को चालू करने के लिए, यह तरीका अपनाएं:

  1. Google API कंसोल सक्षम एपीआई पर जाएं पेज पर जाएं. चुनें: ऐसा प्रोजेक्ट जिसका इस्तेमाल अन्य Authorized Buyers के एपीआई ऐक्सेस करने के लिए किया जाता है, जैसे Ad Exchange खरीदार II या रीयल-टाइम बिडिंग एपीआई.
  2. + एपीआई और सेवाएं चालू करें लिंक पर क्लिक करें.
  3. खोज बॉक्स में, "Authorized Buyers Marketplace API" टाइप करें और दबाएं Enter.
  4. खोज के नतीजों में, Authorized Buyers Marketplace एपीआई चुनें.
  5. Marketplace API को चालू करने के लिए, चालू करें बटन पर क्लिक करें.
  6. अब मार्केटप्लेस एपीआई को क्रेडेंशियल से ऐक्सेस किया जा सकता है को बनाया गया है.

अपने OAuth 2.0 क्रेडेंशियल अपडेट करना

Ad Exchange Buyer II एपीआई दायरे वाले मौजूदा OAuth 2.0 वर्कफ़्लो Marketplace API दायरे का इस्तेमाल करने के लिए बदला गया:

https://www.googleapis.com/auth/authorized-buyers-marketplace

हमारा सुझाव है कि आप सेवा खाते के OAuth 2.0 का इस्तेमाल करें फ़्लो का इस्तेमाल करें. काम करने वाले सभी OAuth 2.0 फ़्लो में, नए एपीआई की जानकारी होनी चाहिए इससे Google से उस टोकन का अनुरोध किया जा सकता है जो Marketplace API को ऐक्सेस कर सकता है.

Ad Exchange Buyer II एपीआई संसाधनों को Marketplace API में मैप करना

क्लाइंट

यदि आप Ad Exchange Buyer II API का उपयोग करते हैं accounts.clients संसाधन नहीं है, तो आप Marketplace API के buyers.clients संसाधन.

संसाधन के तरीके

Ad Exchange Buyer II एपीआई मार्केटप्लेस एपीआई
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 एपीआई मार्केटप्लेस एपीआई
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 संसाधन.

संसाधन के तरीके

Ad Exchange Buyer II एपीआई मार्केटप्लेस एपीआई
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

अब एपीआई की मदद से, क्लाइंट उपयोगकर्ताओं को पैच नहीं किया जा सकता. हमारा सुझाव है कि आप: कि आप का उपयोग करते हैं buyers.clients.users.delete को मिटाने के लिए और अपने हिसाब से बदलाव करके इसे फिर से बनाएं.

संसाधन फ़ील्ड

Ad Exchange Buyer II एपीआई मार्केटप्लेस एपीआई
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 संसाधन.

संसाधन के तरीके

Ad Exchange Buyer II एपीआई मार्केटप्लेस एपीआई
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

यह तरीका अब काम करता है सूची के लिए फ़िल्टर का इस्तेमाल करें.

संसाधन फ़ील्ड

Ad Exchange Buyer II एपीआई मार्केटप्लेस एपीआई
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 सब-रिसॉर्स. आखिरी प्रस्ताव अब एपीआई में नहीं दिखाया जाता. इससे ये काम किए जा सकते हैं आपको फ़ाइनल डील पर ज़्यादा कंट्रोल मिलेगा. buyers.finalizedDeals संसाधन.

संसाधन के तरीके

Ad Exchange Buyer II एपीआई मार्केटप्लेस एपीआई
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 पर काम करते हैं और माइग्रेशन के एक जैसे चरण हो सकते हैं.

Ad Exchange Buyer II एपीआई मार्केटप्लेस एपीआई
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 एक दोहराया गया फ़ील्ड, उसे कभी भी एक से ज़्यादा प्रविष्टि से पॉप्युलेट नहीं किया गया था. जैसे इसी वजह से, 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 Buyer 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.

इसमें इस्तेमाल किया जाने वाला फ़ील्ड, मोल-भाव करने वाले खाते के टाइप पर निर्भर करेगा खरीदार. ये रीयल-टाइम बिडिंग एपीआई में से किसी एक के संसाधन के नाम हैं buyers संसाधन या Marketplace API buyers.clients संसाधन.
Proposal.billedBuyer.accountId Proposal.billedBuyer

यह अब एक संसाधन का नाम है, जो इस तरह से खरीदार के खाते का हवाला देता है: रीयल-टाइम बिडिंग एपीआई के 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