Method: accounts.lfpInventories.insert

Chèn một tài nguyên LfpInventory cho tài khoản người bán đích nhất định. Nếu tài nguyên đã tồn tại, nó sẽ được thay thế. Khoảng không quảng cáo sẽ tự động hết hạn sau 30 ngày.

Yêu cầu HTTP

POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpInventories:insert

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

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Tài khoản của nhà cung cấp LFP. Định dạng accounts/{account}

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của LfpInventory.

Nội dung phản hồi

Kho hàng tại địa phương cho người bán.

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
{
  "name": string,
  "targetAccount": string,
  "storeCode": string,
  "offerId": string,
  "regionCode": string,
  "contentLanguage": string,
  "price": {
    object (Price)
  },
  "availability": string,
  "collectionTime": string,
  "gtin": string,
  "quantity": string,
  "pickupMethod": string,
  "pickupSla": string,
  "feedLabel": string
}
Trường
name

string

Chỉ có đầu ra. Giá trị nhận dạng. Tên cho tài nguyên LfpInventory. Định dạng: accounts/{account}/lfpInventories/{target_merchant}~{storeCode}~{offer}

targetAccount

string (int64 format)

Bắt buộc. Mã truy cập Merchant Center của người bán để gửi kho hàng.

storeCode

string

Bắt buộc. Mã nhận dạng cửa hàng của người bán. Mã cửa hàng được chèn thông qua InsertLfpStore hoặc mã cửa hàng trong Trang doanh nghiệp.

offerId

string

Bắt buộc. Không thể thay đổi. Giá trị nhận dạng duy nhất của sản phẩm. Nếu bạn gửi cả kho hàng và doanh số bán hàng cho một người bán, thì mã nhận dạng này phải khớp với cùng một sản phẩm.

Lưu ý: nếu người bán bán cả loại mới và đã qua sử dụng của cùng một sản phẩm, thì những sản phẩm đó cần có mã khác nhau.

regionCode

string

Bắt buộc. Mã lãnh thổ CLDR của quốc gia nơi sản phẩm được bán.

contentLanguage

string

Bắt buộc. Mã ngôn ngữ gồm hai chữ cái theo ISO 639-1 của mặt hàng.

price

object (Price)

Không bắt buộc. Giá hiện tại của sản phẩm.

availability

string

Bắt buộc. Tình trạng còn hàng của sản phẩm tại cửa hàng này. Để biết các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại địa phương

collectionTime

string (Timestamp format)

Không bắt buộc. Thời điểm thu thập khoảng không quảng cáo. Nếu bạn không đặt chính sách này, giá trị này sẽ được đặt thành thời điểm gửi kho hàng.

gtin

string

Không bắt buộc. Mã số sản phẩm thương mại toàn cầu của sản phẩm.

quantity

string (int64 format)

Không bắt buộc. Số lượng sản phẩm có sẵn tại cửa hàng này. Phải lớn hơn hoặc bằng 0.

pickupMethod

string

Không bắt buộc. Phương pháp nhận hàng được hỗ trợ cho mặt hàng này. Trừ phi giá trị là "not supported", bạn phải gửi trường này cùng với pickupSla. Để biết các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại địa phương.

pickupSla

string

Không bắt buộc. Ngày dự kiến mà khách hàng có thể đến lấy hàng so với ngày đặt hàng. Phải được gửi cùng với pickupMethod. Để biết các giá trị thuộc tính được chấp nhận, hãy xem quy cách dữ liệu kho hàng tại địa phương.

feedLabel

string

Không bắt buộc. Nhãn nguồn cấp dữ liệu cho sản phẩm. Nếu bạn không đặt giá trị này, giá trị mặc định sẽ là regionCode.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.