Method: exchanges.auctionPackages.patch

更新竞价包。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
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)

此竞价包的状态。状态为“已暂停”或“已移除”的文件包不会向 DV3 广告客户显示。必填。
auctionPackage.description

string

此软件包的说明文本。必须采用 UTF-8 编码，且大小不得超过 2000 个字符。必填。
auctionPackage.format

enum (Format)

底层广告格式类型。必需。创建后不允许更新。
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

此竞价包广告资源的预测明细。DV3 广告客户可以查看这些细分数据并按这些维度进行过滤。可选。
auctionPackage.externalDealId

string

出价请求中使用的广告交易平台交易 ID。最多 100 个字符。允许的字符包括字母数字、下划线、短划线和英文句点。必需。必需。创建后不允许更新。
auctionPackage.logoUrl

string

仅限输出。此竞价包徽标的网址。

仅限输出。
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。