REST Resource: exchanges.inventorySources

Kaynak: InventorySource

DV360 envanter kaynağının yürütme modeli.

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

string

Yalnızca çıkış. Sıranın göreli kaynak adı. Sunucu tarafından oluşturulur. Örnek: "exchanges/1234/inventorySources/5678".
buyerStatus

enum (BuyerStatus)

Yalnızca çıkış. Alıcı durumu.
sellerStatus

enum (SellerStatus)

Satıcı durumu.
transactionType

enum (TransactionType)

Yalnızca çıkış. Ürün işlem türü.
pricingType

enum (PricingType)

Yalnızca çıkış. Ürünün fiyatlandırma türü.
rateDetails

object (RateDetails)

Yalnızca çıkış. Fiyat ayrıntıları.
startTime

string (Timestamp format)

Yalnızca çıkış. Bu ürünün etkinleştiği zaman. endTime değerinden önce olmalıdır. Başlangıç zamanı en fazla 1 yıl sonrası olabilir.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Yalnızca çıkış. Bu ürünün etkin olmadığı zaman.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Exchange tarafından sağlanan günlük hacim tahmini. Adım hızını belirlemek ve alıcı seçimini etkinleştirmek için kullanılır. Bu alan kullanımdan kaldırılmıştır.
audienceMatchRate

number

Yalnızca çıkış. Kitle hedefleme içeren programatik garantili anlaşmalar için öngörülen kitle eşleşme oranı. Exchange tarafından kaç ek istek gönderileceğini belirlemek için kullanılır. Bu, 0 ile 1 arasında bir ondalık sayıdır ve gösterim çarpanı olarak tersinin kullanılması gerekir. 0, alanın ayarlanmadığını ve dolayısıyla kitle hedeflemesi olmadığını gösterir. Örnek: "0,125". Bu, isteklerin% 12,5'inin kitle hedeflemesiyle eşleştiğini gösterir ve gönderilen istek miktarı, pazarlık yapılan gösterimlerin 8 katı olmalıdır.
makegoodRequested

boolean

Yalnızca çıkış. Alıcıdan iyileştirme isteğinde bulunulup bulunulmadığını belirtir.
makegoodRequestedReason

string

Yalnızca çıkış. Alıcı tarafından sağlanan, iyileştirme isteğinin nedeni.
percentFrequencyCapExcludedTraffic

string (int64 format)

Programatik Garantili anlaşma için sıklık sınırından hariç tutulan trafiğin yüzdesi. Bu, 0 ile 100 arasında bir tam sayıdır. 0 değeri (varsayılan değerdir) hariç tutma olmadığını ve bu nedenle tüm trafiğin sıklık sınırına uygun olduğunu gösterir. 100 değeri, tamamen hariç tutulduğunu ve bu nedenle sıklık sınırı uygulanmayacağını gösterir. 0 ile 100 arasındaki değerler kısmi hariç tutmayla sonuçlanır. Örneğin, 20 değerinin kullanılması trafiğin% 20'sinin sıklık sınırından hariç tutulmasına neden olur.
dv360WseatId[]

string (int64 format)

Yalnızca çıkış. Şu anda envanter kaynağı için izin verilen wseat'ler.
lastModifiedTime

string (Timestamp format)

Yalnızca çıkış. Envanter kaynağının son güncellenme tarihi. Bazı DV3 dahili güncellemelerinin son değiştirilme zamanını değiştireceğini unutmayın.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
creativeApprovalConfig

object (CreativeApprovalConfig)

İsteğe bağlı. Reklam öğesi onayı yapılandırması. Onay, exchange düzeyinde veya yayıncı düzeyinde gerekebilir.

BuyerStatus

Alıcı durumu.

Sıralamalar
BUYER_STATUS_UNSPECIFIED Alıcı durumu belirtilmemiş. Geçersiz giriş değeri.
BUYER_STATUS_ACTIVE Alıcı durumu etkin. Satır öğesi atandı, geçerli reklam öğesi atandı.
BUYER_STATUS_PENDING Alıcı durumu beklemede. Bu durum, anlaşmanın etkin olmadığı ve alıcının belirli işlemleri yapması gerektiği anlamına gelir.
BUYER_STATUS_PAUSED Alıcı tarafından duraklatılan alıcı durumu.

SellerStatus

Satıcı durumu.

Sıralamalar
SELLER_STATUS_UNSPECIFIED Satıcı durumu belirtilmemiş. Beklenmeyen. Pazarlık durumunun bilinmediğini gösterir. Geçersiz giriş değeri.
SELLER_STATUS_ACTIVE Satıcı durumu etkin olmalıdır. Envanter kaynağı exchange tarafında etkin.
SELLER_STATUS_PAUSED Satıcı durumu duraklatıldı.

InventorySourceVolumeForecast

Bir envanter kaynağı için günlük istek hacmi tahmini. Aşağıdaki doğrulama kuralları geçerlidir: - Haftanın her günü için bir giriş sağlanmalıdır. - Hacim negatif olmamalıdır. - timeZoneId gereklidir ve geçerli olmalıdır.

JSON gösterimi 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Alanlar
dailyVolumes[]

object (DailyVolume)

Günlük hacim tahmini.
timeZoneId

string

Günlük hacimlerde kullanılan IANA Saat Dilimi Veritabanı saat dilimi (ör. "America/New_York").

DailyVolume

Belirli bir gün için envanter kaynağının istek hacmini isteyin.

JSON gösterimi 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Alanlar
day

enum (DayOfWeek)

İstek hacminin geçerli olduğu haftanın günü.
volume

string (int64 format)

Haftanın belirli bir günü için öngörülen istek hacmi.

HaftanınGünü

Haftanın bir gününü temsil eder.

Sıralamalar
DAY_OF_WEEK_UNSPECIFIED Haftanın günü belirtilmemiş.
MONDAY Pazartesi
TUESDAY Salı
WEDNESDAY Çarşamba
THURSDAY Perşembe
FRIDAY Cuma
SATURDAY Cumartesi
SUNDAY Pazar

CreativeApprovalConfig

Reklam öğesi onayı yapılandırması.

JSON gösterimi 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Alanlar
requiresExchangeApproval

boolean

Zorunlu. Reklam öğesinin exchange seviyesinde besleme öncesi onay gerektirip gerektirmediğini belirtir.
publisherConfigs[]

object (PublisherConfig)

İsteğe bağlı. Yayıncının yapılandırması.

PublisherConfig

Yayıncının yapılandırması (publisher_config). publisher_config ayarlanmışsa reklam öğesi için yayıncı düzeyinde besleme öncesi onay gerekir.

JSON gösterimi 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Alanlar
publisherId

string

Zorunlu. Yayıncı kimliği.
publisherDisplayName

string

Zorunlu. Yayıncı adı.

Yöntemler

get

 Bir envanter kaynağı alır.

list

 Envanter kaynaklarını listeler.

patch

 Bir envanter kaynağını günceller.