REST Resource: exchanges.auctionPackages

Tài nguyên: AuctionPackage

Đóng gói một gói đấu giá duy nhất. Nhà quảng cáo trong DV3 có thể duyệt xem tất cả cá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 bên bán thực hiệ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

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". Chỉ có đầu ra.
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ự. Bắt buộc.
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. Bắt buộc.
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ự. Bắt buộc.
format

enum (Format)

Bắt buộc. Không thể thay đổi. Loại định dạng quảng cáo cơ bản. Bắt buộc. Không được phép cập nhật sau khi tạo.
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. Không bắt buộc.
externalDealId

string

Bắt buộc. Không thể thay đổi. Mã giao dịch trên 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. 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)

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

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".
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. Bắt buộc.

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".
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 chưa được đại diện 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 thẻ Marketplace.

Định dạng

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

Enum
DEAL_FORMAT_UNSPECIFIED Chưa chỉ định định dạng thoả thuận. Không hợp lệ đối với thông tin đầu vào.
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 một 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 một gói đấu giá.
Tải biểu trưng lên cho gói đã chỉ định.