Method: exchanges.auctionPackages.patch

Cập nhậ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

Tên tuyến 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". Chỉ có đầu ra.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có 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

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ự. Bắt buộc.
auctionPackage.status

enum (DiscoveryObjectStatus)

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

string

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ự. Bắt buộc.
auctionPackage.format

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

Bảng chi tiết dự báo cho 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 những bảng chi tiết này. Không bắt buộc.
auctionPackage.externalDealId

string

Mã giao dịch trao đổi được dùng trong yêu cầu giá thầu. Tối đa 100 ký tự. Các ký tự được phép sử dụng là chữ-số, dấu gạch dưới, dấu gạch nối và dấu chấm. Bắt buộc. Bắt buộc. Không cho 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.

Chỉ có đầu ra.
auctionPackage.floorPrice

object (Money)

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

string (Timestamp format)

Thời điểm 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 quá 1 năm nữa. Bắt buộc.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời 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)

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

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời 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 thiểu số mà chủ sở hữu là thành viên (nếu có).
updateMask

string (FieldMask format)

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

Đây là danh sách tên trường đủ điều kiện đượ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 trang web thương mại.

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 phiên bản 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.