REST Resource: exchanges.orders

Tài nguyên: Đơn đặt hàng

Một phiếu mua hàng không thương lượng được để người mua chấp nhận.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
Trường
name

string

Tên tài nguyên tương đối cho đơn đặt hàng. Do máy chủ tạo. Ví dụ: "exchanges/1234/orders/5678". Chỉ có đầu ra.
displayName

string

Tên của đơn đặt hàng hiển thị cho người mua. Tối đa 250 ký tự. Không bắt buộc.
partnerId[]

string (int64 format)

Mã đối tác trong Google Display & Video 360, trước đây được gọi là Trình quản lý giá thầu của DoubleClick(DBM). Chỉ cho phép một mã đối tác duy nhất. Bắt buộc.
publisherEmail

string

Email của nhà xuất bản. Phải là định dạng email hợp lệ. Tối đa 250 ký tự. Không bắt buộc.
publisherName

string

Tên nhà xuất bản. Tối đa 250 ký tự. Bắt buộc.
budget

object (Budget)

Chỉ có đầu ra. Ngân sách do người mua đặt. Chỉ áp dụng cho các trường hợp Giao dịch tức thì.
status

enum (OrderStatus)

Trạng thái đơn đặt hàng. Trạng thái này có thể thay đổi sau khi người dùng DV3 chấp nhận, huỷ hoặc lưu trữ một đơn đặt hàng. Ngoài ra, hỗ trợ cập nhật thành "CANCELLED" (ĐÃ HUỶ) sau khi tạo trong API để báo hiệu rằng đơn đặt hàng này đã bị huỷ trên Sàn giao dịch.
wseatConfig

object (WSeatConfig)

Không bắt buộc. WSeat Configuration Chỉ định cấu hình WSeat ở phía sàn giao dịch. Những sàn giao dịch sử dụng thoả thuận nhiều chỗ ngồi dự kiến sẽ tiếp tục điền sẵn và cập nhật trường này.
updateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian khi đơn đặt hàng hoặc sản phẩm cơ bản của đơn đặt hàng được cập nhật.

Sử dụng RFC 3339, trong đó đầ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 độ 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".
buyerInfo

object (BuyerInfo)

Chỉ có đầu ra. Thông tin về người mua, bao gồm cả thông tin chi tiết về đối tác và nhà quảng cáo. Chỉ áp dụng cho các trường hợp Giao dịch tức thì.

Ngân sách

Đã chỉ định ngân sách.

Biểu diễn dưới dạng JSON 
{
  "budgetType": enum (BudgetType),

  // Union field budget can be only one of the following:
  "impressions": string,
  "money": {
    object (Money)
  }
  // End of list of possible types for union field budget.
}
Trường
budgetType

enum (BudgetType)

Loại ngân sách được chỉ định.
Trường nhóm budget. Bạn chỉ có thể thêm một loại ngân sách. budget chỉ có thể là một trong những trạng thái sau:
impressions

string (int64 format)

Ngân sách hiển thị.
money

object (Money)

Ngân sách theo đơn vị tiền tệ.

BudgetType

Các loại ngân sách

Enum
BUDGET_TYPE_UNSPECIFIED Ngân sách không được chỉ định. Không hợp lệ đối với thông tin đầu vào.
BUDGET_TYPE_CURRENCY Ngân sách theo đơn vị tiền tệ.
BUDGET_TYPE_IMPRESSION Ngân sách hiển thị.

OrderStatus

Trạng thái của đơn đặt hàng.

Enum
ORDER_STATUS_UNSPECIFIED Trạng thái đơn đặt hàng không xác định. Ngoài dự kiến, trạng thái này cho biết trạng thái thương lượng là không xác định. Giá trị đầu vào không hợp lệ.
PENDING_ACCEPTANCE Đơn đặt hàng đang chờ chấp nhận.
ACCEPTED Trạng thái đơn đặt hàng là đã chấp nhận.
ARCHIVED Đã lưu trữ trạng thái đơn đặt hàng.
CANCELLED Đơn đặt hàng có trạng thái đã huỷ.
NEGOTIATING Trạng thái đơn đặt hàng đang thương lượng. Chỉ áp dụng cho các trường hợp có ưu đãi tức thì.

WSeatConfig

Cấu hình WSeat.

Biểu diễn dưới dạng JSON 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
Trường
exchangeWseatStatus

enum (WSeatStatus)

Không bắt buộc. Trạng thái hiện tại ở phía Exchange cho cấu hình WSeat.
exchangeWseatIds[]

string (int64 format)

Không bắt buộc. Mã WSeat ở phía Sàn giao dịch.
updateTime

string (Timestamp format)

Chỉ có đầu ra. Trường này được DV3 cập nhật tự động khi WSeatConfiguration được sàn giao dịch cập nhật.

Sử dụng RFC 3339, trong đó đầ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 độ 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".

WSeatStatus

Các lựa chọn về enum Trạng thái WSeat.

Enum
W_SEAT_STATUS_UNSPECIFIED WSeatStatus chưa xác định.
W_SEAT_STATUS_ENFORCED WSeatStatus được thực thi. Cho biết Exchange thực thi WSeatId bằng cách gửi WSeatId đến DV3 hoặc xác minh wseatid trong phản hồi giá thầu.
W_SEAT_STATUS_NOT_ENFORCED Không áp dụng WSeatStatus. Cho biết Exchange không gửi wseatid trong yêu cầu giá thầu và không xác thực wseatid trong yêu cầu giá thầu.

BuyerInfo

Thông tin về người mua cho các trường hợp Giao dịch tức thì.

Biểu diễn dưới dạng JSON 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
Trường
partner

object (PartnerInfo)

Chỉ có đầu ra. Thông tin về đối tác.
advertisers[]

object (AdvertiserInfo)

Chỉ có đầu ra. Thông tin về nhà quảng cáo.

PartnerInfo

Thông tin về đối tác cho các trường hợp sử dụng Ưu đãi tức thì.

Biểu diễn dưới dạng JSON 
{
  "title": string
}
Trường
title

string

Chỉ có đầu ra. Tiêu đề hiển thị của đối tác trong Display & Video 360.

AdvertiserInfo

Thông tin về nhà quảng cáo cho các trường hợp sử dụng Ưu đãi tức thì.

Biểu diễn dưới dạng JSON 
{
  "advertiserId": string,
  "domainUri": string
}
Trường
advertiserId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng nhà quảng cáo trong Display & Video 360.
domainUri

string

Chỉ có đầu ra. URI miền của trang web của nhà quảng cáo.

Phương thức

accept

 Chấp nhận đơn đặt hàng.

create

 Tạo đơn đặt hàng.

get

 Nhận đơn đặt hàng.

list

 Thứ tự trong danh sách.

patch

 Cập nhật đơn đặt hàng.