REST Resource: availabilityOrders.availabilityLines

Tài nguyên: availabilityLine

Đường kẻ sẵn có thể hiện một tập hợp các chế độ cài đặt mà người mua yêu cầu tình trạng còn hàng của khoảng không quảng cáo và phản hồi từ người bán. Để biết quy trình làm việc, hãy xem AvailabilityOrder.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "product": string,
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "targeting": {
    object (Targeting)
  },
  "availabilityLineTerms": {
    object (LineTerms)
  },
  "state": enum (State),
  "rejection": {
    object (Rejection)
  },
  "createTime": string,
  "updateTime": string
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của dòng tình trạng hoạt động (availability) ở định dạng: availabilityOrders/123/availabilityLines/321.
product

string

Chỉ có đầu ra. Tên của Product mà yêu cầu về tình trạng rảnh/bận này dành cho. Định dạng = products/456
startTime
(deprecated)

string (Timestamp format)

Chỉ có đầu ra. Thời điểm bắt đầu tính đến thời điểm bạn yêu cầu cung cấp (bao gồm cả ngày đó).

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".
endTime
(deprecated)

string (Timestamp format)

Chỉ có đầu ra. Thời gian kết thúc khi tình trạng còn hàng được yêu cầu (không bao gồm).

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".
startDate

object (Date)

Chỉ có đầu ra. Ngày bắt đầu mà bạn đã yêu cầu cung cấp (bao gồm cả ngày đó). Cùng múi giờ với đơn vị quảng cáo.
endDate

object (Date)

Chỉ có đầu ra. Ngày kết thúc mà bạn yêu cầu cung cấp (bao gồm cả ngày đó). Cùng múi giờ với đơn vị quảng cáo.
budget

object (Money)

Chỉ có đầu ra. Ngân sách của hạn mức chi tiêu.
targeting

object (Targeting)

Chỉ có đầu ra. Tiêu chí nhắm mục tiêu mà bạn cần đáp ứng yêu cầu về tình trạng còn hàng.
availabilityLineTerms

object (LineTerms)

Chỉ có đầu ra. Người bán có thể sử dụng dòng lệnh [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteIssueLine] để cập nhật [LineTerms].
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 AvailabilityLine.State để biết vòng đời của Dòng tình trạng còn hàng.

Người bán có thể sử dụng các phương thức tùy chỉnh [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] hoặc [Từ chối][google.ads.xbid.outofhome.v1beta1.OrderManagementService.

  • STATE_COMPLETED
  • STATE_REJECTED

.
rejection

object (Rejection)

Thông tin chi tiết về việc từ chối cho quy định hạn chế về khả năng sử dụng.
createTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian tạo cho dòng sẵn có.

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 cập nhật gần đây nhất cho dòng trạng thái hoạt độ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".

Tiểu bang

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

Enum
STATE_UNSPECIFIED Giá trị mặc định khi trạng thái dòng khả năng sử dụ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 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.
STATE_REJECTED Trạng thái từ chối khi người bán đã từ chối mục hàng còn hàng. Bạn phải cung cấp thông tin chi tiết về việc từ chối.
STATE_CANCELLED Trạng thái bị hủy khi người mua hủy đơn đặt hàng trước khi người bán hoàn tất hoặc từ chối phản hồi về tình trạng còn hàng.

Phương thức

complete

 Đánh dấu dòng tình trạng rảnh/bận hiện có là hoàn tất.

get

 Truy xuất từng dòng đối với đơn đặt hàng về tình trạng còn hàng.

list

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

reject

 Đánh dấu dòng tình trạng rảnh/bận hiện có là bị từ chối.