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ỉ dành cho những sản phẩm có kênh trực tuyến.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

Xoá dữ liệu sản phẩm đã nhập khỏi tài khoản Merchant Center.

Sau khi chèn, cập nhật hoặc xoá thông tin đầu vào của sản phẩm, hệ thống có thể mất vài phút để truy xuất được 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 bài viết Tổng quan về OAuth 2.0.
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á thông tin đầu vào của sản phẩm, hệ thống có thể mất vài phút để truy xuất được 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 bài viết Tổng quan về OAuth 2.0.

ProductsService

Dịch vụ để sử dụng Tài nguyên sản phẩm. Dịch vụ này chỉ dành cho 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.

Sau khi chèn, cập nhật hoặc xoá thông tin đầu vào của sản phẩm, có thể mất vài phút để hệ thống truy xuất được 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 bài viết Tổng quan về OAuth 2.0.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Liệt kê các sản phẩm đã 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 so với chỉ định của pageSize. Dựa vào pageToken để xác định xem có mục nào khác cần được yêu cầu hay không.

Sau khi chèn, cập nhật hoặc xoá thông tin đầu vào của sản phẩm, hệ thống có thể mất vài phút để truy xuất sản phẩm đã xử lý mà bạn đã 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 bài viết Tổng quan về OAuth 2.0.

Thuộc tính

Thuộc tính.

Trường
expiration_date

Timestamp

Ngày mà mục hết hạn, như 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 là googleExpirationDate và có thể sớm hơn nếu expirationDate là quá xa trong tương lai.
disclosure_date

Timestamp

Ngày mà sản phẩm/dịch vụ xuất hiện trong kết quả tìm kiếm trên các nền tảng của Google trên YouTube, ở định dạng ISO 8601. 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 mà sản phẩm được đặt hàng trước có hàng để giao, ở định dạng ISO 8601.
price

Price

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

Installment

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

SubscriptionCost

Số kỳ (tháng hoặc năm) và số tiền thanh toán cho mỗi kỳ cho một mặt hàng có hợp đồng thuê bao liên quan.
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 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 trong quảng cáo của mặt hàng.
sale_price_effective_date

Interval

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

ProductDimension

Chiều cao của sản phẩm tính 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 tính bằng các đơ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 các đơ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

Bạn cần đáp ứng các điều kiện để sản phẩm được vận chuyển miễn phí.
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

Đoạn cắt của mặt hàng. Thuộc tính này có thể dùng để đại diện cho các loại kích thước kết hợp của các mặt hàng may mặc. 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ố lượng đo lường 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

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

string

Các đề 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 vị trí xuất hiện cần đưa vào mục tiêu này (tương ứng với hộp kiểm đã đánh dấu trong Merchant Center). Đích đến mặc định luôn được đưa vào trừ phi được cung cấp trong excludedDestinations.
excluded_destinations[]

string

Danh sách các vị trí xuất hiện cần loại trừ khỏi mục tiêu này (tương ứng với các hộp kiểm chưa đánh dấu 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 đích đến của Quảng cáo mua sắm. Các quốc gia trong danh sách này sẽ bị xoá khỏi những quốc gia đã thiết lập trong chế độ 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, ví dụ như dán nhãn hiệu suất năng lượng của những sản phẩm được ghi lại trong cơ sở dữ liệu EPREL của EU. Hãy xem bài viết này trên 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 các 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) giúp đảm bảo mức chiết khấu cho mặt hàng của người bán không thấp hơn giá trị này, nhờ đó duy trì giá trị và khả năng sinh lời của ưu đãi.
identifier_exists

bool

Hãy đặ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, chẳng hạn như GTIN (Mã số sản phẩm thương mại toàn cầu), MPN (Mã số linh kiện của nhà sản xuất) và thương hiệu. Giá trị mặc định là true (đú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 tùy chỉnh gồm các sản phẩm khác nhau mà người bán bán theo 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ả mặt hàng.
adult

bool

Đặt thành true nếu mặt hàng nhắm đến người lớn.
age_group

string

Nhắm đến nhóm tuổi của mặt hàng.
availability

string

Trạng thái 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 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ục tiêu của mặt hàng.
google_product_category

string

Danh mục mặt hàng của Google (xem bài viết Hệ thống 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 danh mục sản phẩm của Google được tự động chỉ định thông qua API.
gtin

string

Mã số sản phẩm thương mại toàn cầu (GTIN) của mặt hàng.
item_group_id

string

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

string

Chất liệu tạo ra 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ỉ được hỗ trợ cho các sản phẩm bán trực tuyến.
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 các 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ục. Chỉ cho 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 từng kích thước có cùng giá trị itemGroupId (xem [https://support.google.com/merchants/answer/6324492](định nghĩa kích thước)).
size_system

string

Hệ thống mà 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, dùng để định cấu hình mối liên hệ chi tiết về thuế trong chế độ cài đặt thuế ở cấp tài khoản.
energy_efficiency_class

string

Cấp hiệu suất năng lượng theo 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 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 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 khuyến khích nếu không được sử dụng.
ads_redirect

string

Cho phép nhà quảng cáo thay thế URL của mặt hàng khi sản phẩm xuất hiện trong ngữ cảnh của Quảng cáo sản phẩm.
display_ads_id

string

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

string

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

double

Lợi nhuận của 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 lấy tại cửa hàng.
custom_label_0

string

Nhãn tuỳ chỉnh 0 để nhóm các mặt hàng tuỳ chỉnh trong một 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 tuỳ chỉnh trong một 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 tuỳ chỉnh trong một 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 tuỳ chỉnh trong một 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 tuỳ chỉnh trong một 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ục này sẽ bị tạm dừng.
structured_title

ProductStructuredTitle

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

ProductStructuredDescription

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

Chứng nhận

Chứng nhận sản phẩm, ban đầu được giới thiệu nhằm tuân thủ việc dán nhãn hiệu suất năng lượng của EU thông qua cơ sở dữ liệu EPREL của EU.

Trường
certification_authority

string

Tổ chức phát hành chứng nhận, ví dụ: "European_Commission". Độ dài tối đa là 2000 ký tự.
certification_name

string

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

string

Mã chứng nhận. Độ dài tối đa là 2000 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ụ như "A+", "C", "vàng". Độ dài tối đa là 2000 ký tự.

CloudExportAdditionalProperties

Thuộc tính sản phẩm cho Cloud Retail API. Ví dụ: thuộc tính cho một 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 sản phẩm TV. Giá trị này lặp lại tối đa 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 một thuộc tính đã cho. Ví dụ: 1080 cho Độ phân giải màn hình của một sản phẩm TV. Giá trị này lặp lại tối đa 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ị số thực của thuộc tính đã cho. Ví dụ đối với sản phẩm TV 1.2345. Giá trị này lặp lại tối đa 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 một 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 một sản phẩm TV, "True" hoặc "False" nếu màn hình là UHD.
min_value

float

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

float

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

string

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

DeleteProductInputRequest

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

Trường
name

string

Bắt buộc. Tên của tài nguyên nhập vào sản phẩm cần xoá. Định dạng: accounts/{account}/productInputs/{product}
data_source

string

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

FreeShippingThreshold

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

Trường
country

string

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

Price

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

GetProductRequest

Thông báo yêu cầu đối với 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}

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à bạn sẽ chèn sản phẩm này. Định dạng: accounts/{account}
product_input

ProductInput

Bắt buộc. Giá trị nhập vào của sản phẩm cần chèn.
data_source

string

Bắt buộc. Tên 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 này sẽ được chuyển sang một nguồn dữ liệu mới. Định dạng: accounts/{account}/dataSources/{datasource}.

Trả góp

Thông báo đại diện cho hình thức 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 toàn bộ mà người mua phải trả.
credit_type

string

Hình thức thanh toán trả góp. Các giá trị được hỗ trợ là: * "finance" * "lease"

ListProductsRequest

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

Trường
parent

string

Bắt buộc. Tài khoản để liệt kê các 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ả lại. Dịch vụ có thể trả về ít hơn giá trị này. Giá trị lớn nhất là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000. Nếu bạn chưa 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 mã 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

Sản phẩm đã xử lý từ tài khoản được chỉ định. Đây là những sản phẩm đã 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 trường này bị bỏ qua thì sẽ không có trang tiếp theo.

LoyaltyPoints

Một thông điệp tượng trưng cho điểm khách hàng thân thiết.

Trường
name

string

Tên chương trình điểm khách hàng thân thiết. Bạn nên sử dụng tối đa 12 ký tự có độ 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ệ của một điểm khi chuyển đổi sang đơn vị tiền tệ. Google giả định đơn vị tiền tệ dựa trên chế độ cài đặt của Merchant Center. Nếu bạn không để tỷ lệ này, giá trị mặc định sẽ là 1.0.

LoyaltyProgram

Một 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à nhãn nội bộ xác định duy nhất mối quan hệ giữa pháp nhân người bán và pháp nhân 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ụ như 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ể được sử dụng cho các giao dịch mua trong tương lai.
loyalty_points

int64

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

Sản phẩm

Sản phẩm đã xử lý được tạo từ nhiều [dữ liệu đầu vào của sản phẩm][[google.shopping.content.bundles.Products.ProductInput] 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 của bạn và trong quảng cáo Mua sắm cũng như các nền tảng khác của Google. Mỗi sản phẩm được tạo từ đúng một dữ liệu đầu vào cho sản phẩm của nguồn dữ liệu chính và nhiều dữ liệu đầu vào của nguồn dữ liệu bổ sung. Sau khi chèn, cập nhật hoặc xoá thông tin đầu vào của sản phẩm, hệ thống có thể mất vài phút để truy xuất sản phẩm đã xử lý mà bạn đã 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, trừ một số trường hợp ngoại lệ.

Trường
name

string

Tên sản phẩm. Định dạng "{product.name=accounts/{account}/products/{product}}"
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 duy nhất của sản phẩm. Điều này tương tự với sản phẩm đầu vào và sản phẩm đã xử lý. Khoảng trắng ở đầu và ở cuối bị xoá đi và nhiều khoảng trắng được thay bằng một khoảng trắng duy nhất khi gửi. Tham khảo quy cách dữ liệu sản phẩm để biết chi tiết.
content_language

string

Chỉ có đầu ra. Mã ngôn ngữ gồm hai chữ cái theo tiêu chuẩn ISO 639-1 cho 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ể gửi bất kỳ thuộc tính nào của quy cách dữ liệu ở dạng chung chung (ví dụ: { "name": "size type", "value": "regular" }). Cách này rất hữu ích khi gửi các thuộc tính mà API không nêu rõ, 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 một sản phẩm, vấn đề về xác thực dữ liệu, tức là thông tin về một sản phẩm được tính toán không đồng bộ.
version_number

int64

Chỉ có đầu ra. Đại diện cho phiên bản hiện có (độ mới) của sản phẩm, có thể được dùng để duy trì thứ tự phù hợp khi nhiều nội dung cập nhật được thực hiện cùng một lúc.

Nếu bạn đặt số này, việc chèn sẽ không được thực hiệ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 này bị ngăn chặn, thì ngoại lệ bị huỷ sẽ được gửi.

ProductDetail

Chi tiết sản phẩm.

Trường
section_name

string

Tiêu đề mục dùng để nhóm một bộ chi tiết sản phẩm.
attribute_name

string

Tên 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 thị dưới dạng số. Giá trị này có thể có độ chính xác tối đa là bốn chữ số thập phân.
unit

string

Bắt buộc. Các đơn vị thứ nguyê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, quy tắc và nguồn dữ liệu bổ sung về sản phẩm được kết hợp để tạo ra [sản phẩm][google.shopping.content.bundles.Products.Product] đã xử lý.

Các thuộc tính bắt buộc đầu vào 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][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] và [offerId][google.shopping.content.bundles.Products.offer_id].

Sau khi chèn, cập nhật hoặc xoá thông tin đầu vào của sản phẩm, hệ thống có thể mất vài phút để truy xuất được sản phẩm đã xử lý.

Tất cả các trường trong dữ liệu đầu vào của sản phẩm và thông báo phụ của sản phẩm đều khớp với tên tiếng Anh của thuộc tính tương ứng trong thông số ngành dọc với một số trường hợp ngoại lệ.

Trường
name

string

Giá trị nhận dạng. Tên đầu vào của sản phẩm. Định dạng "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

Chỉ có đầu ra. Tên của sản phẩm đã xử lý. Định dạng "{product.name=accounts/{account}/products/{product}}"
channel

ChannelEnum

Bắt buộc. 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 duy nhất của sản phẩm. Điều này tương tự với sản phẩm đầu vào và sản phẩm đã xử lý. Khoảng trắng ở đầu và ở cuối bị xoá đi và nhiều khoảng trắng được thay bằng một khoảng trắng duy nhất khi gửi. Xem quy cách dữ liệu sản phẩm để biết chi tiết.
content_language

string

Bắt buộc. Không thể thay đổi. Mã ngôn ngữ gồm hai chữ cái theo tiêu chuẩn ISO 639-1 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 cho 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ể sử dụng thuộc tính này để gửi bất kỳ thuộc tính nào của quy cách dữ liệu ở dạng chung chung (ví dụ: { "name": "size type", "value": "regular" }). Cách này rất hữu ích khi gửi các thuộc tính không được API nêu rõ, 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ố lượng ký tự tối đa cho phép đối với mỗi thuộc tính tuỳ chỉnh là 10240 (đại diện cho tổng số ký tự của 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,4kB. Sau khi chèn, 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.
version_number

int64

Không bắt buộc. Đại diện cho phiên bản hiện có (độ mới) của sản phẩm, có thể được dùng để duy trì thứ tự phù hợp khi nhiều nội dung cập nhật được thực hiện cùng một lúc.

Nếu bạn đặt số này, việc chèn sẽ không được thực hiệ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 này bị ngăn chặn, thì ngoại lệ bị huỷ sẽ được gửi.

ProductStatus

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

Trường
destination_statuses[]

DestinationStatus

Vị trí xuất hiện dự kiến cho sản phẩm.
item_level_issues[]

ItemLevelIssue

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

Timestamp

Ngày tạo mục, ở đị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 đến 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 mặt hàng được phê duyệt.
pending_countries[]

string

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

string

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

ItemLevelIssue

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

Trường
code

string

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

Severity

Vấn đề này ảnh hưởng như thế nào đến việc phân phát của mặt hàng.
resolution

string

Liệu người bán có thể giải quyết vấn đề này 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 duy nhất gây ra.
reporting_context

ReportingContextEnum

Ngữ cảnh báo cáo áp dụng vấn đề.
description

string

Nội dung mô tả ngắ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 một 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) có vấn đề áp dụng với mặt hàng.

Mức độ nghiêm trọng

Ảnh hưởng của vấn đề đến hoạt động phân phát sản phẩm.

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

ProductStructuredDescription

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

Trường
digital_source_type

string

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

string

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

ProductStructuredTitle

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

Trường
digital_source_type

string

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

string

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

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ố. Trọng số 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ị trọng lượng. Các giá trị được chấp nhận là: * "g" * "kg" * "oz" * "lb"

Vận chuyển

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

Trường
price

Price

Giá vận chuyển cố định, được thể hiện bằng một số.
country

string

Mã lãnh thổ CLDR của quốc gia mà 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 mục 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ã dạng số của một vị trí được áp dụng mức phí vận chuyển này, xác định trong API AdWords.
location_group_name

string

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

string

Phạm vi mã bưu chính áp dụng 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 *, là 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ả ngày này) tính từ khi nhận được đơn đặt hàng đến khi giao hàng (tính theo ngày làm việc). 0 có nghĩa là đơn đặt hàng được vận chuyển trong cùng ngày nhận được nếu đơn đặt hàng đó diễn ra trước hạn chót nhận đơn đặt hàng. Thuộc tính [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time]: giá trị này chỉ có thể xuất hiện khi có thuộc tính [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]; nhưng không bắt buộc nếu có giá trị [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
max_handling_time

int64

Thời gian xử lý tối đa (bao gồm cả ngày này) tính từ khi nhận được đơn đặt hàng đến khi giao hàng (tính theo ngày làm việc). 0 có nghĩa là đơn đặt hàng được vận chuyển trong cùng ngày nhận được nếu đơn đặt hàng đó diễn ra trước hạn chót nhận đơn đặt hàng. Cả [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] và [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] đều khác nếu cung cấp tốc độ vận chuyển. Bạn không bắt buộc phải sử dụng [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] nếu có thuộc tính [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
min_transit_time

int64

Thời gian vận chuyển tối thiểu (bao gồm cả ngày này) tính từ khi đơn đặt hàng được vận chuyển đến khi đơn đặt hàng được giao (tính 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][google.shopping.content.bundles.Products.Shipping.min_transit_time] chỉ có thể xuất hiện cùng với [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]; nhưng không bắt buộc nếu có [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].
max_transit_time

int64

Thời gian vận chuyển tối đa (bao gồm cả ngày này) tính từ khi đơn đặt hàng được vận chuyển đến khi đơn đặt hàng được giao (tính 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. Cả [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] và [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] đều khác nếu cung cấp tốc độ vận chuyển. Bạn không bắt buộc phải sử dụng [mintransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] nếu có thuộc tính [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].

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ị của 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ị của giá trị.

SubscriptionCost

Chi phí thuê bao 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 của gói 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ỳ hạn của gói thuê bao.

SubscriptionPeriod

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

Enum
SUBSCRIPTION_PERIOD_UNSPECIFIED Cho biết thời hạn của gói thuê bao chưa được chỉ định.
MONTH Cho biết thời hạn của gói thuê bao là tháng.
YEAR Cho biết thời hạn của gói thuê bao là một năm.

Thuế

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

Trường
rate

double

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

string

Quốc gia nơi mặt hàng bị đánh thuế, được chỉ định theo mã lãnh thổ CLDR.
region

string

Khu vực địa lý áp dụng thuế suất.
tax_ship

bool

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

int64

Mã dạng số của một vị trí được áp dụng thuế suất này theo xác định trong API AdWords.
postal_code

string

Phạm vi mã bưu chính mà thuế suất áp dụng, được thể hiện bằng một mã ZIP, một tiền tố mã ZIP sử dụng ký tự đại diện *, là phạm vi giữa 2 mã ZIP hoặc 2 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

Đơn vị đo lường 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.