Method: exchanges.auctionPackages.patch

オークション パッケージを更新します。

HTTP リクエスト

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
auctionPackage.name

string

このオークション パッケージの相対ルート名。形式は「exchanges/{seller_id}/auctionpackages/{auction_package_id}」です。例: 「exchanges/1234/auctionPackage/5678」出力専用。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
フィールド
auctionPackage.displayName

string

このオークション パッケージの表示名。UTF-8 でエンコードし、最大サイズは 240 文字にする必要があります。必須。
auctionPackage.status

enum (DiscoveryObjectStatus)

このオークション パッケージのステータス。ステータスが [一時停止中] または [削除済み] のパッケージは、ディスプレイ＆ビデオ 360 の広告主には表示されません。必須。
auctionPackage.description

string

このパッケージの説明テキスト。UTF-8 でエンコードし、最大サイズは 2,000 文字にする必要があります。必須。
auctionPackage.format

enum (Format)

基盤となる広告フォーマットのタイプ。必須。作成後に更新することはできません。
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

このオークション パッケージの広告枠の予測の内訳。DV3 の広告主様は、これらの内訳を表示してフィルタできます。省略可。
auctionPackage.externalDealId

string

入札リクエストで使用されるエクスチェンジ取引 ID。最大半角 100 文字。使用できる文字は、英数字、アンダースコア、ダッシュ、ドットです。必須。必須。作成後に更新を許可しない。
auctionPackage.logoUrl

string

出力専用。このオークション パッケージのロゴの URL。

出力専用。
auctionPackage.floorPrice

object (Money)

このオークション パッケージの最小価格。必須。
auctionPackage.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"。
auctionPackage.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"。
auctionPackage.mediumType

enum (MediumType)

必須。オークション パッケージのメディアタイプ。
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

省略可。オーナーがメンバーとなっている、代表性の低いグループ（存在する場合）。
updateMask

string (FieldMask format)

どのフィールドを更新するかを制御するマスク。必須。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。
auctionPackage.dv3MarketplaceUri

string

出力専用。マーケットプレイスのオークション パッケージの Dv360 リンク。

レスポンスの本文

成功した場合、レスポンスの本文には AuctionPackage のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/doubleclickbidmanager

詳細については、OAuth 2.0 Overview をご覧ください。