মার্কেটপ্লেস API এ স্থানান্তর করুন

API সক্ষম করুন

অন্যান্য অনুমোদিত ক্রেতাদের API-এর মতো, আপনি এটি ব্যবহার করার আগে আপনাকে মার্কেটপ্লেস API সক্ষম করতে হবে। আপনি নিম্নলিখিত পদক্ষেপগুলি সহ মার্কেটপ্লেস API সক্ষম করতে পারেন:

  1. Google API কনসোল সক্ষম APIs পৃষ্ঠাতে যান। অন্যান্য অনুমোদিত ক্রেতা API, যেমন Ad Exchange Buyer II বা রিয়েল-টাইম বিডিং API অ্যাক্সেস করতে আপনি যে প্রকল্পটি ব্যবহার করেন সেটি নির্বাচন করুন।
  2. + APIS এবং পরিষেবাগুলি সক্ষম করুন লিঙ্কে ক্লিক করুন৷
  3. অনুসন্ধান বাক্সে, " অথরাইজড বায়ারস মার্কেটপ্লেস API " টাইপ করুন এবং এন্টার টিপুন।
  4. অনুসন্ধানের ফলাফলে, অনুমোদিত ক্রেতাদের মার্কেটপ্লেস API নির্বাচন করুন।
  5. মার্কেটপ্লেস এপিআই সক্ষম করতে ENABLE বোতামে ক্লিক করুন।
  6. আপনি এখন এই প্রকল্পের অধীনে তৈরি শংসাপত্র সহ মার্কেটপ্লেস API অ্যাক্সেস করতে সক্ষম হবেন।

আপনার OAuth 2.0 শংসাপত্র আপডেট করুন

Ad Exchange Buyer II API স্কোপের সাথে বিদ্যমান OAuth 2.0 ওয়ার্কফ্লোগুলিকে মার্কেটপ্লেস API স্কোপ ব্যবহার করতে পরিবর্তন করতে হবে:

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

আমরা API অ্যাক্সেস করতে পরিষেবা অ্যাকাউন্ট OAuth 2.0 ফ্লো ব্যবহার করার পরামর্শ দিই। সমস্ত সমর্থিত OAuth 2.0 ফ্লোকে অবশ্যই নতুন API স্কোপ নির্দিষ্ট করতে হবে যাতে Google থেকে একটি টোকেন অনুরোধ করতে পারে যা Marketplace API অ্যাক্সেস করতে পারে।

মার্কেটপ্লেস এপিআই-তে অ্যাড এক্সচেঞ্জ ক্রেতা II API সংস্থান ম্যাপিং

ক্লায়েন্ট

আপনি যদি Ad Exchange Buyer II API-এর accounts.clients রিসোর্স ব্যবহার করেন, তাহলে আপনি Marketplace API-এর buyers.clients রিসোর্সে স্থানান্তর করতে পারেন৷

সম্পদ পদ্ধতি

Ad Exchange Buyer II API মার্কেটপ্লেস 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 মার্কেটপ্লেস 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 Ad Exchange Buyer II API এর accounts.clients.invitations এবং accounts.clients.users সংস্থানগুলির কার্যকারিতাকে একটি একক buyers.clients.users সম্পদে একত্রিত করে৷

সম্পদ পদ্ধতি

Ad Exchange Buyer II API মার্কেটপ্লেস 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 মার্কেটপ্লেস 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

পণ্য

এই সংস্থান এবং এর কার্যকারিতা মার্কেটপ্লেস API-এ উপলব্ধ নেই৷

প্রকাশক প্রোফাইল

আপনি যদি Ad Exchange Buyer II API-এর accounts.publisherProfiles রিসোর্স ব্যবহার করেন, তাহলে আপনি Marketplace API-এর buyers.publisherProfiles রিসোর্সে স্থানান্তর করতে পারেন৷

সম্পদ পদ্ধতি

Ad Exchange Buyer II API মার্কেটপ্লেস API
accounts.publisherProfiles.get buyers.publisherProfiles.get
accounts.publisherProfiles.list buyers.publisherProfiles.list

এই পদ্ধতিটি এখন তালিকা ফিল্টার সমর্থন করে।

সম্পদ ক্ষেত্র

Ad Exchange Buyer II API মার্কেটপ্লেস 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

প্রস্তাবনা এবং চূড়ান্তকৃত প্রস্তাবনা

আপনি যদি Ad Exchange Buyer II API-এর accounts.proposals রিসোর্স ব্যবহার করেন, তাহলে আপনি Marketplace API-এর buyers.proposals রিসোর্সে স্থানান্তর করতে পারেন৷ buyers.proposals.deals প্রস্তাব থেকে ডিলগুলিকে আলাদা করা হয়েছে। চূড়ান্ত করা প্রস্তাবগুলি আর API-তে উপস্থাপন করা হয় না, যা আপনাকে buyers.finalizedDeals রিসোর্সের সাথে চূড়ান্ত করা ডিলের আরও দানাদার নিয়ন্ত্রণ দেয়।

সম্পদ পদ্ধতি

Ad Exchange Buyer II API মার্কেটপ্লেস 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 মার্কেটপ্লেস 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 একটি পুনরাবৃত্ত ক্ষেত্র, এটি কখনোই একক এন্ট্রির বেশি দিয়ে তৈরি করা হয়নি। ফলস্বরূপ, মার্কেটপ্লেস 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 কীটি মার্কেটপ্লেস 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