Package google.shopping.merchant.products.v1beta

Chỉ mục

ProductInputsService

Dịch vụ để sử dụng tài nguyên ProductInput. Dịch vụ này chỉ hoạt động đối với những sản phẩm có kênh trực tuyến.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

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

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ý.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

Tải dữ liệu đầu vào về sản phẩm lên tài khoản Merchant Center. Nếu đã có một mục nhập có cùng contentLanguage, offerId và dataSource, thì phương thức này sẽ thay thế mục nhập đó.

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ý.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ProductsService

Dịch vụ để sử dụng tài nguyên Sản phẩm. Dịch vụ này chỉ hoạt động đối với những sản phẩm có kênh trực tuyến.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

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

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 cuối cùng đã cập nhật.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Liệt kê các sản phẩm đã được xử lý trong tài khoản Merchant Center của bạn. Phản hồi có thể chứa ít mục hơn số lượng được chỉ định bởi pageSize. Dựa vào pageToken để xác định xem có thêm mục nào cần yêu cầu hay không.

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.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

Thuộc tính

Thuộc tính.

Trường
expiration_date

Timestamp

Ngày hết hạn của mặt hàng, như được chỉ định khi chèn, ở định dạng ISO 8601. Ngày hết hạn thực tế được hiển thị trong productstatuses dưới dạng googleExpirationDate và có thể sớm hơn nếu expirationDate quá xa trong tương lai.
disclosure_date

Timestamp

Ngày giờ mà một mặt hàng xuất hiện trong kết quả tìm kiếm trên các nền tảng YouTube của Google, ở định dạng ISO 8601. Hãy xem [Ngày công bố]( https://support.google.com/merchants/answer/13034208) để biết thêm thông tin.
availability_date

Timestamp

Ngày có sản phẩm để giao cho sản phẩm được đặt hàng trước, ở định dạng ISO 8601.
gtin[]

string

Mã số sản phẩm thương mại toàn cầu (GTIN) của mặt hàng. Bạn có thể cung cấp tối đa 10 GTIN.
price

Price

Giá của mặt hàng.
installment

Installment

Số lượng và số tiền trả góp cho một mặt hàng.
subscription_cost

SubscriptionCost

Số kỳ hạn (tháng hoặc năm) và số tiền thanh toán cho mỗi kỳ hạn đối với một mặt hàng có hợp đồng thuê bao liên kết.
loyalty_points

LoyaltyPoints

Điểm khách hàng thân thiết mà người dùng nhận được sau khi mua mặt hàng. Chỉ ở Nhật Bản.
loyalty_programs[]

LoyaltyProgram

Danh sách thông tin về chương trình khách hàng thân thiết được dùng để hiển thị các lợi ích của chương trình khách hàng thân thiết (ví dụ: giá tốt hơn, điểm, v.v.) cho người dùng mặt hàng này.
product_types[]

string

Danh mục của mặt hàng (được định dạng như trong quy cách dữ liệu sản phẩm).
sale_price

Price

Giá ưu đãi được quảng cáo của mặt hàng.
sale_price_effective_date

Interval

Phạm vi ngày mà mặt hàng được giảm giá (xem quy cách dữ liệu sản phẩm).
product_height

ProductDimension

Chiều cao của sản phẩm theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 3000 (bao gồm).
product_length

ProductDimension

Chiều dài của sản phẩm theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 3000 (bao gồm).
product_width

ProductDimension

Chiều rộng của sản phẩm theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 3000 (bao gồm).
product_weight

ProductWeight

Trọng lượng của sản phẩm theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 2000 (bao gồm).
shipping[]

Shipping

Quy tắc vận chuyển.
free_shipping_threshold[]

FreeShippingThreshold

Các điều kiện cần đáp ứng để sản phẩm được miễn phí vận chuyển.
shipping_weight

ShippingWeight

Trọng lượng của mặt hàng để vận chuyển.
shipping_length

ShippingDimension

Chiều dài của mặt hàng để vận chuyển.
shipping_width

ShippingDimension

Chiều rộng của mặt hàng để vận chuyển.
shipping_height

ShippingDimension

Chiều cao của mặt hàng để vận chuyển.
size_types[]

string

Kiểu cắt của mặt hàng. Bạn có thể dùng thuộc tính này để biểu thị các loại kích thước kết hợp cho các mặt hàng quần áo. Bạn có thể cung cấp tối đa 2 loại kích thước (xem [https://support.google.com/merchants/answer/6324497](loại kích thước)).
taxes[]

Tax

Thông tin thuế.
unit_pricing_measure

UnitPricingMeasure

Số đo và kích thước của một mặt hàng.
unit_pricing_base_measure

UnitPricingBaseMeasure

Lựa chọn ưu tiên của mẫu số của đơn giá.
ads_labels[]

string

Tương tự như ads_grouping, nhưng chỉ hoạt động trên CPC.
cost_of_goods_sold

Price

Giá vốn hàng bán. Dùng để báo cáo lợi nhuận gộp.
product_details[]

ProductDetail

Thông số kỹ thuật hoặc chi tiết bổ sung về sản phẩm.
product_highlights[]

string

Các dấu đầu dòng mô tả những điểm nổi bật phù hợp nhất của một sản phẩm.
display_ads_similar_ids[]

string

Nội dung đề xuất do nhà quảng cáo chỉ định.
promotion_ids[]

string

Mã nhận dạng duy nhất của chương trình khuyến mãi.
included_destinations[]

string

Danh sách các vị trí cần thêm vào mục tiêu này (tương ứng với hộp đánh dấu trong Merchant Center). Các đích đến mặc định luôn được đưa vào trừ phi đích đến đó được cung cấp trong excludedDestinations.
excluded_destinations[]

string

Danh sách các vị trí cần loại trừ khỏi mục tiêu này (tương ứng với các hộp đánh dấu không được chọn trong Merchant Center).
shopping_ads_excluded_countries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) để loại trừ mặt hàng khỏi vị trí xuất hiện quảng cáo Mua sắm. Các quốc gia trong danh sách này sẽ bị xoá khỏi danh sách quốc gia được thiết lập trong phần cài đặt nguồn dữ liệu.
cloud_export_additional_properties[]

CloudExportAdditionalProperties

Các trường bổ sung để xuất sang chương trình Cloud Retail.
certifications[]

Certification

Chứng nhận sản phẩm, chẳng hạn như chứng nhận nhãn hiệu suất năng lượng của các sản phẩm được ghi nhận trong cơ sở dữ liệu EPREL của EU. Xem bài viết trong Trung tâm trợ giúp để biết thêm thông tin.
auto_pricing_min_price

Price

Một biện pháp bảo vệ trong dự án "Chiết khấu tự động" (https://support.google.com/merchants/answer/10295759) và "Chương trình khuyến mãi linh động" (https://support.google.com/merchants/answer/13949249), đảm bảo rằng chiết khấu trên mặt hàng của người bán không thấp hơn giá trị này, từ đó duy trì giá trị và khả năng sinh lời của mặt hàng.
sustainability_incentives[]

ProductSustainabilityIncentive

Danh sách các chương trình khuyến khích phát triển bền vững.
identifier_exists

bool

Đặt giá trị này thành false khi mặt hàng không có mã nhận dạng sản phẩm duy nhất phù hợp với danh mục của mặt hàng, chẳng hạn như GTIN, MPN và thương hiệu. Giá trị mặc định là đúng nếu không được cung cấp.
is_bundle

bool

Liệu mặt hàng có phải là gói do người bán xác định hay không. Gói là một nhóm tuỳ chỉnh gồm nhiều sản phẩm do người bán bán với một mức giá duy nhất.
title

string

Tiêu đề của mặt hàng.
description

string

Nội dung mô tả về mặt hàng.
adult

bool

Đặt thành đúng nếu mục đó nhắm đến người lớn.
age_group

string

Nhóm tuổi mục tiêu của mặt hàng.
availability

string

Tình trạng còn hàng của mặt hàng.
brand

string

Thương hiệu của mặt hàng.
color

string

Màu sắc của mặt hàng.
condition

string

Tình trạng hoặc trạng thái của mặt hàng.
gender

string

Giới tính mà mặt hàng nhắm đến.
google_product_category

string

Danh mục của mặt hàng theo Google (xem cây phân loại sản phẩm của Google). Khi truy vấn sản phẩm, trường này sẽ chứa giá trị do người dùng cung cấp. Hiện tại, không có cách nào để lấy lại các danh mục sản phẩm của Google được chỉ định tự động thông qua API.
item_group_id

string

Giá trị nhận dạng dùng chung cho tất cả các biến thể của cùng một sản phẩm.
material

string

Chất liệu làm nên mặt hàng.
mpn

string

Mã số linh kiện của nhà sản xuất (MPN) của mặt hàng.
pattern

string

Hoa văn của mặt hàng (ví dụ: chấm bi).
sell_on_google_quantity

int64

Số lượng sản phẩm có sẵn để bán trên Google. Chỉ hỗ trợ cho sản phẩm bán trên mạng.
max_handling_time

int64

Thời gian xử lý sản phẩm tối đa (tính theo ngày làm việc).
min_handling_time

int64

Thời gian xử lý sản phẩm tối thiểu (tính theo ngày làm việc).
shipping_label

string

Nhãn vận chuyển của sản phẩm, dùng để nhóm sản phẩm trong quy tắc vận chuyển ở cấp tài khoản.
transit_time_label

string

Nhãn thời gian vận chuyển của sản phẩm, dùng để nhóm sản phẩm trong bảng thời gian vận chuyển ở cấp tài khoản.
size

string

Kích thước của mặt hàng. Chỉ được phép một giá trị. Đối với các biến thể có kích thước khác nhau, hãy chèn một sản phẩm riêng cho mỗi kích thước có cùng giá trị itemGroupId (xem [https://support.google.com/merchants/answer/6324492](định nghĩa về kích thước)).
size_system

string

Hệ thống trong đó kích thước được chỉ định. Nên dùng cho các mặt hàng may mặc.
tax_category

string

Danh mục thuế của sản phẩm.
energy_efficiency_class

string

Cấp hiệu suất năng lượng theo định nghĩa trong chỉ thị 2010/30/EU của Liên minh Châu Âu.
min_energy_efficiency_class

string

Cấp hiệu suất năng lượng theo định nghĩa trong chỉ thị 2010/30/EU của Liên minh Châu Âu.
max_energy_efficiency_class

string

Cấp hiệu suất năng lượng theo định nghĩa trong chỉ thị 2010/30/EU của Liên minh Châu Âu.
multipack

int64

Số lượng sản phẩm giống nhau trong một lô sản phẩm do người bán xác định.
ads_grouping

string

Dùng để nhóm các mục một cách tuỳ ý. Chỉ dành cho CPA%, không nên sử dụng cho các giá trị khác.
ads_redirect

string

Cho phép nhà quảng cáo ghi đè URL của mặt hàng khi sản phẩm xuất hiện trong bối cảnh của quảng cáo Sản phẩm.
display_ads_id

string

Giá trị nhận dạng mặt hàng cho các chiến dịch tái tiếp thị linh động.
display_ads_title

string

Tiêu đề của mặt hàng cho các chiến dịch tái tiếp thị linh động.
display_ads_value

double

Lợi nhuận mặt hàng cho các chiến dịch tái tiếp thị linh động.
pickup_method

string

Lựa chọn đến lấy hàng cho mặt hàng.
pickup_sla

string

Tiến trình nhận hàng tại cửa hàng.
custom_label_0

string

Nhãn tuỳ chỉnh 0 để nhóm các mặt hàng theo cách tuỳ chỉnh trong chiến dịch Mua sắm.
custom_label_1

string

Nhãn tuỳ chỉnh 1 để nhóm các mặt hàng theo cách tuỳ chỉnh trong chiến dịch Mua sắm.
custom_label_2

string

Nhãn tuỳ chỉnh 2 để nhóm các mặt hàng theo cách tuỳ chỉnh trong chiến dịch Mua sắm.
custom_label_3

string

Nhãn tuỳ chỉnh 3 để nhóm các mặt hàng theo cách tuỳ chỉnh trong chiến dịch Mua sắm.
custom_label_4

string

Nhãn tuỳ chỉnh 4 để nhóm các mặt hàng theo cách tuỳ chỉnh trong chiến dịch Mua sắm.
external_seller_id

string

Bắt buộc đối với tài khoản nhiều người bán. Sử dụng thuộc tính này nếu bạn là một trang web thương mại và bạn tải sản phẩm cho nhiều người bán lên tài khoản nhiều người bán.
pause

string

Việc xuất bản mặt hàng này sẽ tạm thời bị tạm dừng.
structured_title

ProductStructuredTitle

Tiêu đề có cấu trúc, dành cho tiêu đề được tạo bằng thuật toán (AI).
structured_description

ProductStructuredDescription

Nội dung mô tả có cấu trúc, dành cho nội dung mô tả được tạo bằng thuật toán (AI).

Giấy chứng nhận

Chứng nhận sản phẩm, ban đầu được đưa ra để tuân thủ quy định dán nhãn hiệu suất năng lượng của Liên minh Châu Âu bằng cách sử dụng cơ sở dữ liệu EPREL của Liên minh Châu Âu.

Trường
certification_authority

string

Cơ quan cấp chứng nhận, ví dụ: "European_Commission". Độ dài tối đa là 2.000 ký tự.
certification_name

string

Tên của chứng nhận, chẳng hạn như "EPREL". Độ dài tối đa là 2.000 ký tự.
certification_code

string

Mã chứng nhận. Độ dài tối đa là 2.000 ký tự.
certification_value

string

Giá trị chứng nhận (còn gọi là lớp, cấp hoặc điểm), ví dụ: "A+", "C", "vàng". Độ dài tối đa là 2.000 ký tự.

CloudExportAdditionalProperties

Thuộc tính sản phẩm cho Cloud Retail API. Ví dụ: các thuộc tính cho sản phẩm TV có thể là "Screen-Resolution" (Độ phân giải màn hình) hoặc "Screen-Size" (Kích thước màn hình).

Trường
text_value[]

string

Giá trị văn bản của thuộc tính đã cho. Ví dụ: "8K(UHD)" có thể là giá trị văn bản cho một sản phẩm TV. Số lần lặp lại tối đa của giá trị này là 400. Các giá trị được lưu trữ theo thứ tự tuỳ ý nhưng nhất quán. Kích thước chuỗi tối đa là 256 ký tự.
int_value[]

int64

Giá trị số nguyên của thuộc tính đã cho. Ví dụ: 1080 cho Độ phân giải màn hình của sản phẩm TV. Số lần lặp lại tối đa của giá trị này là 400. Các giá trị được lưu trữ theo thứ tự tuỳ ý nhưng nhất quán.
float_value[]

float

Giá trị float của thuộc tính đã cho. Ví dụ: đối với sản phẩm TV, giá trị là 1.2345. Số lần lặp lại tối đa của giá trị này là 400. Các giá trị được lưu trữ theo thứ tự tuỳ ý nhưng nhất quán.
property_name

string

Tên của thuộc tính đã cho. Ví dụ: "Độ phân giải màn hình" cho sản phẩm TV. Kích thước chuỗi tối đa là 256 ký tự.
bool_value

bool

Giá trị boolean của thuộc tính đã cho. Ví dụ: đối với sản phẩm TV, "True" (Đúng) hoặc "False" (Sai) nếu màn hình là UHD.
min_value

float

Giá trị float tối thiểu của thuộc tính đã cho. Ví dụ: đối với sản phẩm TV là 1.00.
max_value

float

Giá trị float tối đa của thuộc tính đã cho. Ví dụ: đối với sản phẩm TV 100.000 VND.
unit_code

string

Đơn vị của thuộc tính đã cho. Ví dụ: "Pixel" cho sản phẩm TV. Kích thước chuỗi tối đa là 256B.

DeleteProductInputRequest

Thông báo yêu cầu cho phương thức DeleteProductInput.

Trường
name

string

Bắt buộc. Tên của tài nguyên đầu vào sản phẩm cần xoá. Định dạng: accounts/{account}/productInputs/{product} trong đó phần cuối cùng product bao gồm 4 phần: channel~content_language~feed_label~offer_id ví dụ về tên sản phẩm là "accounts/123/productInputs/online~en~US~sku123"
data_source

string

Bắt buộc. Nguồn dữ liệu chính hoặc bổ sung mà bạn cần xoá dữ liệu đầu vào về sản phẩm. Định dạng: accounts/{account}/dataSources/{datasource}.

FreeShippingThreshold

Các điều kiện cần đáp ứng để sản phẩm được miễn phí vận chuyển.

Trường
country

string

Mã lãnh thổ CLDR của quốc gia nơi mặt hàng sẽ được vận chuyển đến.
price_threshold

Price

Giá sản phẩm tối thiểu để được miễn phí vận chuyển. Được biểu thị dưới dạng số.

GetProductRequest

Thông báo yêu cầu cho phương thức GetProduct.

Trường
name

string

Bắt buộc. Tên của sản phẩm cần truy xuất. Định dạng: accounts/{account}/products/{product}, trong đó phần cuối cùng product bao gồm 4 phần: channel~content_language~feed_label~offer_id, ví dụ về tên sản phẩm là "accounts/123/products/online~en~US~sku123"

InsertProductInputRequest

Thông báo yêu cầu cho phương thức InsertProductInput.

Trường
parent

string

Bắt buộc. Tài khoản mà sản phẩm này sẽ được chèn vào. Định dạng: accounts/{account}
product_input

ProductInput

Bắt buộc. Dữ liệu đầu vào về sản phẩm cần chèn.
data_source

string

Bắt buộc. Tên của nguồn dữ liệu sản phẩm chính hoặc bổ sung. Nếu sản phẩm đã tồn tại và nguồn dữ liệu được cung cấp khác, thì sản phẩm đó sẽ được chuyển sang nguồn dữ liệu mới.

Chỉ hỗ trợ nguồn dữ liệu API.

Định dạng: accounts/{account}/dataSources/{datasource}.

Trả góp

Thông báo đại diện cho khoản trả góp.

Trường
months

int64

Số lần trả góp mà người mua phải trả.
amount

Price

Số tiền mà người mua phải trả mỗi tháng.
downpayment

Price

Số tiền trả trước một phần mà người mua phải trả.
credit_type

string

Loại khoản thanh toán trả góp. Các giá trị được hỗ trợ là: * "finance" * "lease"

ListProductsRequest

Thông báo yêu cầu cho phương thức ListProducts.

Trường
parent

string

Bắt buộc. Tài khoản để đăng sản phẩm đã xử lý. Định dạng: accounts/{account}
page_size

int32

Số lượng sản phẩm tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Giá trị tối đa là 250; các giá trị trên 250 sẽ được ép thành 250. Nếu bạn không chỉ định, hệ thống sẽ trả về số lượng sản phẩm tối đa.
page_token

string

Mã thông báo trang, nhận được từ lệnh gọi ListProducts trước đó. Cung cấp giá trị này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListProducts phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListProductsResponse

Thông báo phản hồi cho phương thức ListProducts.

Trường
products[]

Product

Các sản phẩm đã được xử lý từ tài khoản được chỉ định. Đây là những sản phẩm đã được xử lý sau khi áp dụng các quy tắc và nguồn dữ liệu bổ sung.
next_page_token

string

Mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

LoyaltyPoints

Thông báo đại diện cho điểm khách hàng thân thiết.

Trường
name

string

Tên của chương trình tích điểm khách hàng thân thiết. Bạn nên giới hạn tên ở mức 12 ký tự có chiều rộng đầy đủ hoặc 24 ký tự La Mã.
points_value

int64

Điểm khách hàng thân thiết của nhà bán lẻ theo giá trị tuyệt đối.
ratio

double

Tỷ lệ quy đổi sang đơn vị tiền tệ của một điểm khách hàng thân thiết. Google xác định đơn vị tiền tệ dựa trên chế độ cài đặt trong Merchant Center. Nếu bạn bỏ qua tỷ lệ, tỷ lệ này sẽ mặc định là 1,0.

LoyaltyProgram

Thông báo đại diện cho chương trình khách hàng thân thiết.

Trường
program_label

string

Nhãn của chương trình khách hàng thân thiết. Đây là một nhãn nội bộ giúp xác định duy nhất mối quan hệ giữa một thực thể người bán và một thực thể chương trình khách hàng thân thiết. Bạn phải cung cấp nhãn để hệ thống có thể liên kết các thành phần bên dưới (ví dụ: giá và điểm) với người bán. Bạn phải liên kết chương trình tương ứng với tài khoản người bán.
tier_label

string

Nhãn của bậc trong chương trình khách hàng thân thiết. Phải khớp với một trong các nhãn trong chương trình.
price

Price

Giá dành cho thành viên của cấp cụ thể, tức là giá chiết khấu tức thì. Phải nhỏ hơn hoặc bằng giá thông thường.
cashback_for_future_use

Price

Khoản tiền hoàn lại có thể dùng cho các giao dịch mua hàng sau này.
loyalty_points

int64

Số điểm khách hàng thân thiết kiếm được khi mua hàng.
member_price_effective_date

Interval

Phạm vi ngày mà mặt hàng đủ điều kiện áp dụng giá dành cho thành viên. Nếu bạn không chỉ định, giá dành cho thành viên sẽ luôn được áp dụng. Phạm vi ngày được biểu thị bằng một cặp ngày theo tiêu chuẩn ISO 8601, được phân tách bằng dấu cách, dấu phẩy hoặc dấu gạch chéo.
shipping_label

string

Nhãn của lợi ích vận chuyển. Nếu trường này có giá trị, thì mặt hàng này có lợi ích vận chuyển dành cho khách hàng thân thiết. Nếu bạn không cung cấp giá trị trường này, mặt hàng sẽ không đủ điều kiện hưởng dịch vụ vận chuyển dành cho khách hàng thân thiết theo cấp độ khách hàng thân thiết đã cho.

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 đầu vào sản phẩm trong nguồn dữ liệu chính và nhiều đầu vào sản phẩm 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.

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~content_language~feed_label~offer_id, ví dụ về tên sản phẩm là "accounts/123/products/online~en~US~sku123"
channel

ChannelEnum

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

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 đã 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.
content_language

string

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

string

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

string

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

Attributes

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

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 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.
product_status

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ộ.
version_number

int64

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 version_number 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.

ProductDetail

Thông tin chi tiết về sản phẩm.

Trường
section_name

string

Tiêu đề mục dùng để nhóm một tập hợp thông tin chi tiết về sản phẩm.
attribute_name

string

Tên của chi tiết sản phẩm.
attribute_value

string

Giá trị của chi tiết sản phẩm.

ProductDimension

Kích thước của sản phẩm.

Trường
value

double

Bắt buộc. Giá trị phương diện được biểu diễn dưới dạng số. Giá trị này có thể có độ chính xác tối đa là 4 chữ số thập phân.
unit

string

Bắt buộc. Đơn vị phương diện. Các giá trị được chấp nhận là: * "in" * "cm"

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 các bước 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 đó phải 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ệ.

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~content_language~feed_label~offer_id, 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

ChannelEnum

Không thể thay đổi. Kênh của sản phẩm.
offer_id

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.
content_language

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.
feed_label

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

Attributes

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

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 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.
version_number

int64

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 version_number 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ộ.

Trường
destination_statuses[]

DestinationStatus

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

ItemLevelIssue

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

Timestamp

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

Timestamp

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

Timestamp

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.

Trường
reporting_context

ReportingContextEnum

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

string

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

string

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

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.

Trường
code

string

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

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.
reporting_context

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.
applicable_countries[]

string

Danh sách mã quốc gia (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.

ProductStructuredDescription

Nội dung mô tả có cấu trúc, dành cho nội dung mô tả được tạo bằng thuật toán (AI).

Trường
digital_source_type

string

Loại nguồn kỹ thuật số, ví dụ: "trained_algorithmic_media". Theo IPTC. Độ dài tối đa là 40 ký tự.
content

string

Độ dài tối đa của văn bản mô tả là 5.000 ký tự

ProductStructuredTitle

Tiêu đề có cấu trúc, dành cho tiêu đề được tạo bằng thuật toán (AI).

Trường
digital_source_type

string

Loại nguồn kỹ thuật số, ví dụ: "trained_algorithmic_media". Theo IPTC. Độ dài tối đa là 40 ký tự.
content

string

Độ dài tối đa của văn bản tiêu đề là 150 ký tự

ProductSustainabilityIncentive

Thông tin về các chương trình khuyến khích liên quan đến tính bền vững, chẳng hạn như chiết khấu hoặc giảm thuế.

Trường
Trường hợp hợp nhất value. Giá trị khuyến khích phát triển bền vững. value chỉ có thể là một trong những loại sau:
amount

Price

Số tiền cố định của khoản khuyến khích.
percentage

double

Tỷ lệ phần trăm giá ưu đãi mà chương trình khuyến mãi được áp dụng.
type

Type

Chương trình khuyến khích phát triển bền vững.

Loại

Các loại chương trình khuyến khích phát triển bền vững được hỗ trợ.

Enum
TYPE_UNSPECIFIED Loại chương trình khuyến khích về tính bền vững chưa được chỉ định hoặc không xác định.
EV_TAX_CREDIT Chương trình giảm trách nhiệm thuế đối với xe điện và xe lai sạc điện ở một số quốc gia. Mức giảm này có thể dựa trên một số tiền cụ thể hoặc tỷ lệ phần trăm của giá ưu đãi.
EV_PRICE_DISCOUNT Chương trình trợ cấp, thường được gọi là tiền thưởng môi trường, cung cấp khoản trợ cấp mua xe điện và ở một số quốc gia là xe lai sạc điện. Số tiền tài trợ có thể là một số tiền cố định hoặc tỷ lệ phần trăm của giá bán.

ProductWeight

Trọng lượng của sản phẩm.

Trường
value

double

Bắt buộc. Trọng số được biểu thị dưới dạng số. Độ chính xác tối đa của trọng số là 4 chữ số thập phân.
unit

string

Bắt buộc. Đơn vị trọng lượng. Các giá trị được chấp nhận là: * "g" * "kg" * "oz" * "lb"

Giao hàng

Thông tin vận chuyển sản phẩm.

Trường
price

Price

Giá vận chuyển cố định, được biểu thị dưới dạng số.
country

string

Mã lãnh thổ CLDR của quốc gia nơi mặt hàng sẽ được vận chuyển đến.
region

string

Khu vực địa lý áp dụng mức phí vận chuyển. Hãy xem phần khu vực để biết thêm thông tin.
service

string

Nội dung mô tả ở dạng tự do về hạng dịch vụ hoặc tốc độ giao hàng.
location_id

int64

Mã nhận dạng dạng số của một vị trí áp dụng mức phí vận chuyển theo định nghĩa trong API AdWords.
location_group_name

string

Vị trí áp dụng phí vận chuyển, được biểu thị bằng tên nhóm vị trí.
postal_code

string

Phạm vi mã bưu chính áp dụng cho mức phí vận chuyển, được biểu thị bằng một mã bưu chính, một tiền tố mã bưu chính theo sau là ký tự đại diện *, một phạm vi giữa hai mã bưu chính hoặc hai tiền tố mã bưu chính có độ dài bằng nhau.
min_handling_time

int64

Thời gian xử lý tối thiểu (bao gồm cả thời gian này) tính từ khi nhận được đơn đặt hàng đến khi giao hàng theo ngày làm việc. 0 có nghĩa là đơn đặt hàng được vận chuyển vào cùng ngày nhận đơn đặt hàng nếu đơn đặt hàng được nhận trước thời hạn đặt hàng. minHandlingTime chỉ có thể xuất hiện cùng với maxHandlingTime; nhưng không bắt buộc nếu có maxHandlingTime.
max_handling_time

int64

Thời gian xử lý tối đa (bao gồm cả thời gian này) tính từ khi nhận được đơn đặt hàng đến khi giao hàng theo ngày làm việc. 0 có nghĩa là đơn đặt hàng được vận chuyển vào cùng ngày nhận đơn đặt hàng nếu đơn đặt hàng được nhận trước thời hạn đặt hàng. Bạn phải cung cấp cả maxHandlingTime và maxTransitTime nếu cung cấp tốc độ vận chuyển. minHandlingTime là không bắt buộc nếu có maxHandlingTime.
min_transit_time

int64

Thời gian vận chuyển tối thiểu (bao gồm cả thời gian này) tính từ khi đơn đặt hàng được vận chuyển đến khi đơn đặt hàng được giao theo ngày làm việc. 0 có nghĩa là đơn đặt hàng được giao trong cùng ngày vận chuyển. minTransitTime chỉ có thể xuất hiện cùng với maxTransitTime; nhưng không bắt buộc nếu có maxTransitTime.
max_transit_time

int64

Thời gian vận chuyển tối đa (bao gồm cả thời gian này) tính từ khi đơn đặt hàng được vận chuyển đến khi đơn đặt hàng được giao theo ngày làm việc. 0 có nghĩa là đơn đặt hàng được giao trong cùng ngày vận chuyển. Bạn phải cung cấp cả maxHandlingTime và maxTransitTime nếu cung cấp tốc độ vận chuyển. minTransitTime là không bắt buộc nếu có maxTransitTime.

ShippingDimension

Kích thước vận chuyển của sản phẩm.

Trường
value

double

Kích thước của sản phẩm dùng để tính phí vận chuyển của mặt hàng.
unit

string

Đơn vị giá trị.

ShippingWeight

Trọng lượng vận chuyển của sản phẩm.

Trường
value

double

Trọng lượng của sản phẩm dùng để tính phí vận chuyển của mặt hàng.
unit

string

Đơn vị giá trị.

SubscriptionCost

SubscriptionCost của sản phẩm.

Trường
period

SubscriptionPeriod

Loại thời hạn thuê bao. Các giá trị được hỗ trợ là: * "month" * "year"
period_length

int64

Số kỳ hạn thuê bao mà người mua phải trả.
amount

Price

Số tiền mà người mua phải trả cho mỗi kỳ thuê bao.

SubscriptionPeriod

Thời hạn thuê bao của sản phẩm.

Enum
SUBSCRIPTION_PERIOD_UNSPECIFIED Cho biết rằng thời hạn thuê bao không được chỉ định.
MONTH Cho biết thời hạn thuê bao là tháng.
YEAR Cho biết thời hạn thuê bao là năm.

Thuế

Thuế của sản phẩm.

Trường
rate

double

Tỷ lệ phần trăm thuế áp dụng cho giá mặt hàng.
country

string

Quốc gia nơi mặt hàng phải chịu thuế, được chỉ định dưới dạng mã lãnh thổ theo CLDR.
region

string

Khu vực địa lý áp dụng mức thuế.
tax_ship

bool

Đặt thành true nếu bạn tính thuế đối với phí vận chuyển.
location_id

int64

Mã nhận dạng dạng số của một vị trí áp dụng mức thuế theo định nghĩa trong API AdWords.
postal_code

string

Phạm vi mã bưu chính áp dụng mức thuế, được biểu thị bằng mã zip, tiền tố mã zip sử dụng ký tự đại diện *, phạm vi giữa hai mã zip hoặc hai tiền tố mã zip có độ dài bằng nhau. Ví dụ: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingBaseMeasure

UnitPricingBaseMeasure của sản phẩm.

Trường
value

int64

Mẫu số của đơn giá.
unit

string

Đơn vị của mẫu số.

UnitPricingMeasure

UnitPricingMeasure của sản phẩm.

Trường
value

double

Số đo của một mặt hàng.
unit

string

Đơn vị đo lường.