REST Resource: products

リソース: Product

単一の商品。

JSON 表現
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "creativeSpecifications": [
    {
      object (CreativeSpecification)
    }
  ],
  "bookingLeadTime": string,
  "assignmentLeadTime": string,
  "minFlightDuration": string,
  "maxFlightDuration": string,
  "slotDuration": string,
  "createTime": string,
  "updateTime": string,
  "currencyCode": string
}
フィールド
name

string

商品のリソース名。形式は products/{id} です。例: products/product123

externalId

string

省略可。このエンティティを外部ソースにマッピングするために使用される ID。

displayName

string

必須。商品の表示名。

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

description

string

省略可。商品を説明する追加の自由形式フィールド。

labels

map (key: string, value: string)

省略可。この商品を説明する自由形式のラベルのセット。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

creativeSpecifications[]

object (CreativeSpecification)

必須。この商品で配信できるクリエイティブのリストです。

bookingLeadTime

string (Duration format)

必須。商品の予約に必要なリードタイム。現在 + 予約リードタイムは掲載期間の開始後である必要があります。

小数点以下 9 桁まで、「s」で終わる秒単位の期間(例: "3.5s")。

assignmentLeadTime

string (Duration format)

必須。クリエイティブの割り当てに必要なリードタイム。

小数点以下 9 桁まで、「s」で終わる秒単位の期間(例: "3.5s")。

minFlightDuration

string (Duration format)

省略可。このアイテムの最小掲載期間。

小数点以下 9 桁まで、「s」で終わる秒単位の期間(例: "3.5s")。

maxFlightDuration

string (Duration format)

必須。この商品の最大掲載期間です。

小数点以下 9 桁まで、「s」で終わる秒単位の期間(例: "3.5s")。

slotDuration

string (Duration format)

必須。この商品のスロット期間。

小数点以下 9 桁まで、「s」で終わる秒単位の期間(例: "3.5s")。

createTime

string (Timestamp format)

出力専用。商品の作成タイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

出力専用。商品の最終更新タイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

currencyCode

string

ISO 4217 で定義されている大文字 3 文字の通貨コード。

メソッド

create

新しい商品を作成します。

get

個々の商品を取得します。

list

商品を一覧表示します。

patch

既存の商品を更新します。