REST Resource: exchanges.orders

• সম্পদ: অর্ডার
  • JSON উপস্থাপনা
• বাজেট
  • JSON উপস্থাপনা
• বাজেট প্রকার
• অর্ডারের অবস্থা
• WSeatConfig
  • JSON উপস্থাপনা
• WSeatStatus
• ক্রেতার তথ্য
  • JSON উপস্থাপনা
• পার্টনারইনফো
  • JSON উপস্থাপনা
• বিজ্ঞাপনদাতার তথ্য
  • JSON উপস্থাপনা
• পদ্ধতি

সম্পদ: অর্ডার

ক্রেতার গ্রহণ করার জন্য একটি অনমনীয় প্রস্তাব।

JSON উপস্থাপনা
{ "name": string, "displayName": string, "partnerId": [ string ], "publisherEmail": string, "publisherName": string, "budget": { object (Budget) }, "status": enum (OrderStatus), "wseatConfig": { object (WSeatConfig) }, "updateTime": string, "buyerInfo": { object (BuyerInfo) } }

ক্ষেত্র
name	string অর্ডারের জন্য আপেক্ষিক রিসোর্স নাম। সার্ভার দ্বারা তৈরি। উদাহরণ: "exchanges/1234/orders/5678"। শুধুমাত্র আউটপুট।
displayName	string ক্রেতার কাছে অর্ডারের নাম প্রদর্শিত হবে। সর্বোচ্চ ২৫০ অক্ষর। ঐচ্ছিক।
partnerId[]	string ( int64 format) Google Display & Video 360-এ (যা পূর্বে Doubleclick Bid Manager বা DBM নামে পরিচিত ছিল) পার্টনার আইডি। শুধুমাত্র একটি পার্টনার আইডি অনুমোদিত। আবশ্যক।
publisherEmail	string প্রকাশকের জন্য ইমেল। অবশ্যই বৈধ ইমেল ফরম্যাট হতে হবে। সর্বোচ্চ ২৫০ অক্ষর। ঐচ্ছিক।
publisherName	string প্রকাশকের নাম। সর্বোচ্চ ২৫০ অক্ষর। আবশ্যক।
budget	object ( Budget ) শুধুমাত্র আউটপুট। ক্রেতা কর্তৃক নির্ধারিত বাজেট। শুধুমাত্র ইনস্ট্যান্ট ডিল সিনারিও-র ক্ষেত্রে প্রযোজ্য।
status	enum ( OrderStatus ) অর্ডারের অবস্থা। DV3 ব্যবহারকারীরা কোনো অর্ডার গ্রহণ, বাতিল বা আর্কাইভ করার পর স্ট্যাটাস পরিবর্তিত হতে পারে। এছাড়াও, API-তে অর্ডারটি তৈরি হওয়ার পর এটিকে 'CANCELLED'-এ আপডেট করার সুবিধা রয়েছে, যা নির্দেশ করে যে অর্ডারটি Exchange-এ বাতিল করা হয়েছে।
wseatConfig	object ( WSeatConfig ) ঐচ্ছিক। WSeat কনফিগারেশন এক্সচেঞ্জ সাইডের WSeat কনফিগারেশন নির্দিষ্ট করে। যেসব এক্সচেঞ্জ মাল্টি-সিট ডিল ব্যবহার করে, তাদের এই ফিল্ডটি পূরণ করে হালনাগাদ রাখতে হবে।
updateTime	string ( Timestamp format) শুধুমাত্র আউটপুট। অর্ডার বা এর অন্তর্ভুক্ত পণ্যগুলো কখন আপডেট করা হয়েছিল, তার টাইমস্ট্যাম্প। RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।
buyerInfo	object ( BuyerInfo ) শুধুমাত্র আউটপুট। ক্রেতার তথ্য, যার মধ্যে অংশীদার এবং বিজ্ঞাপনদাতার বিবরণ অন্তর্ভুক্ত। শুধুমাত্র ইনস্ট্যান্ট ডিল সিনারিওগুলির জন্য প্রযোজ্য।

বাজেট

বাজেট নির্দিষ্ট করা হয়েছে।

JSON উপস্থাপনা
{ "budgetType": enum (BudgetType), // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "impressions": string, "money": { object (Money) } // End of mutually exclusive fields. }

ক্ষেত্র
budgetType	enum ( BudgetType ) নির্দিষ্ট বাজেট প্রকার।
শুধুমাত্র এক ধরনের বাজেট অন্তর্ভুক্ত করা যাবে। নিচে পারস্পরিকভাবে বর্জনীয় ফিল্ডগুলোর একটি তালিকা দেওয়া হলো। একটি উত্তরে এই ফিল্ডগুলোর মধ্যে সর্বাধিক একটি সেট করা হবে:
impressions	string ( int64 format) ইমপ্রেশন বাজেট।
money	object ( Money ) মুদ্রা বাজেট।
পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

বাজেট প্রকার

বাজেটের প্রকারভেদ

এনাম
BUDGET_TYPE_UNSPECIFIED	অনির্দিষ্ট বাজেট। ইনপুটের জন্য বৈধ নয়।
BUDGET_TYPE_CURRENCY	মুদ্রা বাজেট।
BUDGET_TYPE_IMPRESSION	ইমপ্রেশন বাজেট।

অর্ডারের অবস্থা

অর্ডারের অবস্থা।

এনাম
ORDER_STATUS_UNSPECIFIED	অর্ডারের অবস্থা অনির্দিষ্ট। এটি অপ্রত্যাশিত, যা নির্দেশ করে যে আলোচনার অবস্থা অজানা। এটি একটি অবৈধ ইনপুট মান।
PENDING_ACCEPTANCE	অর্ডারের অবস্থা অনুমোদনের অপেক্ষায়।
ACCEPTED	অর্ডারের অবস্থা গৃহীত হয়েছে।
ARCHIVED	অর্ডারের অবস্থা আর্কাইভ করা হয়েছে।
CANCELLED	অর্ডারের অবস্থা বাতিল করা হয়েছে।
NEGOTIATING	অর্ডারের অবস্থা নিয়ে আলোচনা। শুধুমাত্র ইনস্ট্যান্ট ডিল সিনারিও-এর জন্য প্রযোজ্য।

WSeatConfig

WSeat কনফিগারেশন।

JSON উপস্থাপনা
{ "exchangeWseatStatus": enum (WSeatStatus), "exchangeWseatIds": [ string ], "updateTime": string }

ক্ষেত্র
exchangeWseatStatus	enum ( WSeatStatus ) ঐচ্ছিক। WSeat কনফিগারেশনের জন্য Exchange প্রান্তের বর্তমান অবস্থা।
exchangeWseatIds[]	string ( int64 format) ঐচ্ছিক। এক্সচেঞ্জ সাইডের WSeat আইডিগুলো।
updateTime	string ( Timestamp format) শুধুমাত্র আউটপুট। এক্সচেঞ্জ দ্বারা WSeatConfiguration আপডেট করা হলে, DV3 এই ফিল্ডটি স্বয়ংক্রিয়ভাবে আপডেট করে। RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

WSeatStatus

WSeat Status enum বিকল্পসমূহ।

এনাম
W_SEAT_STATUS_UNSPECIFIED	WSeatStatus অনির্দিষ্ট।
W_SEAT_STATUS_ENFORCED	WSeatStatus বলবৎ করা হয়েছে। এটি নির্দেশ করে যে এক্সচেঞ্জটি DV3-তে WSeat ID পাঠিয়ে অথবা বিড রেসপন্সে WSeat ID যাচাই করে তা বলবৎ করে।
W_SEAT_STATUS_NOT_ENFORCED	WSeatStatus কার্যকর করা হয়নি। এর অর্থ হলো, এক্সচেঞ্জটি বিড অনুরোধে WSeat ID পাঠায় না এবং সেই অনুরোধগুলো যাচাইও করে না।

ক্রেতার তথ্য

ইনস্ট্যান্ট ডিল সিনারিওগুলির জন্য ক্রেতার তথ্য।

JSON উপস্থাপনা
{ "partner": { object (PartnerInfo) }, "advertisers": [ { object (AdvertiserInfo) } ] }

ক্ষেত্র
partner	object ( PartnerInfo ) শুধুমাত্র আউটপুট। অংশীদারের তথ্য।
advertisers[]	object ( AdvertiserInfo ) শুধুমাত্র আউটপুট। বিজ্ঞাপনদাতার তথ্য।

পার্টনারইনফো

ইনস্ট্যান্ট ডিল সিনারিওগুলির জন্য পার্টনারের তথ্য।

JSON উপস্থাপনা
{ "title": string }

ক্ষেত্র
title	string শুধুমাত্র আউটপুট। ডিসপ্লে ও ভিডিও ৩৬০-এ পার্টনারের শিরোনাম প্রদর্শিত হবে।

বিজ্ঞাপনদাতার তথ্য

ইনস্ট্যান্ট ডিল সিনারিওগুলির জন্য বিজ্ঞাপনদাতার তথ্য।

JSON উপস্থাপনা
{ "advertiserId": string, "domainUri": string }

ক্ষেত্র
advertiserId	string ( int64 format) শুধুমাত্র আউটপুট। ডিসপ্লে ও ভিডিও ৩৬০-এ বিজ্ঞাপনদাতার আইডি।
domainUri	string শুধুমাত্র আউটপুট। বিজ্ঞাপনদাতার ওয়েবসাইটের ডোমেইন ইউআরআই।

পদ্ধতি
accept	একটি অর্ডার গ্রহণ করে।
create	একটি অর্ডার তৈরি করে।
get	একটি আদেশ পায়।
list	অর্ডারগুলির তালিকা দেয়।
patch	একটি অর্ডার আপডেট করে।