Method: exchanges.orders.patch

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

Yêu cầu HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{order.name=exchanges/*/orders/*}

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

Tham số đường dẫn

Thông số
order.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.

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 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "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.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
Trường
order.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.
order.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.
order.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.
order.publisherName

string

Tên nhà xuất bản. Tối đa 250 ký tự. Bắt buộc.
order.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ì.
order.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.
order.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.
order.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".
order.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ì.
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 đủ đ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"

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 Order.

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.