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。