REST Resource: exchanges.inventorySources

منبع: InventorySource

مدل اجرای یک منبع موجودی DV360.

نمایندگی JSON 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
فیلدها
name

string

فقط خروجی نام منبع نسبی برای سفارش تولید شده توسط سرور مثال: "exchanges/1234/inventorySources/5678".

buyerStatus

enum ( BuyerStatus )

فقط خروجی وضعیت خریدار

sellerStatus

enum ( SellerStatus )

وضعیت فروشنده

transactionType

enum ( TransactionType )

فقط خروجی نوع معامله محصول

pricingType

enum ( PricingType )

فقط خروجی نوع قیمت گذاری برای محصول

rateDetails

object ( RateDetails )

فقط خروجی امتیاز دادن به جزئیات

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" .

exchangeVolumeForecast
(deprecated)

object ( InventorySourceVolumeForecast )

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

audienceMatchRate

number

فقط خروجی نرخ تطابق مخاطبان پیش‌بینی‌شده برای معاملات تضمین‌شده برنامه‌ای با هدف‌یابی مخاطب، که توسط صرافی برای تعیین تعداد درخواست‌های اضافی باید ارسال شود. این یک اعشار بین 0 و 1 است که معکوس آن باید به عنوان ضریب برای نمایش ها استفاده شود. 0 نشان می دهد که فیلد تنظیم نشده است و بنابراین هیچ هدف گذاری مخاطبی ندارد. مثال: "0.125". این نشان می‌دهد که 12.5 درصد از درخواست‌ها با هدف مخاطب مطابقت دارد و میزان درخواست‌های ارسالی باید 8 برابر تعداد بازدیدهای مورد مذاکره باشد.

makegoodRequested

boolean

فقط خروجی نشان می دهد که آیا کالای Makegood از خریدار درخواست شده است یا خیر.

makegoodRequestedReason

string

فقط خروجی دلیل درخواست Makegood توسط خریدار ارائه شده است.

percentFrequencyCapExcludedTraffic

string ( int64 format)

درصد ترافیک از سقف فرکانس برای یک معامله تضمینی برنامه‌ریزی حذف شده است. این یک عدد صحیح بین 0 و 100 است. مقدار 0 (همچنین مقدار پیش‌فرض) نشان‌دهنده عدم حذف است و بنابراین تمام ترافیک برای سقف فرکانس واجد شرایط است. 100 نشان دهنده حذف کامل است و بنابراین هیچ محدودیتی برای فرکانس اعمال نخواهد شد. مقادیر بین 0 تا 100 منجر به حذف جزئی می شود. به عنوان مثال، مقدار 20 منجر به حذف 20٪ از ترافیک از سقف فرکانس می شود.

dv360WseatId[]

string ( int64 format)

فقط خروجی جایگاه هایی که در حال حاضر برای منبع موجودی مجاز هستند.

lastModifiedTime

string ( Timestamp format)

فقط خروجی آخرین باری که منبع موجودی به روز شد. توجه داشته باشید که برخی از به‌روزرسانی‌های داخلی DV3 آخرین زمان تغییر را تغییر می‌دهند.

از 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" .

creativeApprovalConfig

object ( CreativeApprovalConfig )

اختیاری. پیکربندی برای تأیید خلاق. تأیید می تواند در سطح مبادله یا در سطح ناشر مورد نیاز باشد.

وضعیت خریدار

وضعیت خریدار

Enums
BUYER_STATUS_UNSPECIFIED وضعیت خریدار مشخص نشده است. مقدار ورودی معتبر نیست.
BUYER_STATUS_ACTIVE وضعیت خریدار فعال است. مورد خط اختصاص داده شد، خلاقیت معتبر اختصاص داده شد.
BUYER_STATUS_PENDING وضعیت خریدار در انتظار است. این وضعیت به این معنی است که معامله فعال نیست و اقدامات خاصی برای خریدار لازم است.
BUYER_STATUS_PAUSED وضعیت خریدار متوقف شده توسط خریدار.

وضعیت فروشنده

وضعیت فروشنده

Enums
SELLER_STATUS_UNSPECIFIED وضعیت فروشنده مشخص نشده است. غیر منتظره، نشان می دهد که وضعیت مذاکره ناشناخته است. مقدار ورودی معتبر نیست.
SELLER_STATUS_ACTIVE وضعیت فروشنده فعال است. منبع موجودی در سمت صرافی فعال است.
SELLER_STATUS_PAUSED وضعیت فروشنده متوقف شد.

InventorySourceVolumeForecast

پیش بینی حجم درخواست روزانه برای منبع موجودی. قوانین اعتبارسنجی زیر اعمال می شود: - یک ورودی باید برای هر روز از هفته ارائه شود - دکل حجمی غیر منفی است - timeZoneId لازم است و باید معتبر باشد

نمایندگی JSON 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
فیلدها
dailyVolumes[]

object ( DailyVolume )

پیش بینی حجم روزانه

timeZoneId

string

منطقه زمانی پایگاه داده منطقه زمانی IANA، به عنوان مثال "America/New_York" که برای حجم های روزانه استفاده می شود.

حجم روزانه

درخواست حجم برای منبع موجودی برای یک روز معین.

نمایندگی JSON 
{
  "day": enum (DayOfWeek),
  "volume": string
}
فیلدها
day

enum ( DayOfWeek )

روز هفته حجم درخواست اعمال می شود.

volume

string ( int64 format)

حجم درخواست پیش بینی شده برای روز معین هفته.

روز هفته

یک روز از هفته را نشان می دهد.

Enums
DAY_OF_WEEK_UNSPECIFIED روز هفته نامشخص است.
MONDAY دوشنبه
TUESDAY سه شنبه
WEDNESDAY چهارشنبه
THURSDAY پنج شنبه
FRIDAY جمعه
SATURDAY شنبه
SUNDAY یکشنبه

CreativeApprovalConfig

پیکربندی برای تأیید خلاق.

نمایندگی JSON 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
فیلدها
requiresExchangeApproval

boolean

مورد نیاز. نشان می دهد که آیا خلاقیت نیاز به تأیید قبل از مصرف در سطح مبادله دارد یا خیر.

publisherConfigs[]

object ( PublisherConfig )

اختیاری. پیکربندی برای ناشر.

PublisherConfig

پیکربندی برای ناشر (publisher_config). اگر publisher_config تنظیم شده باشد، خلاقیت نیاز به تأیید پیش از ورود در سطح ناشر دارد.

نمایندگی JSON 
{
  "publisherId": string,
  "publisherDisplayName": string
}
فیلدها
publisherId

string

مورد نیاز. شناسه ناشر

publisherDisplayName

string

مورد نیاز. نام ناشر

روش ها

get

 منبع موجودی را دریافت می کند.

list

 فهرست منابع موجودی

patch

 منبع موجودی را به روز می کند.