REST Resource: availabilityOrders

Tài nguyên: availabilityOrder

Đơn đặt hàng về tình trạng còn hàng là một tập hợp của AvailabilityLines. Đơn đặt hàng về tình trạng còn hàng do người mua tạo. Người bán cập nhật tình trạng còn hàng cùng với phản hồi.

Quy trình công việc như sau:

  • Người mua tạo đơn đặt hàng và đường kẻ về tình trạng còn hàng rồi đặt trạng thái thành đang chờ xử lý. Không được phép thay đổi thêm cho người mua đối với đơn đặt hàng hoặc dòng về tình trạng còn hàng.
  • Người bán hành động trên tất cả các dòng về tình trạng còn hàng bằng cách hoàn tất với điều khoản về tình trạng còn hàng hoặc đánh dấu là bị từ chối. Bạn chỉ có thể hoàn tất hoặc từ chối hành động khi đơn đặt hàng và các dòng ở trạng thái đang chờ xử lý.
  • Người bán sử dụng hành động tuỳ chỉnh complete để đánh dấu yêu cầu về tình trạng còn hàng là đã hoàn tất. Bạn không được phép thực hiện thêm thay đổi đối với đơn đặt hàng về tình trạng còn hàng hoặc các dòng con sau khi quá trình này hoàn tất.
Biểu diễn dưới dạng JSON 
{
  "name": string,
  "description": string,
  "state": enum (State),
  "pendingExpirationTime": string,
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của đơn đặt hàng về tình trạng còn hàng ở định dạng: availabilityOrders/{id}.
description

string

Chỉ có đầu ra. Trường dạng tự do bổ sung để mô tả đơn đặt hàng về tình trạng còn hàng.
state

enum (State)

Chỉ có đầu ra. Trạng thái của đơn đặt hàng về tình trạng còn hàng này. Hãy xem AvailabilityOrder.State để biết vòng đời của Tình trạng còn hàng (availabilityOrder).

Người bán có thể sử dụng phương thức tuỳ chỉnh Complete để đặt thành STATE_COMPLETED.
pendingExpirationTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian hết hạn của đơn đặt hàng về tình trạng còn hàng đang chờ xử lý. Người bán cần phải hoàn tất trước khi đơn đặt hàng về tình trạng còn hàng đang chờ xử lý hết hạn, nếu không đơn đặt hàng đó sẽ được coi là đã hoàn tất và không có hàng.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian tạo. Do hệ thống chỉ định.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian cập nhật gần đây nhất. Do hệ thống chỉ định.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
advertiserInfo

object (AdvertiserInfo)

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

Tiểu bang

Các giá trị có thể dùng cho trạng thái đơn đặt hàng về tình trạng còn hàng.

Enum
STATE_UNSPECIFIED Giá trị mặc định khi trạng thái đơn đặt hàng về tình trạng còn hàng chưa được chỉ định hoặc không xác định trong phiên bản này.
STATE_PENDING Đang chờ xử lý tình trạng còn hàng khi người mua cung cấp chế độ cài đặt yêu cầu về tình trạng còn hàng.
STATE_COMPLETED Trạng thái tình trạng còn hàng đã hoàn tất khi người bán cung cấp phản hồi về tình trạng còn hàng cho tất cả các dòng.
STATE_CANCELLED Trạng thái tình trạng còn hàng đã bị huỷ khi người mua cung cấp yêu cầu huỷ trước khi người bán cung cấp phản hồi về tình trạng còn hàng cho tất cả các dòng.
STATE_EXPIRED Trạng thái tình trạng còn hàng đã hết hạn khi đơn đặt hàng hết hạn trước khi người bán hoàn tất.

Phương thức

complete

 Đánh dấu một đơn đặt hàng hiện có về tình trạng còn hàng là đã hoàn tất.

get

 Truy xuất đơn đặt hàng về tình trạng còn hàng riêng lẻ.

list

 Liệt kê đơn đặt hàng về tình trạng còn hàng.