REST Resource: exchanges.inventorySources

リソース: InventorySource

ディスプレイ＆ビデオ 360 広告枠ソースの実行モデル。

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

string

出力専用。注文の相対リソース名。サーバーによって生成されます。例: 「exchanges/1234/inventorySources/5678」
buyerStatus

enum (BuyerStatus)

出力専用。購入者のステータス。
sellerStatus

enum (SellerStatus)

販売者のステータス。
transactionType

enum (TransactionType)

出力専用。商品取引の種類。
pricingType

enum (PricingType)

出力専用。商品の料金タイプ。
rateDetails

object (RateDetails)

出力専用。料金の詳細。
startTime

string (Timestamp format)

出力専用。この商品が有効になる日時。endTime より前の日時を指定してください。開始時間は 1 年以上先の日時を指定することはできません。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

出力専用。この商品が非アクティブになる日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

エクスチェンジから提供された 1 日あたりの取引量の予測。ペースを決定し、購入者の選択を可能にするために使用されます。このフィールドのサポートは終了しています。
audienceMatchRate

number

出力専用。オーディエンス ターゲティングを使用したプログラマティック保証型取引のオーディエンス マッチ率の予測値。エクスチェンジが追加で送信するリクエストの数を決定するために使用されます。これは 0 ～ 1 の小数値で、その逆数をインプレッションの乗数として使用します。0 は、フィールドが未設定で、オーディエンス ターゲティングが設定されていないことを示します。例: 0.125。これは、リクエストの 12.5% がオーディエンス ターゲティングと一致していることを示しています。送信されるリクエストの量は、交渉されたインプレッション数の 8 倍にする必要があります。
makegoodRequested

boolean

出力専用。購入者から埋め合わせ広告がリクエストされたかどうかを示します。
makegoodRequestedReason

string

出力専用。購入者から提供された、埋め合わせ広告がリクエストされた理由。
percentFrequencyCapExcludedTraffic

string (int64 format)

プログラマティック保証型取引のフリークエンシー キャップから除外されるトラフィックの割合。0 ～ 100 の整数です。値 0（デフォルト値）は除外なしを意味し、すべてのトラフィックがフリークエンシー キャップの対象となります。値 100 は完全な除外を意味し、フリークエンシー キャップは適用されません。0 ～ 100 の値を指定すると、一部が除外されます。たとえば、値を 20 にすると、トラフィックの 20% がフリークエンシー キャップから除外されます。
dv360WseatId[]

string (int64 format)

出力専用。現在、広告在庫ソースに対する権限が付与されている wseat。
lastModifiedTime

string (Timestamp format)

出力専用。広告枠ソースが最後に更新された日時。なお、DV3 の内部更新によっては、最終更新日時が変更される場合があります。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
creativeApprovalConfig

object (CreativeApprovalConfig)

省略可。クリエイティブの承認の設定。承認は、エクスチェンジ レベルまたはパブリッシャー レベルで必要になる場合があります。

BuyerStatus

購入者のステータス。

列挙型
BUYER_STATUS_UNSPECIFIED 購入者のステータスは指定されていません。入力値が無効です。
BUYER_STATUS_ACTIVE 購入者のステータスが有効である。広告申込情報に割り当てられており、有効なクリエイティブが割り当てられている。
BUYER_STATUS_PENDING 購入者のステータスは保留中です。このステータスは、取引が有効ではなく、購入者が特定の操作を行う必要があることを意味します。
BUYER_STATUS_PAUSED 購入者ステータスが「購入者によって一時停止されました」の場合。

SellerStatus

販売者のステータス。

列挙型
SELLER_STATUS_UNSPECIFIED 販売者のステータスは未指定です。予期しない値で、交渉ステータスが不明であることを示します。入力値が無効です。
SELLER_STATUS_ACTIVE 販売者のステータスが有効である。広告枠ソースがエクスチェンジ側で有効になっている。
SELLER_STATUS_PAUSED 販売者のステータスが一時停止中。

InventorySourceVolumeForecast

広告枠ソースの 1 日あたりのリクエスト数の予測。次の検証ルールが適用されます。- 曜日ごとにエントリを指定する必要があります。- 量は正の値にする必要があります。- timeZoneId は必須で、有効な値にする必要があります。

JSON 表現 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
フィールド
dailyVolumes[]

object (DailyVolume)

1 日のボリュームの予測。
timeZoneId

string

1 日あたりのボリュームに使用される IANA タイムゾーン データベースのタイムゾーン（例: "America/New_York"）。

DailyVolume

特定の日の広告枠ソースのリクエスト数。

JSON 表現 
{
  "day": enum (DayOfWeek),
  "volume": string
}
フィールド
day

enum (DayOfWeek)

リクエスト数が適用される曜日。
volume

string (int64 format)

指定した曜日のリクエスト数の予測値。

DayOfWeek

曜日を表します。

列挙型
DAY_OF_WEEK_UNSPECIFIED 曜日は指定されていません。
MONDAY 月曜日
TUESDAY 火曜日
WEDNESDAY Wednesday
THURSDAY 木曜日
FRIDAY 金曜日
SATURDAY 土曜日
SUNDAY 日曜日

CreativeApprovalConfig

クリエイティブの承認の設定。

JSON 表現 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
フィールド
requiresExchangeApproval

boolean

必須。クリエイティブにエクスチェンジ レベルの事前取り込み承認が必要かどうかを示します。
publisherConfigs[]

object (PublisherConfig)

省略可。パブリッシャーの設定。

PublisherConfig

パブリッシャーの設定（publisher_config）。publisher_config が設定されている場合、クリエイティブにはパブリッシャー レベルの事前取り込み承認が必要です。

JSON 表現 
{
  "publisherId": string,
  "publisherDisplayName": string
}
フィールド
publisherId

string

必須。パブリッシャー ID。
publisherDisplayName

string

必須。パブリッシャー名。

メソッド

get

 広告枠ソースを取得します。

list

 広告枠ソースを一覧表示します。

patch

 広告枠ソースを更新します。