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)

出力専用。広告在庫ソースが最後に更新された時刻。ディスプレイ＆ビデオ 360 の内部更新により、最終更新時刻が変更されることがあります。

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 日あたりのリクエスト数の予測。次の検証ルールが適用されます。 - 曜日ごとにエントリを指定する必要があります - ボリュームは 0 以上である必要があります - 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

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