Method: exchanges.auctionPackages.patch

更新競價套裝方案。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
auctionPackage.name

string

ID。這個競價套裝方案的相對路徑名稱。格式應為「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 編碼，且不得超過 2,000 個字元。
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)

必填。這項產品的啟用時間。必須早於結束時間。開始時間不得晚於 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。