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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. প্রকাশকের যোগাযোগের তথ্যের জন্য অর্ডার আপডেট করুন ।
   1. নাম, আপডেটের অনুমতি দেয় না (ক্ষেত্র_মাস্কে সেট করা যাবে না)। স্থিতি শুধুমাত্র API এর মাধ্যমে বাতিল করা সেট করার অনুমতি দেয়।
   2. পার্টনার_আইডি আপডেট করার অনুমতি দেয় না ।
2. একটি নির্দিষ্ট চুক্তি মেয়াদ আপডেটের জন্য পণ্য আপডেট করুন ।
   1. নাম, externalDealId, transactionType, pricingType, updateTime আপডেট করা যাবে না ।
   2. ডিসপ্লেনাম আপডেট করার জন্য ব্যবহারকারীর স্বীকৃতির প্রয়োজন নেই।
   3. রেট ডিটেইলস আপডেট করুন, ক্রিয়েটিভ কনফিগ প্যারেন্ট অর্ডার স্ট্যাটাস পেন্ডিং অ্যাকসেপ্টেন্সে পরিবর্তন করবে। 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 ক্রেতাদের কাছে আপডেট পাঠাতে পারে।

কি পরিবর্তন অনুমোদিত এবং অননুমোদিত.

আমরা কিছু পরিবেশন করা গুরুত্বপূর্ণ ক্ষেত্রগুলি ব্যতীত সমস্ত ক্ষেত্রে পরিবর্তনের অনুমতি দিই যেমন: startTime , endTime , rateDetails , creativeConfig এবং ইত্যাদি। সাধারণভাবে বলতে গেলে, creativeConfig ব্যতীত এই ক্ষেত্রগুলির আপডেটগুলি অনুমোদিত হয় যদি ভবিষ্যতে চুক্তির শুরুর সময় কমপক্ষে 1 দিন পরে হয়৷ ফ্লাইট ডিলের জন্য শুধুমাত্র বর্ধিত আপডেটগুলি অনুমোদিত, যার মধ্যে শুরুর সময় অতীতে কিন্তু শেষ সময় ভবিষ্যতে। সম্পূর্ণ ডিলের জন্য কোন পরিবর্তন অনুমোদিত নয়, যার শেষ সময় অতীতে। উদাহরণস্বরূপ, এক বছর আগে সম্পন্ন করা চুক্তির rateDetails আপডেট করার অনুমতি নেই। এই ধরনের ক্ষেত্রে, DV3 আপডেট পণ্য যাচাইকরণ ত্রুটি নিক্ষেপ করবে।