REST Resource: accounts.products

Tài nguyên: Sản phẩm

Sản phẩm đã xử lý, được tạo từ nhiều product inputs sau khi áp dụng các quy tắc và nguồn dữ liệu bổ sung. Sản phẩm đã xử lý này khớp với sản phẩm xuất hiện trong tài khoản Merchant Center, quảng cáo Mua sắm và các nền tảng khác của Google. Mỗi sản phẩm được tạo từ đúng một sản phẩm đầu vào trong nguồn dữ liệu chính và nhiều sản phẩm đầu vào trong nguồn dữ liệu bổ sung. 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ý và cập nhật.

Tất cả các trường trong sản phẩm đã xử lý và thông báo phụ của sản phẩm đó đều khớp với tên của thuộc tính tương ứng trong Quy cách dữ liệu sản phẩm, ngoại trừ một số trường hợp.

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

string

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

enum (ChannelEnum)

Chỉ có đầu ra. Kênh của sản phẩm.
offerId

string

Chỉ có đầu ra. 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

Chỉ có đầu ra. Mã ngôn ngữ ISO 639-1 gồm hai chữ cái cho sản phẩm.
feedLabel

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu cho sản phẩm.
dataSource

string

Chỉ có đầu ra. Nguồn dữ liệu chính của sản phẩm.
attributes

object (Attributes)

Chỉ có đầu ra. Danh sách các thuộc tính sản phẩm.
customAttributes[]

object (CustomAttribute)

Chỉ có đầu ra. 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 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.
productStatus

object (ProductStatus)

Chỉ có đầu ra. Trạng thái của sản phẩm, vấn đề về việc xác thực dữ liệu, tức là thông tin về sản phẩm được tính toán không đồng bộ.
versionNumber

string (int64 format)

Chỉ có đầu ra. 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.

ProductStatus

Trạng thái của sản phẩm, vấn đề về việc xác thực dữ liệu, tức là thông tin về sản phẩm được tính toán không đồng bộ.

Biểu diễn dưới dạng JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Trường
destinationStatuses[]

object (DestinationStatus)

Đích đến dự kiến của sản phẩm.
itemLevelIssues[]

object (ItemLevelIssue)

Danh sách tất cả vấn đề liên quan đến sản phẩm.
creationDate

string (Timestamp format)

Ngày tạo mặt hàng, ở định dạng ISO 8601.
lastUpdateDate

string (Timestamp format)

Ngày cập nhật mục gần đây nhất, ở định dạng ISO 8601.
googleExpirationDate

string (Timestamp format)

Ngày hết hạn của mặt hàng, ở định dạng ISO 8601.

DestinationStatus

Trạng thái đích của trạng thái sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Trường
reportingContext

enum (ReportingContextEnum)

Tên của ngữ cảnh báo cáo.
approvedCountries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) nơi ưu đãi được phê duyệt.
pendingCountries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) nơi mặt hàng đang chờ phê duyệt.
disapprovedCountries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) nơi mặt hàng bị từ chối.

ItemLevelIssue

ItemLevelIssue của trạng thái sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Trường
code

string

Mã lỗi của vấn đề.
severity

enum (Severity)

Mức độ ảnh hưởng của vấn đề này đến việc phân phát mặt hàng.
resolution

string

Liệu người bán có thể giải quyết vấn đề hay không.
attribute

string

Tên của thuộc tính, nếu vấn đề là do một thuộc tính gây ra.
reportingContext

enum (ReportingContextEnum)

Bối cảnh báo cáo mà vấn đề áp dụng.
description

string

Nội dung mô tả ngắn gọn về vấn đề bằng tiếng Anh.
detail

string

Nội dung mô tả chi tiết về vấn đề bằng tiếng Anh.
documentation

string

URL của trang web để giúp giải quyết vấn đề này.
applicableCountries[]

string

Danh sách mã quốc gia (theo ISO 3166-1 alpha-2) nơi vấn đề áp dụng cho mặt hàng.

Mức độ nghiêm trọng

Mức độ ảnh hưởng của vấn đề đến việc phân phát sản phẩm.

Enum
SEVERITY_UNSPECIFIED Chưa chỉ định.
NOT_IMPACTED Đây là vấn đề cảnh báo và không ảnh hưởng trực tiếp đến sản phẩm.
DEMOTED Sản phẩm bị hạ cấp và có nhiều khả năng sẽ bị hạn chế về hiệu suất trong kết quả tìm kiếm
DISAPPROVED Vấn đề khiến sản phẩm bị từ chối.

Phương thức

get

 Truy xuất sản phẩm đã xử lý từ tài khoản Merchant Center của bạn.

list

 Liệt kê các sản phẩm đã được xử lý trong tài khoản Merchant Center của bạn.