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, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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)

Bursa memberikan perkiraan volume harian. 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 desimal antara 0 dan 1, yang inversnya harus digunakan sebagai pengganda untuk tayangan. 0 menunjukkan bahwa kolom tidak ditetapkan, sehingga tidak memiliki penargetan audiens. Contoh: "0,125". Ini menunjukkan bahwa 12,5% permintaan cocok dengan penargetan audiens, dan jumlah permintaan yang dikirim harus 8x lipat dari tayangan iklan 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)

Persentase traffic yang dikecualikan dari batas frekuensi untuk transaksi dijamin terprogram. Ini adalah bilangan bulat antara 0 dan 100. Nilai 0 (juga nilai default) menunjukkan tidak ada pengecualian, sehingga semua traffic memenuhi syarat untuk pembatasan frekuensi. 100 menunjukkan pengecualian total, sehingga tidak ada pembatasan 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. Wseat yang saat ini memiliki 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, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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 di 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 yang 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, ini menunjukkan 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

Perkiraan 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

Meminta volume untuk sumber inventaris pada hari tertentu.

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

enum (DayOfWeek)

Hari dalam seminggu yang berlaku untuk volume permintaan.
volume

string (int64 format)

Volume permintaan yang diperkirakan untuk hari tertentu dalam seminggu.

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-transfer di tingkat bursa.
publisherConfigs[]

object (PublisherConfig)

Opsional. Konfigurasi untuk penayang.

PublisherConfig

Konfigurasi untuk penayang (publisher_config). Jika publisher_config ditetapkan, materi iklan memerlukan persetujuan pra-pengambilan 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.