REST Resource: exchanges.publishers

Resource: Publisher

Mengenkapsulasi satu penayang.

Representasi JSON
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
Kolom
name

string

Hanya output. Nama rute relatif untuk penayang ini. Harus dalam format: "exchanges/{seller_id}/publishers/{publisherId} Contoh: "exchanges/1234/publishers/5678".

externalPublisherId

string

Wajib. [TIDAK DIGUNAKAN LAGI] Kolom ini akan segera diganti dengan externalPublisherIds[]. Ad Exchange memberikan ID penayang unik. Harus cocok dengan ID penayang yang dikirim dalam permintaan bid.

Maksimum 100 karakter. Karakter yang diizinkan adalah alfanumerik, garis bawah, tanda hubung, dan titik.

externalPublisherIds[]

string

Opsional. ID penayang yang diberikan bursa. Setiap ID harus unik dan cocok dengan ID penayang yang dikirim dalam permintaan bid.

Maksimum 10 jumlah. Maksimum 100 karakter per ID. Karakter yang diizinkan adalah alfanumerik, garis bawah, tanda hubung, dan titik.

displayName

string

Wajib. Nama tampilan penayang ini. Harus berenkode UTF-8 dengan ukuran maksimum 30 karakter.

status

enum (DiscoveryObjectStatus)

Wajib. Status penayang ini. Penayang dengan status DIJEDA atau DIHAPUS tidak ditampilkan kepada pengiklan DV3.

mediumCapability

enum (MediumCapability)

Wajib. Media tempat penayang ini berencana menghosting iklannya.

description

string

Wajib. Teks deskripsi untuk penayang ini. Harus berenkode UTF-8 dengan ukuran maksimum 1.000 karakter. Wajib.

contactInfo[]

string

Wajib. Email kontak (POC) untuk pengiklan agar dapat berkomunikasi dengan penayang. Maksimal 10 kontak. Setiap kontak maksimal 100 karakter. Contoh: [Kontak AS - John Smith: john.smith@abc.com]. Wajib.

commitmentCapability[]

enum (CommitmentCapability)

Opsional. Jenis komitmen yang didukung penayang ini.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Wajib. Perincian perkiraan untuk inventaris penayang ini. Pengiklan DV3 dapat melihat dan memfilter perincian ini. Perincian perkiraan domain wajib diisi.

logoUrl

string

Hanya output. URL untuk logo penerbit ini.

floorPrice

object (Money)

Opsional. Harga minimum penerbit ini. Harus memiliki kode mata uang yang sama dengan harga maksimum.

ceilingPrice

object (Money)

Opsional. Harga maksimum penerbit ini. Harus memiliki kode mata uang yang sama dengan harga minimum.

generalCapability

string

Opsional.

tvMetadata

object (TVMetadata)

Opsional. Metadata untuk penayang yang memiliki penawaran TV. Wajib diisi jika kemampuan media berisi TV. Tidak berlaku jika kemampuan media tidak berisi TV.

urgOwners[]

enum (UnderRepresentedGroup)

Opsional. Grup yang kurang terwakili yang anggotanya adalah pemilik, jika ada.

MediumCapability

Enum kemampuan sedang. Frontend Marketplace (dalam Modul Inventaris DV360) menyertakan berbagai bagian untuk inventaris. "Digital: Ini mencakup penayang & paket lelang yang mencakup inventaris Display, Video (termasuk CTV & OTT), dan Audio." "TV: Ini adalah bagian khusus yang baru diluncurkan untuk menemukan inventaris CTV & OTT. CTV & OTT ditentukan sebagai berikut: "TV yang Terhubung (CTV) mencakup semua perangkat yang sesuai dengan deskripsi berikut: - Perangkat yang Terhubung atau Streaming: Perangkat yang terhubung ke layar TV untuk menampilkan streaming video (Roku, Apple TV, dll.) - Smart TV: TV dengan koneksi Internet terintegrasi (Samsung Smart TV, dll.) - Konsol game: Konsol game yang terhubung ke internet (Xbox, PlayStation, Wii, dll.) - Set top box: Perangkat yang menayangkan konten TV kabel tradisional dan video on demand." "Over the Top (OTT) adalah konten video seperti TV yang dikirimkan oleh penyedia video melalui Internet di luar jaringan tertutup penyedia telekomunikasi dan kabel. Video OTT dapat ditonton di desktop, perangkat seluler, tablet, serta perangkat CTV atau STB (asalkan konten dikirimkan melalui IP untuk perangkat STB). "Audio: Ini adalah bagian khusus yang baru diluncurkan untuk inventaris audio." "OOH: Penayang digital luar ruangan."

Enum
MEDIUM_CAPABILITY_UNSPECIFIED Kemampuan sedang tidak ditentukan. Input tidak valid.
MEDIUM_CAPABILITY_DIGITAL Digital dengan kemampuan sedang.
MEDIUM_CAPABILITY_TV TV dengan kemampuan sedang.
MEDIUM_CAPABILITY_AUDIO Audio dengan kemampuan sedang.
MEDIUM_CAPABILITY_OOH Kemampuan sedang di luar rumah.

CommitmentCapability

Enum kemampuan komitmen.

Enum
COMMITMENT_CAPABILITY_UNSPECIFIED Kemampuan komitmen tidak ditentukan. Input tidak valid.
COMMITMENT_CAPABILITY_GUARANTEED Penayang memiliki inventaris yang dijamin.
COMMITMENT_CAPABILITY_NON_GUARANTEED Penerbit memiliki inventaris tanpa jaminan.

TVMetadata

Metadata untuk penayang yang memiliki penawaran TV.

Representasi JSON
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
Kolom
tvDeliveryType

enum (TVDeliveryType)

Wajib. Jenis penayangan iklan TV.

topShows[]

string

Opsional. Daftar judul acara TV teratas yang dimiliki oleh penayang. Ukuran maksimum 10. Harus berenkode UTF-8.

TVDeliveryType

Enum jenis pengiriman TV.

Enum
TV_DELIVERY_TYPE_UNSPECIFIED Jenis pengiriman TV tidak ditentukan. Input tidak valid.
TV_DELIVERY_TYPE_CTV Jenis penayangan TV TV yang terhubung.
TV_DELIVERY_TYPE_LINEAR_TV Jenis penayangan TV, TV linear.

Metode

create

Membuat penayang baru.

get

Mendapatkan penayang.

list

Mencantumkan penayang.

patch

Memperbarui penayang.
Upload Logo penerbit.