REST Resource: partners.inventorySources

リソース: InventorySource

広告在庫ソース。

JSON 表現 
{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
フィールド
name

string

出力専用。広告在庫ソースのリソース名。
inventorySourceId

string (int64 format)

出力専用。広告在庫ソースの一意の ID。システムによって割り当てられます。
displayName

string

広告在庫ソースの表示名。

UTF-8 でエンコードされ、最大サイズが 240 バイトである必要があります。
inventorySourceType

enum (InventorySourceType)

広告在庫ソースのタイプを示します。
inventorySourceProductType

enum (InventorySourceProductType)

出力専用。広告在庫ソースの商品タイプ。広告枠の販売方法を示します。
commitment

enum (InventorySourceCommitment)

広告枠ソースの配信が保証型か非保証型か。
deliveryMethod

enum (InventorySourceDeliveryMethod)

広告在庫ソースの配信方法。

  • 非保証型の広告在庫ソースの場合、許容される値は INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC のみです。
  • 保証型広告枠ソースの場合、指定できる値は INVENTORY_SOURCE_DELIVERY_METHOD_TAG と INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC です。
dealId

string

エクスチェンジ スペースで広告在庫ソースを一意に識別する ID。

各エクスチェンジ内の購入者間で一意である必要がありますが、エクスチェンジ間で一意である必要はありません。
status

object (InventorySourceStatus)

広告在庫ソースのステータス設定。
exchange

enum (Exchange)

広告在庫ソースが属するエクスチェンジ。
updateTime

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"。
rateDetails

object (RateDetails)

必須。広告在庫ソースのレートの詳細。
publisherName

string

広告在庫ソースのパブリッシャー/販売者の名前。
timeRange

object (TimeRange)

この広告枠ソースの配信が開始および停止される期間。
creativeConfigs[]

object (CreativeConfig)

広告在庫ソースのクリエイティブ要件。

オークション パッケージには適用されません。
guaranteedOrderId

string

変更不可。この広告在庫ソースが属する保証型取引オーダーの ID。

commitment が INVENTORY_SOURCE_COMMITMENT_GUARANTEED の場合にのみ適用されます。
readWriteAccessors

object (InventorySourceAccessors)

広告枠ソースに対する読み取り/書き込み権限を持つパートナーまたは広告主。

commitment が INVENTORY_SOURCE_COMMITMENT_GUARANTEED の場合のみ出力されます。この場合、読み取り/書き込みアクセサは親の保証型取引から継承されます。

commitment が INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED の場合は必須。

commitment が INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED で、このフィールドにパートナーが設定されている場合、このパートナーに属するすべての広告主は、広告在庫ソースに対する読み取り専用アクセス権を自動的に取得します。これらの広告主は readAdvertiserIds に含まれません。
readAdvertiserIds[]

string (int64 format)

出力専用。広告枠ソースに対する読み取り専用アクセス権を持つ広告主の ID。
readPartnerIds[]

string (int64 format)

出力専用。広告在庫ソースへの読み取り専用アクセス権を持つパートナーの ID。

このフィールドのパートナーのすべての広告主は、広告在庫ソースに対する読み取り専用権限を継承します。

メソッド

get

 広告在庫ソースの取引を取得します。

list

 広告在庫ソースの取引を一覧表示します。