REST Resource: partners.inventorySources

منبع: InventorySource

منبع فضای آگهی.

نمایش JSON 
{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
فیلدها
name

string

فقط خروجی. نام منبع منبع سیاهه.
inventorySourceId

string (int64 format)

فقط خروجی. شناسه یکتای منبع سیاهه. توسط سیستم اختصاص داده شده است.
displayName

string

نام نمایشی منبع فضای آگهی.

باید با UTF-8 کدبندی شده باشد و حداکثر اندازه آن ۲۴۰ بایت باشد.
inventorySourceType

enum (InventorySourceType)

نوع منبع فضای آگهی را نشان می‌دهد.
inventorySourceProductType

enum (InventorySourceProductType)

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

enum (InventorySourceCommitment)

اینکه منبع فضای آگهی تحویل تضمین‌شده یا تضمین‌نشده داشته باشد.
deliveryMethod

enum (InventorySourceDeliveryMethod)

روش ارائه آگهی منبع فضای آگهی.

  • برای منابع فضای آگهی غیرتضمینی، تنها مقدار قابل‌قبول INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC است.
  • برای منابع فضای آگهی تضمین‌شده، مقادیر قابل‌قبول INVENTORY_SOURCE_DELIVERY_METHOD_TAG و INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC است.
dealId

string

شناسه در فضای تبادل که منبع موجودی را به‌طور منحصربه‌فرد شناسایی می‌کند.

باید در بین خریداران در هر مبادله منحصربه‌فرد باشد اما لزوماً در بین مبادلات منحصربه‌فرد نیست.
status

object (InventorySourceStatus)

تنظیمات وضعیت منبع موجودی.
exchange

enum (Exchange)

صرافی‌ای که منبع فضای آگهی به آن تعلق دارد.
updateTime

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

object (RateDetails)

الزامی. جزئیات نرخ منبع سیاهه.
publisherName

string

نام ناشر/فروشنده منبع فضای آگهی.
timeRange

object (TimeRange)

محدوده زمانی که این منبع فهرست موجودی شروع به ارائه می‌کند و متوقف می‌شود.
creativeConfigs[]

object (CreativeConfig)

الزامات طرح آگهی منبع فهرستگان.

برای بسته‌های مزایده‌ای قابل اعمال نیست.
guaranteedOrderId

string

تغییرناپذیر. شناسه سفارش تضمین‌شده‌ای که این منبع موجودی به آن تعلق دارد.

فقط زمانی قابل‌اعمال است که commitment INVENTORY_SOURCE_COMMITMENT_GUARANTEED باشد.
readWriteAccessors

object (InventorySourceAccessors)

شریک یا تبلیغ‌کنندگانی که دسترسی خواندن/نوشتن به منبع موجودی کالا دارند.

فقط زمانی خروجی می‌دهد که commitment برابر با INVENTORY_SOURCE_COMMITMENT_GUARANTEED باشد، که در این صورت، دسترسی‌های خواندن/نوشتن از سفارش تضمین‌شده والد به ارث می‌رسد.

وقتی commitment INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED باشد، الزامی است.

اگر commitment INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED باشد و شریکی در این فیلد تنظیم شده باشد، همه تبلیغ‌کنندگان تحت این شریک به‌طور خودکار دسترسی فقط خواندنی به منبع موجودی خواهند داشت. این تبلیغ‌کنندگان در readAdvertiserIds اضافه نخواهند شد.
readAdvertiserIds[]

string (int64 format)

فقط خروجی. شناسه‌های تبلیغ‌کنندگانی که دسترسی فقط خواندنی به منبع فضای آگهی دارند.
readPartnerIds[]

string (int64 format)

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

همه تبلیغ‌کنندگان شرکا در این فیلد دسترسی فقط خواندنی به منبع فضای آگهی را به ارث می‌برند.

روش‌ها

get

 معامله منبع فضای آگهی را دریافت می‌کند.

list

 معامله‌های منبع فضای آگهی را فهرست می‌کند.