REST Resource: exchanges.inventorySources

Resource: InventorySource

Model eksekusi sumber inventaris DV360.

Representasi 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)
  }
}
Kolom
name

string

Hanya output. Nama resource relatif untuk pesanan. Dibuat oleh server. Contoh: "exchanges/1234/inventorySources/5678".
buyerStatus

enum (BuyerStatus)

Hanya output. Status pembeli.
sellerStatus

enum (SellerStatus)

Status penjual.
transactionType

enum (TransactionType)

Hanya output. Jenis transaksi produk.
pricingType

enum (PricingType)

Hanya output. Jenis harga untuk produk.
rateDetails

object (RateDetails)

Hanya output. Detail tarif.
startTime

string (Timestamp format)

Hanya output. Waktu saat produk ini menjadi aktif. Harus lebih awal dari endTime. Waktu mulai tidak boleh lebih dari 1 tahun ke depan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Hanya output. Waktu saat produk ini menjadi tidak aktif.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Prakiraan volume harian yang disediakan bursa. Digunakan untuk menentukan kecepatan dan mengaktifkan pilihan pembeli. Kolom ini tidak lagi digunakan.
audienceMatchRate

number

Hanya output. Perkiraan rasio kecocokan audiens untuk transaksi dijamin terprogram dengan penargetan audiens, yang digunakan oleh bursa untuk menentukan jumlah permintaan tambahan yang harus dikirim. Ini adalah nilai desimal antara 0 dan 1, yang inversnya harus digunakan sebagai pengali untuk tayangan iklan. 0 menunjukkan bahwa kolom tidak ditetapkan, dan oleh karena itu tidak memiliki penargetan audiens. Contoh: "0.125". Hal ini menunjukkan bahwa 12,5% permintaan cocok dengan penargetan audiens, dan jumlah permintaan yang dikirim harus 8 kali lipat dari tayangan yang dinegosiasikan.
makegoodRequested

boolean

Hanya output. Menunjukkan apakah Kompensasi telah diminta dari pembeli.
makegoodRequestedReason

string

Hanya output. Alasan permintaan Kompensasi yang diberikan oleh pembeli.
percentFrequencyCapExcludedTraffic

string (int64 format)

Persen traffic yang dikecualikan dari pembatasan frekuensi untuk transaksi dijamin terprogram. Ini adalah bilangan bulat antara 0 dan 100. Nilai 0 (juga nilai default) menunjukkan tidak ada pengecualian dan oleh karena itu semua traffic memenuhi syarat untuk batas frekuensi. 100 menunjukkan pengecualian lengkap dan oleh karena itu tidak ada batas frekuensi yang akan diterapkan. Nilai antara 0 dan 100 akan menghasilkan pengecualian sebagian. Misalnya, nilai 20 akan menyebabkan 20% traffic dikecualikan dari batas frekuensi.
dv360WseatId[]

string (int64 format)

Hanya output. Wseats yang saat ini diberi izin ke sumber inventaris.
lastModifiedTime

string (Timestamp format)

Hanya output. Terakhir kali sumber inventaris diperbarui. Perhatikan bahwa beberapa update internal DV3 akan mengubah waktu terakhir diubah.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
creativeApprovalConfig

object (CreativeApprovalConfig)

Opsional. Konfigurasi untuk Persetujuan materi iklan. Persetujuan dapat diperlukan di tingkat bursa atau tingkat penayang.

BuyerStatus

Status pembeli.

Enum
BUYER_STATUS_UNSPECIFIED Status pembeli tidak ditentukan. Nilai input tidak valid.
BUYER_STATUS_ACTIVE Status pembeli aktif. Item baris ditetapkan, materi iklan valid ditetapkan.
BUYER_STATUS_PENDING Status pembeli tertunda. Status ini berarti transaksi tidak aktif dan ada tindakan tertentu yang diperlukan untuk pembeli.
BUYER_STATUS_PAUSED Status pembeli dijeda oleh pembeli.

SellerStatus

Status penjual.

Enum
SELLER_STATUS_UNSPECIFIED Status penjual tidak ditentukan. Tidak terduga, menunjukkan bahwa status negosiasi tidak diketahui. Nilai input tidak valid.
SELLER_STATUS_ACTIVE Status penjual aktif. Sumber inventaris aktif di sisi bursa.
SELLER_STATUS_PAUSED Status penjual dijeda.

InventorySourceVolumeForecast

Prakiraan volume permintaan harian untuk sumber inventaris. Aturan validasi berikut berlaku: - entri harus diberikan untuk setiap hari dalam seminggu - volume harus non-negatif - timeZoneId diperlukan dan harus valid

Representasi JSON 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Kolom
dailyVolumes[]

object (DailyVolume)

Prakiraan volume harian.
timeZoneId

string

Zona waktu Database Zona Waktu IANA, misalnya "America/New_York", yang digunakan untuk volume harian.

DailyVolume

Volume permintaan untuk sumber inventaris pada hari tertentu.

Representasi JSON 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Kolom
day

enum (DayOfWeek)

Hari dalam seminggu saat volume permintaan berlaku.
volume

string (int64 format)

Perkiraan volume permintaan untuk hari dalam seminggu tertentu.

DayOfWeek

Mewakili hari dalam seminggu.

Enum
DAY_OF_WEEK_UNSPECIFIED Hari dalam seminggu tidak ditentukan.
MONDAY Senin
TUESDAY Selasa
WEDNESDAY Rabu
THURSDAY Kamis
FRIDAY Jumat
SATURDAY Sabtu
SUNDAY Minggu

CreativeApprovalConfig

Konfigurasi untuk Persetujuan materi iklan.

Representasi JSON 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Kolom
requiresExchangeApproval

boolean

Wajib. Menunjukkan apakah materi iklan memerlukan persetujuan pra-penyerapan pada tingkat Exchange.
publisherConfigs[]

object (PublisherConfig)

Opsional. Konfigurasi untuk penayang.

PublisherConfig

Konfigurasi untuk penayang (publisher_config). Jika publisher_config disetel, materi iklan memerlukan persetujuan pra-penyerapan di tingkat penayang.

Representasi JSON 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Kolom
publisherId

string

Wajib. ID penayang.
publisherDisplayName

string

Wajib. Nama penayang.

Metode

get

 Mendapatkan sumber inventaris.

list

 Mencantumkan sumber inventaris.

patch

 Memperbarui sumber inventaris.