এপিআই ওয়ার্কফ্লোস,এপিআই ওয়ার্কফ্লোস

একটি চুক্তি তৈরি করুন

1. external_deal_id ফিল্টার ব্যবহার করে LIST পণ্য দ্বারা ইতিমধ্যেই কোনও পণ্য তৈরি করা হয়েছে কিনা তা দেখুন। External_deal_id অবশ্যই সমস্ত পণ্যের জন্য অনন্য হতে হবে।

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. অর্ডার তৈরি করুন । নামটি DV3 দ্বারা তৈরি করা হয়, এবং আমরা আপনাকে ভবিষ্যতে পুনরুদ্ধারের জন্য আপনার সিস্টেমে কোথাও এই আইডিটি সংরক্ষণ করার পরামর্শ দিচ্ছি।

3. অর্ডার এর অধীনে পণ্য তৈরি করুন । পণ্যের নাম DV3 দ্বারা তৈরি করা হয়, এবং আমরা আপনাকে ভবিষ্যতে পুনরুদ্ধারের জন্য আপনার সিস্টেমে কোথাও এই আইডিটি সংরক্ষণ করার পরামর্শ দিচ্ছি।

   বিকল্পভাবে, আপনি সর্বদা external_deal_id দিয়ে LIST করতে পারেন। নামের ক্ষেত্রে অর্ডার আইডি এবং পণ্য আইডি উভয়ই রয়েছে, তাই আপনি সহজেই এইভাবে মূল ব্যক্তিকে সনাক্ত করতে পারেন।

একটি চুক্তি বাতিল করুন

1. অর্ডারের অবস্থা বাতিল করা হয়েছে শুধুমাত্র বাতিল করা হয়েছে। অর্ডার গ্রহণ না করা হলে বাতিল করা সমর্থন করে। বাতিল করা একটি চূড়ান্ত অবস্থা। একবার বাতিল হয়ে গেলে অর্ডার পুনরায় সক্রিয় করা যাবে না।

একটি চুক্তির বিশদ বিবরণ পান

1. অর্ডারের বিস্তারিত তথ্য পান। ব্যবহারকারী অর্ডার গ্রহণ, সংরক্ষণাগারভুক্ত বা বাতিল করার পরেই স্ট্যাটাস আপডেট হয়ে যায়।
2. পণ্যের বিস্তারিত তথ্য পান ।

ডিলের একটি তালিকা পান

1. সমস্ত গৃহীত/মুলতুবি থাকা গ্রহণযোগ্যতা অর্ডার পেতে একটি স্ট্যাটাস ফিল্টার সহ অর্ডার তালিকাভুক্ত করুন ।
2. external_deal_id ফিল্টার সহ পণ্যগুলির তালিকা করুন ।
3. একটি অর্ডারের মধ্যে সমস্ত পণ্য তালিকাভুক্ত করুন ।

একটি চুক্তি আপডেট করুন

1. প্রকাশকের যোগাযোগের তথ্যের জন্য অর্ডার আপডেট করুন ।
   1. নাম, আপডেটের অনুমতি দেয় না (ক্ষেত্র_মাস্কে সেট করা যাবে না)। স্থিতি শুধুমাত্র API এর মাধ্যমে বাতিল করাতে সেট করার অনুমতি দেয়।
   2. partner_id আপডেটের অনুমতি দেয় না ।
2. নির্দিষ্ট চুক্তির মেয়াদ আপডেটের জন্য পণ্য আপডেট করুন ।
   1. নাম, বহিরাগত চুক্তি আইডি, লেনদেনের ধরণ, মূল্যের ধরণ, আপডেটের সময় আপডেট করা যাবে না ।
   2. displayName আপডেট করার জন্য ব্যবহারকারীর সম্মতির প্রয়োজন নেই।
   3. আপডেট রেটবিস্তারিত, creativeConfig পরিবর্তনের মূল অর্ডারের অবস্থাকে মুলতুবি গ্রহণযোগ্যতায় পরিণত করবে। DV3 বিজ্ঞাপনদাতাদের আলোচনার পৃষ্ঠায় নতুন শব্দটি গ্রহণ করতে বলা হবে, পূর্ববর্তী অর্ডারটি গৃহীত হয়েছে কিনা তা নির্বিশেষে।

ব্যবহারকারী চুক্তিটি গ্রহণ করেছেন কিনা তা দেখুন।

1. যদি আপনি সংশ্লিষ্ট অর্ডার আইডি জানেন তাহলে অর্ডার পান । স্ট্যাটাস ফিল্ডটি পরীক্ষা করুন।
2. যদি অর্ডার আইডি ট্র্যাক না করা থাকে: external_deal_id ফিল্টার দিয়ে পণ্য তালিকাভুক্ত করুন , পণ্যের নাম থেকে অর্ডারের নাম বের করুন , এবং তারপর অর্ডার পান । স্ট্যাটাস ক্ষেত্রটি পরীক্ষা করুন।

ব্যবহারকারী চুক্তিটি কনফিগার করেছেন কিনা তা দেখুন (শুধুমাত্র পিজি-র জন্য)

1. ইনভেন্টরি সোর্স পান। নাম 'exchanges/{exchangeId}/inventorysources/{external_deal_id}'। ক্রেতার অবস্থা পরীক্ষা করুন।
   1. রিজার্ভেশন ডিল
      1. BUYER_STATUS_ACTIVE মানে একটি চুক্তি গৃহীত এবং কনফিগার করা হয়েছে। DV3 যখন চুক্তির শর্তাবলীর সাথে মেলে এমন বিড অনুরোধ পায় তখন ডিলটি এই অবস্থায় ব্যয় করা হবে বলে আশা করা হচ্ছে। ডিল কনফিগারেশন ধাপের সময় একটি লাইন আইটেম স্বয়ংক্রিয়ভাবে তৈরি হয়। আরও বিস্তারিত জানার জন্য ডিল কনফিগারেশন দেখুন।
      2. BUYER_STATUS_PENDING মানে অর্ডার গৃহীত হয়েছে, কিন্তু চুক্তি এখনও কনফিগার করা হয়নি। এই অবস্থায় কোনও খরচ হবে না।
      3. BUYER_STATUS_PAUSED অর্থ হল বিজ্ঞাপনদাতারা ডিলটি স্পষ্টভাবে স্থগিত করেছেন। এই অবস্থায় কোনও খরচ হবে না।
   2. রিজার্ভেশনবিহীন ডিল
      1. BUYER_STATUS_ACTIVE মানে একটি চুক্তি গৃহীত হয়েছে। যখন DV3 চুক্তির শর্তাবলীর সাথে মেলে এমন বিড অনুরোধ পায় এবং এই চুক্তিকে লক্ষ্য করে একটি সক্রিয় লাইন আইটেম থাকে এবং বিড অনুরোধটি লাইন আইটেম লক্ষ্য করার মানদণ্ডের সাথে মেলে তখন ডিলটি এই অবস্থায় ব্যয় করবে বলে আশা করা হচ্ছে। আরও বিস্তারিত জানার জন্য লাইন আইটেম দেখুন।** লাইন আইটেম দ্বারা কোনও চুক্তি লক্ষ্য করা হয়েছে কিনা তা অনুসন্ধান করার জন্য কোনও বিক্রেতা API নেই। **
      2. BUYER_STATUS_PENDING প্রযোজ্য নয়।
      3. BUYER_STATUS_PAUSED অর্থ হল বিজ্ঞাপনদাতারা ডিলটি স্পষ্টভাবে স্থগিত করেছেন। এই অবস্থায় কোনও খরচ হবে না।

গ্রহণের পরে কোনও চুক্তি বিরতি/আনপজ করুন

1. ইনভেন্টরি সোর্স বিক্রেতার অবস্থা আপডেট করুন ।
   1. বিরতি/বিরতিমুক্তকরণ চুক্তি পরিবেশনের উপর প্রভাব ফেলে না। বিক্রেতা যদি কোনও চুক্তি বিরতি দেন, তাহলে বিজ্ঞাপনদাতাদের কেবল FYI হিসেবে একটি স্ট্রিং বার্তা দেখানো হবে। এটি বিজ্ঞাপনদাতাকে একটি অ-ব্যয় চুক্তির সমস্যা সমাধানে সহায়তা করবে।

পুনঃআলোচনা (গ্রহণ করার পরে চুক্তি আপডেট করুন)

পুনঃআলোচনা বলতে ক্রেতা কর্তৃক গৃহীত হওয়ার পর কোনও চুক্তিতে করা আপডেটগুলিকে বোঝায়। গৃহীত চুক্তিতে নতুন পরিবর্তন আনার জন্য এটি এক্সচেঞ্জ এবং ক্রেতা উভয়ের জন্যই খুবই কার্যকর হতে পারে। উদাহরণস্বরূপ, এক্সচেঞ্জ দেখতে পারে যে একটি গৃহীত চুক্তির জন্য চুক্তির শেষ সময় সঠিক নয় এবং যদি চুক্তিটি এখনও শুরু না হয় তবে এক্সচেঞ্জ DV3 ক্রেতাদের কাছে আপডেটগুলি পৌঁছে দেওয়ার জন্য DV3 আপডেট পণ্য ব্যবহার করতে পারে।

কোন পরিবর্তনগুলি অনুমোদিত এবং কোনগুলি নিষিদ্ধ।

বিভিন্ন চুক্তি পর্যায়ে অনুমোদিত এবং অননুমোদিত পরিবর্তনগুলির জন্য এখানে দেখুন।