REST Resource: partners.inventorySources

Kaynak: InventorySource

Envanter kaynağı.

JSON gösterimi
{
  "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
  ]
}
Alanlar
name

string

Yalnızca çıkış. Envanter kaynağının kaynak adı.

inventorySourceId

string (int64 format)

Yalnızca çıkış. Envanter kaynağının benzersiz kimliği. Sistem tarafından atanır.

displayName

string

Envanter kaynağının görünen adı.

UTF-8 olarak kodlanmış ve maksimum 240 bayt boyutunda olmalıdır.

inventorySourceType

enum (InventorySourceType)

Envanter kaynağının türünü belirtir.

inventorySourceProductType

enum (InventorySourceProductType)

Yalnızca çıkış. Envanter kaynağının ürün türü, envanterin satılma şeklini belirtir.

commitment

enum (InventorySourceCommitment)

Envanter kaynağının garantili veya garanti edilmeyen yayınlama sunup sunmadığı.

deliveryMethod

enum (InventorySourceDeliveryMethod)

Envanter kaynağının yayınlanma yöntemi.

  • Garanti edilmeyen envanter kaynakları için kabul edilebilir tek değer INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC değeridir.
  • Garantili envanter kaynakları için kabul edilebilir değerler INVENTORY_SOURCE_DELIVERY_METHOD_TAG ve INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC'dir.
dealId

string

Exchange alanında envanter kaynağını benzersiz şekilde tanımlayan kimlik.

Her exchange'deki alıcılar arasında benzersiz olmalıdır ancak exchange'ler arasında benzersiz olması gerekmez.

status

object (InventorySourceStatus)

Envanter kaynağının durum ayarları.

exchange

enum (Exchange)

Envanter kaynağının ait olduğu exchange.

updateTime

string (Timestamp format)

Yalnızca çıkış. Envanter kaynağının en son güncellendiği zaman damgası. Sistem tarafından atanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

rateDetails

object (RateDetails)

Zorunlu. Envanter kaynağının ücret ayrıntıları.

publisherName

string

Envanter kaynağının yayıncı/satıcı adı.

timeRange

object (TimeRange)

Bu envanter kaynağının yayınlanmaya başladığı ve durduğu zaman aralığı.

creativeConfigs[]

object (CreativeConfig)

Envanter kaynağının reklam öğesi koşulları.

Açık artırma paketleri için geçerli değildir.

guaranteedOrderId

string

Değiştirilemez. Bu envanter kaynağının ait olduğu garantili siparişin kimliği.

Yalnızca commitment, INVENTORY_SOURCE_COMMITMENT_GUARANTEED olduğunda geçerlidir.

readWriteAccessors

object (InventorySourceAccessors)

Envanter kaynağına okuma/yazma erişimi olan iş ortağı veya reklamverenler.

Yalnızca commitment, INVENTORY_SOURCE_COMMITMENT_GUARANTEED olduğunda çıkış yapılır. Bu durumda okuma/yazma erişimcileri, üst garantili siparişten devralınır.

commitment, INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED ise zorunludur.

commitment, INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED ise ve bu alanda bir iş ortağı ayarlanmışsa bu iş ortağının altındaki tüm reklamverenler, envanter kaynağına otomatik olarak salt okuma erişimine sahip olur. Bu reklamverenler readAdvertiserIds kapsamına dahil edilmez.

readAdvertiserIds[]

string (int64 format)

Yalnızca çıkış. Envanter kaynağına salt okuma erişimi olan reklamverenlerin kimlikleri.

readPartnerIds[]

string (int64 format)

Yalnızca çıkış. Envanter kaynağına salt okuma erişimi olan iş ortaklarının kimlikleri.

Bu alandaki iş ortaklarının tüm reklamverenleri, envanter kaynağına salt okuma erişimini devralır.

Yöntemler

get

Envanter kaynağı anlaşmasını alır.

list

Envanter kaynağı anlaşmalarını listeler.