REST Resource: exchanges.auctionPackages

منبع: AuctionPackage

یک بسته حراج واحد را در بر می گیرد. تبلیغ‌کنندگان در DV3 می‌توانند همه بسته‌های حراج در 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 با حداکثر اندازه 240 کاراکتر باشد. مورد نیاز.

status

enum ( DiscoveryObjectStatus )

وضعیت این بسته حراج. بسته‌های دارای وضعیت موقتاً متوقف یا حذف شده به تبلیغ‌کنندگان DV3 نشان داده نمی‌شوند. مورد نیاز.

description

string

متن توضیحات این بسته باید دارای کد UTF-8 با حداکثر اندازه 2000 کاراکتر باشد. مورد نیاز.

format

enum ( Format )

نوع قالب آگهی زیربنایی. مورد نیاز. به روز رسانی پس از ایجاد مجاز نیست.

forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

پیش بینی تفکیک موجودی این بسته حراج. تبلیغ‌کنندگان DV3 می‌توانند این تفکیک‌ها را ببینند و فیلتر کنند. اختیاری.

externalDealId

string

شناسه معامله مبادله ای که در درخواست های پیشنهادی استفاده می شود. حداکثر 100 کاراکتر کاراکترهای مجاز عبارتند از حروف عددی، زیرخط، خط تیره و نقطه. مورد نیاز. مورد نیاز. به روز رسانی پس از ایجاد اجازه نمی دهد.

logoUrl

string

فقط خروجی نشانی اینترنتی لوگوی این بسته حراج.

فقط خروجی

floorPrice

object ( Money )

قیمت کف این بسته حراج. مورد نیاز.

startTime

string ( Timestamp format)

زمانی که این محصول فعال می شود. باید زودتر از پایان زمان باشد. زمان شروع نمی تواند بیش از 1 سال در آینده باشد. مورد نیاز.

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "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 نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "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 برای بسته حراج در بازار.

قالب

قالب آگهی برای بسته حراج.

Enums
DEAL_FORMAT_UNSPECIFIED قالب معامله نامشخص است. برای ورودی معتبر نیست.
DEAL_FORMAT_DISPLAY فرمت نمایش
DEAL_FORMAT_VIDEO فرمت ویدیویی
DEAL_FORMAT_AUDIO فرمت صوتی.

روش ها

create

 یک بسته حراج جدید ایجاد می کند.

get

 بسته حراج می گیرد.

list

 بسته های حراج را لیست می کند.

patch

 بسته حراج را به روز می کند.
لوگوی بسته مشخص شده را بارگذاری کنید.