REST Resource: accounts.productInputs

Tài nguyên: ProductInput

Tài nguyên này đại diện cho dữ liệu đầu vào mà bạn gửi cho một sản phẩm, chứ không phải sản phẩm đã xử lý mà bạn thấy trong Merchant Center, trong quảng cáo Mua sắm hoặc trên các nền tảng của Google. Dữ liệu đầu vào sản phẩm, quy tắc và dữ liệu nguồn dữ liệu bổ sung được kết hợp để tạo Product đã xử lý.

Các thuộc tính đầu vào bắt buộc của sản phẩm để vượt qua quy trình kiểm tra xác thực dữ liệu chủ yếu được xác định trong Quy cách dữ liệu sản phẩm.

Các thuộc tính sau đây là bắt buộc: feedLabel, contentLanguage và offerId.

Sau khi chèn, cập nhật hoặc xoá dữ liệu đầu vào về sản phẩm, có thể mất vài phút thì bạn mới có thể truy xuất sản phẩm đã xử lý.

Tất cả các trường trong dữ liệu đầu vào sản phẩm và thông báo phụ của dữ liệu đó khớp với tên tiếng Anh của thuộc tính tương ứng trong thông số kỹ thuật theo ngành dọc, ngoại trừ một số trường hợp ngoại lệ.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
Trường
name

string

Giá trị nhận dạng. Tên của dữ liệu đầu vào về sản phẩm. Định dạng: "{productinput.name=accounts/{account}/productInputs/{productinput}}", trong đó phần cuối cùng productinput bao gồm 4 phần: channel~contentLanguage~feedLabel~offerId, ví dụ về tên đầu vào sản phẩm là "accounts/123/productInputs/online~en~US~sku123"
product

string

Chỉ có đầu ra. Tên của sản phẩm đã qua chế biến. Định dạng "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Bắt buộc. Không thể thay đổi. Kênh của sản phẩm.
offerId

string

Bắt buộc. Không thể thay đổi. Giá trị nhận dạng riêng biệt của bạn cho sản phẩm. Điều này cũng áp dụng cho sản phẩm đầu vào và sản phẩm đã qua xử lý. Khoảng trắng ở đầu và cuối sẽ bị xoá và nhiều khoảng trắng sẽ được thay thế bằng một khoảng trắng duy nhất khi gửi. Hãy xem quy cách dữ liệu sản phẩm để biết thông tin chi tiết.
contentLanguage

string

Bắt buộc. Không thể thay đổi. Mã ngôn ngữ ISO 639-1 gồm hai chữ cái cho sản phẩm.
feedLabel

string

Bắt buộc. Không thể thay đổi. Nhãn nguồn cấp dữ liệu của sản phẩm.
attributes

object (Attributes)

Không bắt buộc. Danh sách các thuộc tính sản phẩm.
customAttributes[]

object (CustomAttribute)

Không bắt buộc. Danh sách các thuộc tính tuỳ chỉnh (do người bán cung cấp). Bạn cũng có thể dùng thuộc tính này để gửi bất kỳ thuộc tính nào của thông số kỹ thuật dữ liệu ở dạng chung (ví dụ: { "name": "size type", "value": "regular" }). Điều này rất hữu ích khi gửi các thuộc tính không được API hiển thị rõ ràng, chẳng hạn như các thuộc tính bổ sung dùng cho chương trình Mua trên Google. Số ký tự tối đa được phép cho mỗi thuộc tính tuỳ chỉnh là 10240 (thể hiện tổng số ký tự cho tên và giá trị). Bạn có thể đặt tối đa 2500 thuộc tính tuỳ chỉnh cho mỗi sản phẩm, với tổng kích thước là 102,4 kB. Dấu gạch dưới trong tên thuộc tính tuỳ chỉnh sẽ được thay thế bằng dấu cách khi chèn.
versionNumber

string (int64 format)

Không bắt buộc. Biểu thị phiên bản hiện tại (tính mới) của sản phẩm. Bạn có thể sử dụng thuộc tính này để duy trì thứ tự phù hợp khi thực hiện nhiều lần cập nhật cùng một lúc.

Nếu được đặt, thao tác chèn sẽ bị ngăn chặn khi số phiên bản thấp hơn số phiên bản hiện tại của sản phẩm hiện có. Bạn có thể chèn lại (ví dụ: làm mới sản phẩm sau 30 ngày) bằng versionNumber hiện tại.

Chỉ hỗ trợ chèn vào nguồn dữ liệu chính.

Nếu thao tác bị ngăn chặn, ngoại lệ bị huỷ sẽ được gửi.

Phương thức

delete

 Xoá một mục nhập sản phẩm khỏi tài khoản Merchant Center.

insert

 Tải dữ liệu đầu vào về sản phẩm lên tài khoản Merchant Center.