ID sản phẩm

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:

  1. Kênh ("trực tuyến" hoặc "địa phương")
  2. Ngôn ngữ của nội dung (sử dụng ký hiệu 2 chữ cái, ví dụ như en hoặc fr)
  3. 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ặc FR)
  4. 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à ~.