Dưới đây là các loại mã sản phẩm trong Content API for Shopping:
- Mã gói dịch vụ
offerId
là một chuỗi do người bán gán cho một sản phẩm. Mã nhận dạng này đại diện cho một sản phẩm riêng lẻ.offerId
là giá trị duy nhất của tập hợp các mặt hàng trong cơ sở dữ liệu của Merchant Center và thường là một số thứ tự.offerId
có thể là một mã SKU nội bộ mà người bán chỉ định cho sản phẩm.- Mã nhận dạng Kiến trúc chuyển trạng thái đại diện (REST)
- Mã REST là giá trị nhận dạng duy nhất của một sản phẩm do Google chỉ định.
- Mã REST là
productId
cho các lệnh gọi API REST. Mã REST là mã tổng hợp có định dạng
online:en:label:1111111111
. Mã REST bao gồm 4 phần sau, phân tách bằng dấu hai chấm:- Kênh ("trực tuyến" hoặc "địa phương")
- Ngôn ngữ của nội dung (sử dụng ký hiệu 2 chữ cái, ví dụ như
en
hoặcfr
) - Nhãn nguồn cấp dữ liệu (có thể là mã gồm hai chữ cái của quốc gia mục tiêu của nguồn cấp dữ liệu, ví dụ:
US
hoặcFR
) - Mã gói dịch vụ
Bạn kết hợp các giá trị này thành
channel:contentLanguage:feedLabel:offerId
, ví dụ:online:en:US:1111111111
.- Mã người bán bên ngoài (Trang web thương mại)
Trang web thương mại phải chỉ định
external_seller_id
cho các mặt hàng đã tải lên tài khoản nhiều người bán. Trường này thể hiện một người bán cá nhân.Các giá trị
external_seller_id
có phân biệt chữ hoa chữ thường và phải đáp ứng các tiêu chí sau:- Độ dài từ 1 đến 50 ký tự
- Chỉ ký tự ASCII chữ và số và dấu gạch dưới (_), dấu gạch nối (-), dấu chấm (.) và dấu ngã (~)
Trường này không giống với trường
seller_id
nội bộ.
Bảng sau đây tóm tắt một số mã nhận dạng có thể liên kết với một sản phẩm:
Thuộc tính | Nội dung mô tả | Ví dụ: | Ghi chú |
---|---|---|---|
offerId |
Mã nhận dạng do người bán gán cho một sản phẩm. | 1111111111 |
Loại dữ liệu chuỗi, giá trị nhận dạng duy nhất của sản phẩm. |
Mã nhận dạng Kiến trúc chuyển trạng thái đại diện (REST) | Mã nhận dạng do Google gán cho một sản phẩm. Ở định dạng channel:contentLanguage:feedLabel:offerId . |
online:en:label:1111111111 |
Mã đầy đủ bao gồm offerId . |
productId |
Dùng để tham chiếu đến mã REST trong các lệnh gọi API. | online:en:label:1111111111 |
Đây là mã REST của một sản phẩm. |
id |
Có cùng giá trị với mã REST và productId . |
online:en:label:1111111111 |
Được dùng bên trong nội dung JSON của một sản phẩm để tham chiếu đến productId của sản phẩm đó. |
external_seller_id |
Mã người bán do Marketplace chọn. | example-Seller1 |
Bắt buộc đối với tài khoản nhiều người bán. Phải có từ 1 đến 50 ký tự. Phân biệt chữ hoa chữ thường. Chúng tôi chấp nhận chữ số và ký tự đặc biệt _, -, . và ~. |