Dưới đây là các loại mã sản phẩm trong Content API for Shopping:
- Mã ưu đãi
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à mã duy nhất cho 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ố tuần tự.offerId
có thể là một mã SKU nội bộ mà người bán gán cho sản phẩm.- ID REST
- Mã REST là giá trị nhận dạng duy nhất cho một sản phẩm do Google chỉ định.
- Mã REST là
productId
cho lệnh gọi API REST. Mã REST được tổng hợp theo định dạng
online:en:label:1111111111
. Mã REST bao gồm 4 phần sau, được 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ụ:
en
hoặcfr
) - Nhãn nguồn cấp dữ liệu (có thể là mã hai chữ cái cho quốc gia mục tiêu của nguồn cấp dữ liệu, ví dụ:
US
hoặcFR
) - Mã ưu đãi
Bạn đặt các mã này cùng nhau dưới dạng
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 đại diện cho 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ỉ các ký tự ASCII gồm chữ và số, 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 | 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 cho sản phẩm của sản phẩm. |
ID 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 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 |
Dùng bên trong phần 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 Thị trường chọn. | example-Seller1 |
Bắt buộc đối với tài khoản nhiều người bán. Mật khẩu phải dài 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à các ký tự đặc biệt _, -, ., ~. |