Method: sellers.orders.list

Liệt kê đơn đặt hàng.

  • Ví dụ: GET /v1/sellers/321/order
  • Trả về danh sách đơn đặt hàng và mã thông báo để truy xuất trang tiếp theo nếu thành công.
  • Trả về mã lỗi PERMISSION_DENIED nếu người dùng không có quyền truy cập vào mã người bán hoặc mã người bán không tồn tại.
  • Trả về mã lỗi INVALID_ARGUMENT nếu người bán cung cấp kích thước trang hoặc mã thông báo trang không hợp lệ.

Yêu cầu HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/orders

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

Tham số đường dẫn

Tham số
parent

string

Bắt buộc. Nhà xuất bản mẹ sở hữu tập hợp đơn đặt hàng này. Định dạng: người bán/{seller}

Tham số truy vấn

Tham số
pageSize

integer

Số lượng mục tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Số lượng đơn đặt hàng tối đa được phép là 1.000. Nếu bạn không xác định, đơn đặt hàng sẽ được trả lại tối đa 1.000 đơn đặt hàng.
pageToken

string

Giá trị nextPageToken được trả về từ một yêu cầu Danh sách trước đó (nếu có).
filter

string

Bộ lọc danh sách. Hiện hỗ trợ mã nhận dạng bên ngoài và tính năng lọc trạng thái, với cú pháp: "externalId = [EXTERNAL_ID]" và "state = [STATE]". Bạn có thể sử dụng các toán tử logic AND và OR để liên kết bộ lọc.
orderBy

string

Thứ tự theo chuỗi được dùng để chỉ định thứ tự sắp xếp của các kết quả. Hiện hỗ trợ sắp xếp theo updateTime, hãy cung cấp "updateTime" để nhận kết quả được sắp xếp theo updateTime theo thứ tự tăng dần hoặc "theo mô tả updateTime" theo thứ tự giảm dần.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "orders": [
    {
      object (Order)
    }
  ],
  "nextPageToken": string
}
Trường
orders[]

object (Order)

Danh sách đơn đặt hàng.
nextPageToken

string

Mã thông báo để truy xuất trang kết quả tiếp theo. Truyền giá trị này vào trường pageToken trong lệnh gọi tiếp theo đến phương thức orders.list để truy xuất trang kết quả tiếp theo.

Phạm vi cấp phép

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 bài viết Tổng quan về OAuth 2.0.