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/{販売者 ID}/publishers/{パブリッシャー ID}」にする必要があります。例: 「exchanges/1234/publishers/5678」。
externalPublisherId

string

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

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

string

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

最大 10 回。ID あたり最大 100 文字。使用できる文字は、英数字、アンダースコア、ダッシュ、ドットです。
displayName

string

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

enum (DiscoveryObjectStatus)

必須。このパブリッシャーのステータス。ステータスが PAUSED または REMOVED のパブリッシャーは、DV3 広告主に表示されません。
mediumCapability

enum (MediumCapability)

必須。このニュース メディアが広告を掲載する予定のメディア。
description

string

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

string

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

enum (CommitmentCapability)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

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

object (Money)

省略可。このパブリッシャーの最小価格。上限価格と同じ通貨コードが必要です。
ceilingPrice

object (Money)

省略可。このパブリッシャーの最高価格。最小価格と同じ通貨コードが必要です。
generalCapability

string

省略可。自由形式のテキストによる一般的な説明。最大サイズが 200 文字の UTF-8 でエンコードする必要があります。この説明は、SOV（広告シェア）、CPD、ボリューム保証などです。説明の例: 「CPD、高インパクト、平均視認率 69%」
tvMetadata

object (TVMetadata)

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

enum (UnderRepresentedGroup)

省略可。オーナーが所属するマイノリティ グループ（該当する場合）。

MediumCapability

中程度の機能の列挙型。マーケットプレイスのフロントエンド（ディスプレイ＆ビデオ 360 の広告枠モジュール内）には、広告枠のさまざまなセクションが含まれています。「デジタル: ディスプレイ、動画（CTV、OTT を含む）、オーディオの広告枠にまたがるパブリッシャーとオークション パッケージが含まれます。」「テレビ: CTV と OTT の広告枠を見つけるための専用セクションが新たに導入されました。CTV と OTT は次のように定義されています。「コネクテッド テレビ（CTV）には、以下に該当するすべてのデバイスが含まれます。- インターネット接続デバイスまたはストリーミング デバイス: テレビ画面に接続して動画ストリームを表示するデバイス（Roku、Apple TV など）- スマートテレビ: インターネット接続機能を持つテレビ（Samsung Smart TV など）- ゲーム機: インターネットに接続されたゲーム機（Xbox、PlayStation、Wii など）- セットトップ ボックス: 従来のケーブルテレビやビデオ オンデマンドのコンテンツを配信するデバイス。」「オーバー ザ トップ（OTT）」とは、通信事業者やケーブルテレビ事業者の閉鎖型ネットワーク外で、動画プロバイダがインターネット経由で配信するテレビのような動画コンテンツを意味します。OTT 動画は、パソコン、モバイル、タブレット、CTV デバイス、STB デバイスで視聴できます（後者の場合は、コンテンツが 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 テレビ配信タイプが地上波 TV。

メソッド

create

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

get

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

list

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

patch

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