REST Resource: exchanges.publishers

Kaynak: Yayıncı

Tek bir yayıncıyı kapsar.

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

string

Yalnızca çıkış. Bu yayıncının göreli rota adı. "exchanges/{seller_id}/publishers/{publisherId}" biçiminde olmalıdır. Örnek: "exchanges/1234/publishers/5678".

externalPublisherId

string

Zorunlu. [DEPRECATED] Bu alan yakında externalPublisherIds[] ile değiştirilecek. Exchange tarafından sağlanan benzersiz yayıncı kimliği. Teklif isteklerinde gönderilen yayıncı kimliğiyle eşleşmelidir.

En fazla 100 karakter. İzin verilen karakterler alfanümerik, alt çizgi, kısa çizgi ve noktadır.

externalPublisherIds[]

string

İsteğe bağlı. Exchange tarafından sağlanan yayıncı kimlikleri. Her kimlik benzersiz olmalı ve teklif isteklerinde gönderilen yayıncı kimliğiyle eşleşmelidir.

En fazla 10 sayı. Kimlik başına en fazla 100 karakter. İzin verilen karakterler alfanümerik, alt çizgi, kısa çizgi ve noktadır.

displayName

string

Zorunlu. Bu yayıncının görünen adı. UTF-8 kodlu olmalı ve en fazla 30 karakter uzunluğunda olmalıdır.

status

enum (DiscoveryObjectStatus)

Zorunlu. Bu yayıncının durumu. DURDURULDU veya KALDIRILDI durumuna sahip yayıncılar DV3 reklamverenlere gösterilmez.

mediumCapability

enum (MediumCapability)

Zorunlu. Bu yayıncının reklamlarını yayınlamayı planladığı medya.

description

string

Zorunlu. Bu yayıncının açıklama metni. UTF-8 kodlu olmalı ve en fazla 1.000 karakter uzunluğunda olmalıdır. Zorunlu.

contactInfo[]

string

Zorunlu. Reklamverenlerin yayıncıyla iletişime geçmesi için iletişime geçilecek kişi e-postaları. En fazla 10 kişi. Her kişi için en fazla 100 karakter. Örnek: [ABD'deki ilgili kişi - Can Demir: can.demir@abc.com]. Zorunlu.

commitmentCapability[]

enum (CommitmentCapability)

İsteğe bağlı. Bu yayıncının desteklediği taahhüt türleri.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Zorunlu. Bu yayıncının envanteri için tahmin dökümü. DV3 reklamverenleri bu dökümleri görebilir ve filtreleyebilir. Alan tahmini dökümü gereklidir.

logoUrl

string

Yalnızca çıkış. Bu yayıncının logosunun URL'si.

floorPrice

object (Money)

İsteğe bağlı. Bu yayıncının taban fiyatı. Tavan fiyatıyla aynı para birimi koduna sahip olmalıdır.

ceilingPrice

object (Money)

İsteğe bağlı. Bu yayıncının tavan fiyatı. Minimum fiyatla aynı para birimi koduna sahip olmalıdır.

generalCapability

string

İsteğe bağlı.

tvMetadata

object (TVMetadata)

İsteğe bağlı. TV teklifleri olan yayıncı için meta veriler. Ortam özelliği TV içeriyorsa gereklidir. Orta kapasite TV içermiyorsa geçerli değildir.

urgOwners[]

enum (UnderRepresentedGroup)

İsteğe bağlı. Sahibinin üyesi olduğu az temsil edilen gruplar (varsa).

MediumCapability

Orta düzey özellik listesi. Pazar Yeri ön uç (DV360'ın envanter modülünde) envanter için farklı bölümler içerir. "Dijital: Görüntülü, video (CTV ve OTT dahil) ve işitsel envanteri kapsayan yayıncılar ve açık artırma paketleri bu kapsamdadır." "TV: CTV ve OTT envanterini keşfetmeye özel olarak yeni kullanıma sunduğumuz bölümdür. CTV ve OTT aşağıdaki şekilde tanımlanır: "Bağlı TV (CTV), aşağıdaki açıklamalara uyan tüm cihazları içerir: - Bağlı veya akış cihazları: Video akışlarını yayınlamak için TV ekranına bağlanan cihazlar (Roku, Apple TV vb.) - Akıllı TV: Entegre internet bağlantısı bulunan TV'ler (Samsung Smart TV vb.) - Oyun konsolları: İnternete bağlı oyun konsolları (Xbox, PlayStation, Wii vb.) - Set üstü kutular: Geleneksel kablolu yayın ve seç-izle video içeriklerinin izlenebildiği cihazlar." "Over the Top (OTT), bir video sağlayıcı tarafından telekom ve kablo sağlayıcıların kapalı ağları dışında internet üzerinden sunulan TV benzeri video içeriği anlamına gelir. OTT video, masaüstü, mobil, tablet ve CTV veya STB cihazlarda (içerik IP üzerinden yayınlandığı sürece) görüntülenebilir. "Ses: Bu, ses envanterine özel olarak yeni kullanıma sunulan bir bölümdür." "OOH: Dijital ev dışı yayıncılar."

Sıralamalar
MEDIUM_CAPABILITY_UNSPECIFIED Orta kapasite belirtilmedi. Geçerli giriş değil.
MEDIUM_CAPABILITY_DIGITAL Orta düzeyde dijital.
MEDIUM_CAPABILITY_TV Orta düzeyde özellikli TV.
MEDIUM_CAPABILITY_AUDIO Orta düzeyde ses kalitesi.
MEDIUM_CAPABILITY_OOH Ev dışı kullanım için orta düzeyde kapasite.

CommitmentCapability

Taahhüt kapasitesi enum.

Sıralamalar
COMMITMENT_CAPABILITY_UNSPECIFIED Taahhüt yeteneği belirtilmedi. Geçerli giriş değil.
COMMITMENT_CAPABILITY_GUARANTEED Yayıncı garantili envantere sahiptir.
COMMITMENT_CAPABILITY_NON_GUARANTEED Yayıncının garanti edilmeyen envanteri var.

TVMetadata

TV teklifleri olan yayıncılar için meta veriler.

JSON gösterimi
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
Alanlar
tvDeliveryType

enum (TVDeliveryType)

Zorunlu. TV reklamlarının yayın türü.

topShows[]

string

İsteğe bağlı. Yayıncının sahip olduğu en popüler TV programlarının listesi. Maksimum boyut 10'dur. UTF-8 kodlu olmalıdır.

TVDeliveryType

TV yayınlama türü sıralaması.

Sıralamalar
TV_DELIVERY_TYPE_UNSPECIFIED TV yayınlama türü belirtilmedi. Geçerli giriş değil.
TV_DELIVERY_TYPE_CTV TV yayını türü bağlı TV.
TV_DELIVERY_TYPE_LINEAR_TV TV yayınlama türü doğrusal TV.

Yöntemler

create

Yeni bir yayıncı oluşturur.

get

Bir yayıncı alır.

list

Yayıncıları listeler.

patch

Bir yayıncıyı günceller.
Yayıncı logosunu yükleyin.