REST Resource: exchanges.publishers

リソース: Publisher

単一のパブリッシャーをカプセル化します。

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)
  ]
}
フィールド
name

string

出力専用。このパブリッシャーの相対ルート名。形式は「exchanges/{seller_id}/publishers/{publisherId}」です。例: 「exchanges/1234/publishers/5678」
externalPublisherId

string

必須。[非推奨] このフィールドはまもなく externalPublisherIds[] に置き換えられます。Exchange が提供する一意のパブリッシャー ID。入札リクエストで送信されたパブリッシャー ID と一致している必要があります。

最大半角 100 文字。使用できる文字は、英数字、アンダースコア、ダッシュ、ドットです。
externalPublisherIds[]

string

省略可。エクスチェンジ提供のパブリッシャー ID。各 ID は一意で、入札リクエストで送信されたパブリッシャー ID と一致している必要があります。

最大 10 個。ID ごとに最大 100 文字。使用できる文字は、英数字、アンダースコア、ダッシュ、ドットです。
displayName

string

必須。このパブリッシャーの表示名。UTF-8 でエンコードし、最大サイズは 30 文字にする必要があります。
status

enum (DiscoveryObjectStatus)

必須。このパブリッシャーのステータス。ステータスが [一時停止中] または [削除済み] のニュース メディアは、DV3 の広告主には表示されません。
mediumCapability

enum (MediumCapability)

必須。このパブリッシャーが広告をホストする予定のメディア。
description

string

必須。このパブリッシャーの説明テキスト。UTF-8 でエンコードし、最大サイズは 1,000 文字にする必要があります。必須。
contactInfo[]

string

必須。広告主がパブリッシャーとやり取りする際の連絡先メールアドレス。連絡先は 10 件まで。各連絡先の最大文字数は 100 文字です。例: [US contact - John Smith: john.smith@abc.com]。必須。
commitmentCapability[]

enum (CommitmentCapability)

省略可。このパブリッシャーがサポートするコミットメント タイプ。
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

必須。このパブリッシャーの広告枠の予測の内訳。DV3 の広告主様は、これらの内訳を表示してフィルタできます。ドメインの予測の内訳は必須です。
logoUrl

string

出力専用。このパブリッシャーのロゴの URL。
floorPrice

object (Money)

省略可。このパブリッシャーの最小価格。上限価格と同じ通貨コードを使用する必要があります。
ceilingPrice

object (Money)

省略可。このパブリッシャーの上限価格。最低価格と同じ通貨コードを使用する必要があります。
generalCapability

string

省略可。
tvMetadata

object (TVMetadata)

省略可。テレビ コンテンツを提供するパブリッシャーのメタデータ。メディアの機能にテレビが含まれている場合は必須です。メディアの機能にテレビが含まれていない場合は適用されません。
urgOwners[]

enum (UnderRepresentedGroup)

省略可。オーナーがメンバーとなっている、代表性の低いグループ（存在する場合）。

MediumCapability

中程度の機能の列挙型。マーケットプレイスのフロントエンド（DV360 の広告枠モジュール内）には、広告枠に関するさまざまなセクションがあります。「デジタル: ディスプレイ広告枠、動画広告枠（コネクテッド テレビと OTT を含む）、オーディオ広告枠をまたぐパブリッシャーとオークション パッケージが含まれます。」「TV: コネクテッド テレビと OTT の広告枠を探すための専用セクションです。コネクテッド テレビと OTT は次のように定義されています。「コネクテッド テレビ（CTV）には、以下の説明に該当するすべてのデバイスが含まれます。- コネクテッド デバイスまたはストリーミング デバイス: テレビ画面に接続して動画ストリームを表示するデバイス（Roku、Apple TV など）。- スマートテレビ: インターネット接続機能が搭載されているテレビ（Samsung スマートテレビなど）- ゲーム機: インターネットに接続されたゲーム機（Xbox、PlayStation、Wii など）- セットトップ ボックス: 従来のケーブルテレビやビデオ オンデマンドのコンテンツを配信するデバイス。」「オーバー ザ トップ（OTT）」とは、通信会社やケーブル プロバイダのクローズド ネットワークの外部から、動画プロバイダがインターネット経由で配信するテレビのような動画コンテンツを意味します。OTT 動画は、パソコン、モバイル、タブレット、コネクテッド テレビやセットトップ ボックス デバイス（後者の場合はコンテンツが IP 経由で配信されている場合）で視聴できます。「オーディオ: オーディオ広告枠専用の新セクションです。」「OOH: デジタル屋外広告パブリッシャー」

列挙型
MEDIUM_CAPABILITY_UNSPECIFIED 中程度の機能は指定されていません。有効な入力ではありません。
MEDIUM_CAPABILITY_DIGITAL 中程度のデジタル機能。
MEDIUM_CAPABILITY_TV 中程度の機能のテレビ。
MEDIUM_CAPABILITY_AUDIO 中程度の機能のオーディオ。
MEDIUM_CAPABILITY_OOH 中程度の機能の屋外広告。

CommitmentCapability

コミットメント機能の列挙型。

列挙型
COMMITMENT_CAPABILITY_UNSPECIFIED コミットメント機能が指定されていません。有効な入力ではありません。
COMMITMENT_CAPABILITY_GUARANTEED パブリッシャーが保証型の広告枠を保有している。
COMMITMENT_CAPABILITY_NON_GUARANTEED パブリッシャーが非保証型の広告枠を所有している。

TVMetadata

テレビ サービスを提供するパブリッシャーのメタデータ。

JSON 表現 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
フィールド
tvDeliveryType

enum (TVDeliveryType)

必須。テレビ広告の配信タイプ。
topShows[]

string

省略可。パブリッシャーが所有する人気テレビ番組のタイトルのリスト。最大サイズは 10 です。UTF-8 でエンコードする必要があります。

TVDeliveryType

テレビ配信タイプの列挙型。

列挙型
TV_DELIVERY_TYPE_UNSPECIFIED テレビ配信タイプが指定されていません。有効な入力ではありません。
TV_DELIVERY_TYPE_CTV テレビ配信タイプがコネクテッド テレビ。
TV_DELIVERY_TYPE_LINEAR_TV テレビ配信タイプはリニアテレビです。

メソッド

create

 新しいニュース メディアを作成します。

get

 パブリッシャーを取得します。

list

 パブリッシャーを一覧表示します。

patch

 パブリッシャーを更新します。
ニュース メディアのロゴをアップロードします。