REST Resource: exchanges.auctionPackages

• উৎস: নিলাম প্যাকেজ
  • JSON উপস্থাপনা
• ফর্ম্যাট
• পদ্ধতি

উৎস: নিলাম প্যাকেজ

এর মধ্যে একটি একক নিলাম প্যাকেজ অন্তর্ভুক্ত। DV3-এর বিজ্ঞাপনদাতারা মার্কেটপ্লেস ডিসকভারি UI-এর মাধ্যমে DV3-এর সমস্ত নিলাম প্যাকেজ ব্রাউজ করতে পারেন এবং বিক্রেতার কোনো পদক্ষেপ ছাড়াই এই প্যাকেজগুলি ব্যবহার করার জন্য সম্মতি জানাতে পারেন।

JSON উপস্থাপনা

{ "name": string, "displayName": string, "status": enum (DiscoveryObjectStatus), "description": string, "format": enum (Format), "forecast": { object (SellerProvidedInventoryAvailabilityEstimate) }, "externalDealId": string, "logoUrl": string, "floorPrice": { object (Money) }, "startTime": string, "endTime": string, "mediumType": enum (MediumType), "urgOwners": [ enum (UnderRepresentedGroup) ], "dv3MarketplaceUri": string }

ক্ষেত্র
name	string শনাক্তকারী। এই নিলাম প্যাকেজের জন্য আপেক্ষিক রিসোর্স নাম। exchanges/{seller_id}/auctionpackages/{auction_package_id} এই ফর্ম্যাটের হওয়া উচিত। উদাহরণ: exchanges/1234/auctionPackage/5678 ।
displayName	string আবশ্যক। এই নিলাম প্যাকেজের প্রদর্শিত নাম। অবশ্যই UTF-8 এনকোডেড হতে হবে এবং এর সর্বোচ্চ আকার ২৪০ অক্ষরের মধ্যে সীমাবদ্ধ থাকবে।
status	enum ( DiscoveryObjectStatus ) প্রয়োজনীয়। এই নিলাম প্যাকেজের অবস্থা। PAUSED বা REMOVED স্ট্যাটাসযুক্ত প্যাকেজগুলি DV3 বিজ্ঞাপনদাতাদের দেখানো হয় না।
description	string আবশ্যক। এই প্যাকেজের জন্য বিবরণী টেক্সট। অবশ্যই UTF-8 এনকোডেড হতে হবে এবং এর সর্বোচ্চ আকার ২০০০ অক্ষর।
format	enum ( Format ) আবশ্যক। অপরিবর্তনীয়। অন্তর্নিহিত বিজ্ঞাপন ফরম্যাটের ধরণ। তৈরির পর আপডেট করার অনুমতি নেই।
forecast	object ( SellerProvidedInventoryAvailabilityEstimate ) ঐচ্ছিক। এই নিলাম প্যাকেজের ইনভেন্টরির পূর্বাভাসের বিস্তারিত বিবরণ। DV3 বিজ্ঞাপনদাতারা এই বিবরণগুলো দেখতে এবং ফিল্টার করতে পারেন।
externalDealId	string আবশ্যক। অপরিবর্তনীয়। বিড অনুরোধে ব্যবহৃত এক্সচেঞ্জ ডিল আইডি। সর্বোচ্চ ১০০ অক্ষর। অনুমোদিত অক্ষরগুলো হলো অ্যালফানিউমেরিক, আন্ডারস্কোর, ড্যাশ এবং ডট। তৈরির পর কোনো আপডেট করা যাবে না।
logoUrl	string শুধুমাত্র আউটপুট। এই নিলাম প্যাকেজের লোগোর ইউআরএল।
floorPrice	object ( Money ) প্রয়োজনীয়। এই নিলাম প্যাকেজের সর্বনিম্ন মূল্য।
startTime	string ( Timestamp format) আবশ্যক। যে সময়ে এই নিলাম প্যাকেজটি সক্রিয় হবে। তা অবশ্যই শেষ সময়ের (endTime) আগে হতে হবে। শুরুর সময় ভবিষ্যতের ১ বছরের বেশি হতে পারবে না। RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।
endTime	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" ।
mediumType	enum ( MediumType ) প্রয়োজনীয়। নিলাম প্যাকেজের মাঝারি ধরন।
urgOwners[]	enum ( UnderRepresentedGroup ) ঐচ্ছিক। মালিক যদি কোনো স্বল্প প্রতিনিধিত্বকারী গোষ্ঠীর সদস্য হন, তবে তা উল্লেখ করতে হবে।
dv3MarketplaceUri	string শুধুমাত্র আউটপুট। মার্কেটপ্লেসে নিলাম প্যাকেজের জন্য DV360 লিঙ্ক।

ফর্ম্যাট

নিলাম প্যাকেজের জন্য বিজ্ঞাপনের ফরম্যাট।

এনাম
DEAL_FORMAT_UNSPECIFIED	লেনদেনের ধরণ অনির্দিষ্ট। ইনপুটের জন্য বৈধ নয়।
DEAL_FORMAT_DISPLAY	প্রদর্শন বিন্যাস।
DEAL_FORMAT_VIDEO	ভিডিও ফরম্যাট।
DEAL_FORMAT_AUDIO	অডিও ফরম্যাট।

পদ্ধতি
create	একটি নতুন নিলাম প্যাকেজ তৈরি করে।
get	একটি নিলাম প্যাকেজ পায়।
list	নিলাম প্যাকেজগুলির তালিকা।
patch	একটি নিলাম প্যাকেজ আপডেট করে।
uploadLogo	নির্দিষ্ট প্যাকেজের জন্য লোগো আপলোড করুন।