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 و حداکثر اندازه ۲۴۰ کاراکتر باشد.

status

enum ( DiscoveryObjectStatus )

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

description

string

الزامی. متن توضیحات این بسته. باید با کدگذاری UTF-8 و حداکثر اندازه ۲۰۰۰ کاراکتر باشد.

format

enum ( Format )

الزامی. تغییرناپذیر. نوع قالب تبلیغ اصلی. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

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

externalDealId

string

الزامی. تغییرناپذیر. شناسه معامله صرافی که در درخواست‌های پیشنهاد قیمت استفاده می‌شود. حداکثر ۱۰۰ کاراکتر. کاراکترهای مجاز شامل حروف و اعداد، زیرخط، خط تیره و نقطه هستند. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

logoUrl

string

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

floorPrice

object ( Money )

الزامی. قیمت پایه این بسته حراج.

startTime

string ( Timestamp format)

الزامی. زمانی که این بسته حراج فعال می‌شود. باید قبل از پایان زمان باشد. زمان شروع نمی‌تواند بیش از ۱ سال آینده باشد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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

 یک بسته حراج را به‌روزرسانی می‌کند.
لوگوی مربوط به بسته مشخص شده را آپلود کنید.
،

منبع: 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 و حداکثر اندازه ۲۴۰ کاراکتر باشد.

status

enum ( DiscoveryObjectStatus )

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

description

string

الزامی. متن توضیحات این بسته. باید با کدگذاری UTF-8 و حداکثر اندازه ۲۰۰۰ کاراکتر باشد.

format

enum ( Format )

الزامی. تغییرناپذیر. نوع قالب تبلیغ اصلی. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

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

externalDealId

string

الزامی. تغییرناپذیر. شناسه معامله صرافی که در درخواست‌های پیشنهاد قیمت استفاده می‌شود. حداکثر ۱۰۰ کاراکتر. کاراکترهای مجاز شامل حروف و اعداد، زیرخط، خط تیره و نقطه هستند. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

logoUrl

string

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

floorPrice

object ( Money )

الزامی. قیمت پایه این بسته حراج.

startTime

string ( Timestamp format)

الزامی. زمانی که این بسته حراج فعال می‌شود. باید قبل از پایان زمان باشد. زمان شروع نمی‌تواند بیش از ۱ سال آینده باشد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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

 یک بسته حراج را به‌روزرسانی می‌کند.
لوگوی مربوط به بسته مشخص شده را آپلود کنید.
،

منبع: 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 و حداکثر اندازه ۲۴۰ کاراکتر باشد.

status

enum ( DiscoveryObjectStatus )

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

description

string

الزامی. متن توضیحات این بسته. باید با کدگذاری UTF-8 و حداکثر اندازه ۲۰۰۰ کاراکتر باشد.

format

enum ( Format )

الزامی. تغییرناپذیر. نوع قالب تبلیغ اصلی. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

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

externalDealId

string

الزامی. تغییرناپذیر. شناسه معامله صرافی که در درخواست‌های پیشنهاد قیمت استفاده می‌شود. حداکثر ۱۰۰ کاراکتر. کاراکترهای مجاز شامل حروف و اعداد، زیرخط، خط تیره و نقطه هستند. به‌روزرسانی‌ها پس از ایجاد مجاز نیستند.

logoUrl

string

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

floorPrice

object ( Money )

الزامی. قیمت پایه این بسته حراج.

startTime

string ( Timestamp format)

الزامی. زمانی که این بسته حراج فعال می‌شود. باید قبل از پایان زمان باشد. زمان شروع نمی‌تواند بیش از ۱ سال آینده باشد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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

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