REST Resource: exchanges.auctionPackages

Tài nguyên: AuctionPackage

Đóng gói một gói đấu giá. Nhà quảng cáo trong DV3 có thể duyệt xem tất cả gói đấu giá trong DV3 thông qua giao diện người dùng khám phá thị trường và chọn sử dụng các gói này mà không cần người bán hành động.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "description": string,
  "format": enum (Format),
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "externalDealId": string,
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "startTime": string,
  "endTime": string,
  "mediumType": enum (MediumType),
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ],
  "dv3MarketplaceUri": string
}
Trường
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.
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.
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.
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.
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.
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.
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.
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.
floorPrice

object (Money)

Giá sàn của gói đấu giá này. Bắt buộc.
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".
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".
mediumType

enum (MediumType)

Bắt buộc. Loại phương tiện của gói đấu giá.
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ó).
dv3MarketplaceUri

string

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

Định dạng

Định dạng quảng cáo cho gói đấu giá.

Enum
DEAL_FORMAT_UNSPECIFIED Chưa xác định định dạng thoả thuận. Không hợp lệ để nhập.
DEAL_FORMAT_DISPLAY Định dạng hiển thị.
DEAL_FORMAT_VIDEO Định dạng video.
DEAL_FORMAT_AUDIO Định dạng âm thanh.

Phương thức

create

 Tạo gói đấu giá mới.

get

 Lấy một gói đấu giá.

list

 Liệt kê các gói đấu giá.

patch

 Cập nhật gói đấu giá.
Tải biểu trưng lên cho gói đã chỉ định.