Method: exchanges.auctionPackages.patch

Cập nhật một gói đấu giá.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
auctionPackage.name

string

Giá trị nhận dạng. Tên tuyến đường tương đối cho gói đấu giá này. Phải có dạng: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Ví dụ: "exchanges/1234/auctionPackage/5678".

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng 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
}
Trường
auctionPackage.displayName

string

Bắt buộc. Tên hiển thị của gói đấu giá này. Phải được mã hoá UTF-8 với kích thước tối đa là 240 ký tự.
auctionPackage.status

enum (DiscoveryObjectStatus)

Bắt buộc. Trạng thái của gói đấu giá này. Các gói có trạng thái ĐÃ TẠM DỪNG hoặc ĐÃ XOÁ sẽ không xuất hiện với nhà quảng cáo DV3.
auctionPackage.description

string

Bắt buộc. Văn bản mô tả cho gói này. Phải được mã hoá UTF-8 với kích thước tối đa là 2.000 ký tự.
auctionPackage.format

enum (Format)

Bắt buộc. Không thể thay đổi. Loại định dạng quảng cáo cơ bản. Không được phép cập nhật sau khi tạo.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Không bắt buộc. Bảng chi tiết dự báo về khoảng không quảng cáo của gói đấu giá này. Nhà quảng cáo DV3 có thể xem và lọc theo các thông tin chi tiết này.
auctionPackage.externalDealId

string

Bắt buộc. Không thể thay đổi. Mã giao dịch của sàn giao dịch được dùng trong các yêu cầu giá thầu. Tối đa 100 ký tự. Các ký tự được phép là chữ và số, dấu gạch dưới, dấu gạch ngang và dấu chấm. Không được phép cập nhật sau khi tạo.
auctionPackage.logoUrl

string

Chỉ có đầu ra. URL của biểu trưng của gói đấu giá này.
auctionPackage.floorPrice

object (Money)

Bắt buộc. Giá sàn của gói đấu giá này.
auctionPackage.startTime

string (Timestamp format)

Bắt buộc. Thời gian sản phẩm này bắt đầu hoạt động. Phải sớm hơn endTime. Thời gian bắt đầu không được cách thời điểm hiện tại quá 1 năm.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
auctionPackage.endTime

string (Timestamp format)

Bắt buộc. Thời gian sản phẩm này chuyển sang trạng thái không hoạt động.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
auctionPackage.mediumType

enum (MediumType)

Bắt buộc. Loại phương tiện của gói đấu giá.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

Không bắt buộc. Các nhóm chưa được đại diện mà chủ sở hữu là thành viên (nếu có).
updateMask

string (FieldMask format)

Không bắt buộc. Mặt nạ để kiểm soát những trường cần cập nhật.

Đây là danh sách tên đủ điều kiện của các trường được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
auctionPackage.dv3MarketplaceUri

string

Chỉ có đầu ra. Đường liên kết Dv360 cho gói đấu giá trong thẻ Marketplace.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của AuctionPackage.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.