REST Resource: sellers.products

Tài nguyên: Sản phẩm

Một sản phẩm duy nhất.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "creativeSpecifications": [
    {
      object (CreativeSpecification)
    }
  ],
  "bookingLeadDuration": string,
  "assignmentLeadDuration": string,
  "minFlightDuration": string,
  "maxFlightDuration": string,
  "slotDuration": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "currencyCode": string
}
Trường
name

string

Tên tài nguyên của sản phẩm ở định dạng: sellers/{seller}/products/{product}. Ví dụ: sellers/seller111/products/product123.

externalId

string

Mã nhận dạng dùng để liên kết thực thể này với các nguồn bên ngoài.

displayName

string

Bắt buộc. Tên hiển thị của sản phẩm.

Phải được mã hoá UTF-8 với kích thước tối đa là 240 byte.

description

string

Trường biểu mẫu tuỳ ý bổ sung để mô tả sản phẩm.

labels

map (key: string, value: string)

Bộ nhãn dạng tự do để mô tả sản phẩm này.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

creativeSpecifications[]

object (CreativeSpecification)

Bắt buộc. Danh sách các mẫu quảng cáo được phép phân phát cho sản phẩm này.

bookingLeadDuration

string (Duration format)

Bắt buộc. Thời lượng khách hàng tiềm năng cần thiết để đặt trước sản phẩm. Bây giờ, + bookingLeadDuration phải sau khi bắt đầu chuyến bay.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

assignmentLeadDuration

string (Duration format)

Bắt buộc. Thời lượng khách hàng tiềm năng cần thiết để chỉ định mẫu quảng cáo.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

minFlightDuration

string (Duration format)

Thời gian bay tối thiểu cho sản phẩm này.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

maxFlightDuration

string (Duration format)

Bắt buộc. Thời gian bay tối đa cho sản phẩm này.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

slotDuration

string (Duration format)

Bắt buộc. Thời lượng của khung giờ cho sản phẩm này.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

createTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian tạo sản phẩ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""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 sản phẩ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""2014-10-02T15:01:23.045123456Z".

state

enum (State)

Chỉ có đầu ra. Trạng thái của sản phẩm này.

currencyCode

string

Bắt buộc. Mã đơn vị tiền tệ viết hoa gồm 3 chữ cái được xác định trong ISO 4217.

Tiểu bang

Giá trị có thể dùng cho trạng thái sản phẩm.

Enum
STATE_UNSPECIFIED Giá trị mặc định khi Trạng thái sản phẩm không được chỉ định hoặc không xác định trong phiên bản này.
STATE_ACTIVE Sản phẩm đang hoạt động.
STATE_DELETED Sản phẩm đã bị xoá.

Phương thức

create

Tạo một sản phẩm mới.

delete

Xoá một sản phẩm hiện có.

get

Truy xuất một sản phẩm riêng lẻ.

list

Liệt kê sản phẩm.

patch

Cập nhật một sản phẩm hiện có.