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)

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

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

exchangeVolumeForecast
(deprecated)

object ( InventorySourceVolumeForecast )

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

audienceMatchRate

number

فقط خروجی. نرخ تطابق مخاطب پیش‌بینی‌شده برای تضمین برنامه‌ریزی‌شده با هدف‌گیری مخاطب سروکار دارد و توسط صرافی برای تعیین تعداد درخواست‌های اضافی که باید ارسال شوند، استفاده می‌شود. این یک عدد اعشاری بین ۰ و ۱ است که معکوس آن باید به عنوان ضریبی برای نمایش‌ها استفاده شود. ۰ نشان می‌دهد که فیلد تنظیم نشده است و بنابراین هیچ هدف‌گیری مخاطبی ندارد. مثال: 0.125 . این نشان می‌دهد که ۱۲.۵٪ از درخواست‌ها با هدف‌گیری مخاطب مطابقت دارند و میزان درخواست‌های ارسالی باید ۸ برابر نمایش‌های توافق‌شده باشد.

makegoodRequested

boolean

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

makegoodRequestedReason

string

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

percentFrequencyCapExcludedTraffic

string ( int64 format)

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

dv360WseatId[]

string ( int64 format)

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

lastModifiedTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

creativeApprovalConfig

object ( CreativeApprovalConfig )

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

وضعیت خریدار

وضعیت خریدار.

انوم‌ها
BUYER_STATUS_UNSPECIFIED وضعیت خریدار مشخص نشده است. مقدار ورودی معتبر نیست.
BUYER_STATUS_ACTIVE وضعیت خریدار فعال است. ردیف کالا اختصاص داده شده، آگهی معتبر اختصاص داده شده است.
BUYER_STATUS_PENDING وضعیت خریدار در حال بررسی است. این وضعیت به این معنی است که معامله فعال نیست و خریدار باید اقدامات خاصی را انجام دهد.
BUYER_STATUS_PAUSED وضعیت خریدار توسط خریدار متوقف شده است.

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

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

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

موجودیمنبعحجمپیش‌بینی

پیش‌بینی حجم درخواست روزانه برای منبع موجودی. قوانین اعتبارسنجی زیر اعمال می‌شود: - برای هر روز هفته باید یک ورودی ارائه شود - حجم باید غیر منفی باشد - 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)

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

روز هفته

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

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

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

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

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

boolean

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

publisherConfigs[]

object ( PublisherConfig )

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

پیکربندی ناشر

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

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

string

الزامی. شناسه ناشر.

publisherDisplayName

string

الزامی. نام ناشر.

روش‌ها

get

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

list

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

patch

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

منبع: 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)

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

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

exchangeVolumeForecast
(deprecated)

object ( InventorySourceVolumeForecast )

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

audienceMatchRate

number

فقط خروجی. نرخ تطابق مخاطب پیش‌بینی‌شده برای تضمین برنامه‌ریزی‌شده با هدف‌گیری مخاطب سروکار دارد و توسط صرافی برای تعیین تعداد درخواست‌های اضافی که باید ارسال شوند، استفاده می‌شود. این یک عدد اعشاری بین ۰ و ۱ است که معکوس آن باید به عنوان ضریبی برای نمایش‌ها استفاده شود. ۰ نشان می‌دهد که فیلد تنظیم نشده است و بنابراین هیچ هدف‌گیری مخاطبی ندارد. مثال: 0.125 . این نشان می‌دهد که ۱۲.۵٪ از درخواست‌ها با هدف‌گیری مخاطب مطابقت دارند و میزان درخواست‌های ارسالی باید ۸ برابر نمایش‌های توافق‌شده باشد.

makegoodRequested

boolean

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

makegoodRequestedReason

string

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

percentFrequencyCapExcludedTraffic

string ( int64 format)

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

dv360WseatId[]

string ( int64 format)

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

lastModifiedTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

creativeApprovalConfig

object ( CreativeApprovalConfig )

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

وضعیت خریدار

وضعیت خریدار.

انوم‌ها
BUYER_STATUS_UNSPECIFIED وضعیت خریدار مشخص نشده است. مقدار ورودی معتبر نیست.
BUYER_STATUS_ACTIVE وضعیت خریدار فعال است. ردیف کالا اختصاص داده شده، آگهی معتبر اختصاص داده شده است.
BUYER_STATUS_PENDING وضعیت خریدار در حال بررسی است. این وضعیت به این معنی است که معامله فعال نیست و خریدار باید اقدامات خاصی را انجام دهد.
BUYER_STATUS_PAUSED وضعیت خریدار توسط خریدار متوقف شده است.

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

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

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

موجودیمنبعحجمپیش‌بینی

پیش‌بینی حجم درخواست روزانه برای منبع موجودی. قوانین اعتبارسنجی زیر اعمال می‌شود: - برای هر روز هفته باید یک ورودی ارائه شود - حجم باید غیر منفی باشد - 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)

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

روز هفته

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

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

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

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

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

boolean

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

publisherConfigs[]

object ( PublisherConfig )

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

پیکربندی ناشر

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

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

string

الزامی. شناسه ناشر.

publisherDisplayName

string

الزامی. نام ناشر.

روش‌ها

get

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

list

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

patch

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

منبع: 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)

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

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

exchangeVolumeForecast
(deprecated)

object ( InventorySourceVolumeForecast )

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

audienceMatchRate

number

فقط خروجی. نرخ تطابق مخاطب پیش‌بینی‌شده برای تضمین برنامه‌ریزی‌شده با هدف‌گیری مخاطب سروکار دارد و توسط صرافی برای تعیین تعداد درخواست‌های اضافی که باید ارسال شوند، استفاده می‌شود. این یک عدد اعشاری بین ۰ و ۱ است که معکوس آن باید به عنوان ضریبی برای نمایش‌ها استفاده شود. ۰ نشان می‌دهد که فیلد تنظیم نشده است و بنابراین هیچ هدف‌گیری مخاطبی ندارد. مثال: 0.125 . این نشان می‌دهد که ۱۲.۵٪ از درخواست‌ها با هدف‌گیری مخاطب مطابقت دارند و میزان درخواست‌های ارسالی باید ۸ برابر نمایش‌های توافق‌شده باشد.

makegoodRequested

boolean

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

makegoodRequestedReason

string

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

percentFrequencyCapExcludedTraffic

string ( int64 format)

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

dv360WseatId[]

string ( int64 format)

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

lastModifiedTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

creativeApprovalConfig

object ( CreativeApprovalConfig )

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

وضعیت خریدار

وضعیت خریدار.

انوم‌ها
BUYER_STATUS_UNSPECIFIED وضعیت خریدار مشخص نشده است. مقدار ورودی معتبر نیست.
BUYER_STATUS_ACTIVE وضعیت خریدار فعال است. ردیف کالا اختصاص داده شده، آگهی معتبر اختصاص داده شده است.
BUYER_STATUS_PENDING وضعیت خریدار در حال بررسی است. این وضعیت به این معنی است که معامله فعال نیست و خریدار باید اقدامات خاصی را انجام دهد.
BUYER_STATUS_PAUSED وضعیت خریدار توسط خریدار متوقف شده است.

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

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

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

موجودیمنبعحجمپیش‌بینی

پیش‌بینی حجم درخواست روزانه برای منبع موجودی. قوانین اعتبارسنجی زیر اعمال می‌شود: - برای هر روز هفته باید یک ورودی ارائه شود - حجم باید غیر منفی باشد - 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)

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

روز هفته

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

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

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

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

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

boolean

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

publisherConfigs[]

object ( PublisherConfig )

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

پیکربندی ناشر

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

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

string

الزامی. شناسه ناشر.

publisherDisplayName

string

الزامی. نام ناشر.

روش‌ها

get

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

list

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

patch

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

منبع: 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)

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

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

exchangeVolumeForecast
(deprecated)

object ( InventorySourceVolumeForecast )

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

audienceMatchRate

number

فقط خروجی. نرخ تطابق مخاطب پیش‌بینی‌شده برای تضمین برنامه‌ریزی‌شده با هدف‌گیری مخاطب سروکار دارد و توسط صرافی برای تعیین تعداد درخواست‌های اضافی که باید ارسال شوند، استفاده می‌شود. این یک عدد اعشاری بین ۰ و ۱ است که معکوس آن باید به عنوان ضریبی برای نمایش‌ها استفاده شود. ۰ نشان می‌دهد که فیلد تنظیم نشده است و بنابراین هیچ هدف‌گیری مخاطبی ندارد. مثال: 0.125 . این نشان می‌دهد که ۱۲.۵٪ از درخواست‌ها با هدف‌گیری مخاطب مطابقت دارند و میزان درخواست‌های ارسالی باید ۸ برابر نمایش‌های توافق‌شده باشد.

makegoodRequested

boolean

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

makegoodRequestedReason

string

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

percentFrequencyCapExcludedTraffic

string ( int64 format)

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

dv360WseatId[]

string ( int64 format)

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

lastModifiedTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

creativeApprovalConfig

object ( CreativeApprovalConfig )

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

وضعیت خریدار

وضعیت خریدار.

انوم‌ها
BUYER_STATUS_UNSPECIFIED وضعیت خریدار مشخص نشده است. مقدار ورودی معتبر نیست.
BUYER_STATUS_ACTIVE وضعیت خریدار فعال است. ردیف کالا اختصاص داده شده، آگهی معتبر اختصاص داده شده است.
BUYER_STATUS_PENDING وضعیت خریدار در حال بررسی است. این وضعیت به این معنی است که معامله فعال نیست و خریدار باید اقدامات خاصی را انجام دهد.
BUYER_STATUS_PAUSED وضعیت خریدار توسط خریدار متوقف شده است.

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

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

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

موجودیمنبعحجمپیش‌بینی

پیش‌بینی حجم درخواست روزانه برای منبع موجودی. قوانین اعتبارسنجی زیر اعمال می‌شود: - برای هر روز هفته باید یک ورودی ارائه شود - حجم باید غیر منفی باشد - 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)

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

روز هفته

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

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

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

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

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

boolean

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

publisherConfigs[]

object ( PublisherConfig )

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

پیکربندی ناشر

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

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

string

الزامی. شناسه ناشر.

publisherDisplayName

string

الزامی. نام ناشر.

روش‌ها

get

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

list

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

patch

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