add_alert
Lưu ý quan trọng: Content API for Shopping sẽ ngừng hoạt động từ ngày 18 tháng 8 năm 2026.
rocket
Giới thiệu về
Merchant API
– API chính thức thay thế cho Content API for Shopping.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Lỗi thường gặp
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Sau đây là những lỗi phổ biến nhất:
Sau đây là danh sách các lỗi theo thứ tự bảng chữ cái.
auth/account_access_denied
User cannot access account
<account_number> |
|---|
| Tóm tắt | Đã đưa ra một yêu cầu nhắm đến một tài khoản mà người dùng được xác thực không có quyền truy cập. |
| Nguyên nhân thường gặp | Lỗi về mã người bán mục tiêu hoặc quên đăng ký người dùng trong Merchant Center. |
| Các mẹo xử lý được đề xuất | Kiểm tra để đảm bảo rằng bạn đang nhắm đến đúng tài khoản hoặc đăng ký làm người dùng của tài khoản trong Merchant Center (Cài đặt > Người dùng). |
| Mẹo phòng tránh dịch | NA |
User is not an administrator of
account <account_number> |
|---|
| Tóm tắt | Đưa ra yêu cầu sửa đổi một tài khoản mà người dùng được xác thực không có quyền quản trị. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Đặt quyền quản trị cho người dùng đã xác thực. |
| Mẹo phòng tránh dịch | NA |
xung đột
[productId] Product ID <product
id> is already modified by another entry in the same request for merchant
<merchant> and store code <store code> |
|---|
| Tóm tắt | Đã thử nhiều thao tác xung đột cùng lúc. |
| Nguyên nhân thường gặp | Một yêu cầu theo lô chứa nhiều thao tác xung đột cho cùng một sản phẩm hoặc nhiều thao tác xung đột cho cùng một sản phẩm được gửi đến Content API cùng lúc. |
| Các mẹo xử lý được đề xuất | Xem các biện pháp phòng ngừa. |
| Mẹo phòng tránh dịch | Chứa tất cả các thay đổi cho một sản phẩm nhất định thành một thao tác duy nhất trong một nhóm yêu cầu theo lô. Cố gắng tránh nhiều lệnh gọi đồng thời đến Content API cho cùng một người bán và mã cửa hàng, hoặc đảm bảo rằng những lệnh gọi đó không chứa các sản phẩm trùng lặp. |
internalError
Internal error |
|---|
| Tóm tắt | Đã xảy ra sự cố với hệ thống phụ trợ của Google. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Thử gửi lại yêu cầu.
Liên hệ với chúng tôi nếu bạn liên tục không thành công. |
| Mẹo phòng tránh dịch | NA |
không hợp lệ
Invalid channel:
'<channel>' |
|---|
| Tóm tắt | Kênh không hợp lệ được cung cấp trong mã sản phẩm.
Ví dụ: not_a_channel:en:US:sku123. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | NA |
| Mẹo phòng tránh dịch | Đảm bảo mã nhận dạng sản phẩm của bạn có dạng channel:languageCode:countryCode:offerId, ví dụ: online:en:US:sku123. Để biết thêm thông tin, hãy tham khảo tài liệu tham khảo về
Products.insert. |
[countrycode] Invalid country code:
'<country_code>' |
|---|
| Tóm tắt | Mã quốc gia không hợp lệ được cung cấp trong mã sản phẩm.
Ví dụ: online:en:not_a_country_code:sku123. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | NA |
| Mẹo phòng tránh dịch | Đảm bảo mã sản phẩm của bạn có dạng channel:languageCode:countryCode:offerId và mã quốc gia là mã quốc gia
ISO 3166 hợp lệ. |
[item id] Invalid item
id: '<id>' |
|---|
| Tóm tắt | Mã mặt hàng không hợp lệ, ví dụ: sku123 thay vì online:en:US:sku123. |
| Nguyên nhân thường gặp | Chỉ định mã ưu đãi thay vì mã sản phẩm trong yêu cầu GET hoặc DELETE. |
| Các mẹo xử lý được đề xuất | NA |
| Mẹo phòng tránh dịch | Đảm bảo mã nhận dạng sản phẩm của bạn có dạng channel:languageCode:countryCode:offerId. |
[name] The term '<term>' is not
allowed |
|---|
| Tóm tắt | Tên chứa từ bị cấm. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Sử dụng tên được phép.
Tham khảo bài viết về quy cách nguồn cấp dữ liệu trên Trung tâm trợ giúp để biết thêm thông tin. |
| Mẹo phòng tránh dịch | NA |
[price.currency] Please use a currency
that is supported in the target country |
|---|
| Tóm tắt | Chỉ định một đơn vị tiền tệ không được hỗ trợ ở quốc gia mục tiêu. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Đảm bảo bạn chỉ định chính xác đơn vị tiền tệ và quốc gia. Hãy tham khảo mục về price trong bài viết trên Trung tâm trợ giúp về quy cách nguồn cấp dữ liệu để biết thêm thông tin. |
| Mẹo phòng tránh dịch | NA |
[storeCode] storeCode must be
'online' |
|---|
| Tóm tắt | Đã cố gắng cập nhật giá và tình trạng còn hàng của một sản phẩm trực tuyến thông qua nguồn cấp dữ liệu kho hàng nhưng lại chỉ định một giá trị khác ngoài giá trị đặc biệt online làm mã cửa hàng trong URL. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Thay đổi mã cửa hàng thành online trong URL yêu cầu. |
| Mẹo phòng tránh dịch | Đảm bảo rằng bạn chỉ định online cho sản phẩm trực tuyến và mã cửa hàng cho sản phẩm tại địa phương trong tất cả các truy vấn về kho hàng. |
[<attribute>] |
|---|
| Tóm tắt | Mục được chỉ định trong dấu ngoặc vuông không hợp lệ. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Khắc phục quy cách của mặt hàng có vấn đề, hãy tham khảo bài viết về quy cách nguồn cấp dữ liệu trên Trung tâm trợ giúp để biết thêm thông tin. |
| Mẹo phòng tránh dịch | NA |
notFound
Item not found |
|---|
| Tóm tắt | Mục mà bạn đã cố gắng nhận, cập nhật hoặc xoá không tồn tại. |
| Nguyên nhân thường gặp | Cố gắng xoá một sản phẩm không tồn tại hoặc không chỉ định mã sản phẩm chính xác trong URL để xoá. |
| Các mẹo xử lý được đề xuất | Lấy danh sách sản phẩm bằng cách sử dụng
Products.list và chỉ cố gắng lấy, cập nhật hoặc xoá các mục xuất hiện ở đó. Đảm bảo rằng bạn chỉ định mã sản phẩm ở dạng channel:languageCode:countryCode:offerId, ví dụ: online:ru:RU:277104-ekb thay vì mã ưu đãi có dạng như sau: 277104-ekb. |
| Mẹo phòng tránh dịch | NA |
not_inserted
The item could not be
inserted. |
|---|
| Tóm tắt | Do các lỗi khác, sản phẩm không thể được chèn vì sản phẩm sẽ ghi đè một mục nhập hợp lệ hiện có. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Kiểm tra các lỗi khác cho cùng một lệnh gọi và giải quyết các lỗi đó trước khi thử chèn lại thông tin sản phẩm mới. |
| Mẹo phòng tránh dịch | NA |
hạn mức
too_many_items: Merchant
quota exceeded |
|---|
| Tóm tắt | Bạn đã tải lên Google Mua sắm quá nhiều mặt hàng. |
| Nguyên nhân thường gặp | Các sản phẩm không xác thực được vẫn có thể được chèn nếu chúng không thay thế một sản phẩm hợp lệ hiện có. Hãy cân nhắc sử dụng cờ includeInvalidInsertedItems để Productstatuses.list nhằm đảm bảo tài khoản của bạn không có quá nhiều sản phẩm không hợp lệ. |
| Các mẹo xử lý được đề xuất | Kiểm tra và xoá số lượng sản phẩm không hợp lệ quá mức như đã đề cập ở trên. Ngoài ra, hãy chỉ định
ngày hết hạn khi tải sản phẩm lên. Khi đến ngày hết hạn, sản phẩm sẽ tự động bị xoá. Xin lưu ý rằng ngày hết hạn mặc định và tối đa là 30 ngày sau khi bạn chèn hoặc cập nhật sản phẩm.
Lưu ý: Định mức mặt hàng của tài khoản nhiều khách hàng được kiểm tra dựa trên tổng số sản phẩm trong tất cả tài khoản phụ. Nếu bạn gặp lỗi này với một tài khoản phụ, hãy đảm bảo rằng cả tài khoản phụ và tài khoản nhiều khách hàng (MCA) đều có đủ hạn mức sản phẩm.
Nếu đã thử các giải pháp này mà vẫn không đủ chỗ cho sản phẩm mới trong tài khoản Merchant Center, bạn có thể
yêu cầu được phép gửi thêm mặt hàng trong tài khoản. |
| Mẹo phòng tránh dịch | Xem Các mẹo được đề xuất để xử lý. |
too_many_subaccounts:
Maximum number of subaccounts reached |
|---|
| Tóm tắt | Bạn đã đạt đến số lượng tài khoản phụ tối đa được phép cho tài khoản nhiều khách hàng. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Xoá các tài khoản phụ không còn dùng nữa.
Nếu tất cả tài khoản của bạn đều đang hoạt động, bạn có thể
yêu cầu quyền tạo thêm tài khoản phụ trong tài khoản nhiều khách hàng. |
| Mẹo phòng tránh dịch | NA |
request_rate_too_high:
Request rate too high. Please reduce your throughput |
|---|
| Tóm tắt | Yêu cầu đang được thực hiện quá nhanh; hãy giảm tần suất yêu cầu. |
| Nguyên nhân thường gặp | Tham khảo hạn mức mỗi phút được liệt kê trong các giới hạn đã công bố. Nếu vượt quá các ngưỡng này, bạn sẽ gặp lỗi này. Đôi khi, lưu lượng truy cập tăng đột biến sẽ gây ra vấn đề này hoặc máy chủ của bạn mở rộng sang một số lượng lớn hơn các luồng. |
| Các mẹo xử lý được đề xuất | Giảm tổng số yêu cầu được gửi mỗi phút. |
| Mẹo phòng tránh dịch | Khi bạn nhận được lỗi này, hãy sử dụng các chiến lược giảm tải theo chương trình để giảm tốc độ yêu cầu xuống mức bền vững phù hợp. |
daily_limit_exceeded:
merchant quota exceeded |
|---|
| Tóm tắt | Bạn đang thực hiện nhiều yêu cầu hơn số lượng được phép mỗi ngày cho phương thức dịch vụ đã cho. |
| Nguyên nhân thường gặp | Tham khảo hạn mức mỗi ngày được liệt kê trong các giới hạn đã xuất bản. Nếu vượt quá các ngưỡng này, bạn sẽ gặp lỗi này. |
| Các mẹo xử lý được đề xuất | Giảm tổng số yêu cầu được gửi mỗi ngày bằng cách kết hợp nhiều thay đổi thành một yêu cầu duy nhất khi có thể. Hãy cân nhắc việc thay đổi hàng loạt đối với sản phẩm trong một khoảng thời gian thích hợp để tránh thay đổi một sản phẩm nhiều lần. Đối với những nội dung cập nhật về mặt hàng có thể được biểu thị dưới dạng vi dữ liệu trên trang web của bạn, hãy cân nhắc sử dụng phương pháp đó để giới hạn số lượng lệnh gọi đến các dịch vụ Products hoặc Inventory.
Nếu bạn vẫn cần thêm số lần gọi hằng ngày cho một phương thức cụ thể, vui lòng liên hệ với chúng tôi và cho chúng tôi biết mã Merchant Center của bạn, những phương thức mà bạn đang đạt đến giới hạn hạn mức, ước tính số lần gọi mỗi ngày mà bạn sẽ cần cho những phương thức đó và lý do. Chúng tôi sẽ làm việc với bạn để tăng hạn mức của bạn. |
| Mẹo phòng tránh dịch | Xem Các mẹo được đề xuất để xử lý. |
too_many_failed_auths:
Too many failed authentications. |
|---|
| Tóm tắt | Bạn đang đưa ra quá nhiều yêu cầu hàng loạt cho những tài khoản mà bạn không có quyền truy cập. |
| Nguyên nhân thường gặp | Đưa ra yêu cầu theo lô cho các tài khoản phụ đã bị xoá hoặc cho các tài khoản phụ mới tạo trước khi các tài khoản đó có sẵn. |
| Các mẹo xử lý được đề xuất | Tránh thực hiện các lệnh gọi ảnh hưởng đến tài khoản phụ đã bị xoá. |
| Mẹo phòng tránh dịch | Xem Các mẹo được đề xuất để xử lý. |
request_too_large |
|---|
| Tóm tắt | Bạn đang gửi quá nhiều entries cho mỗi yêu cầu hàng loạt hoặc vượt quá giới hạn kích thước yêu cầu custombatch. |
| Nguyên nhân thường gặp | Bạn có thể đưa vào tối đa 10.000 entries cho mỗi yêu cầu custombatch và giới hạn kích thước truyền được nén là 32 MB. |
| Các mẹo xử lý được đề xuất | Chia lô thành nhiều lô nhỏ hơn giới hạn, sau đó thử lại. |
| Mẹo phòng tránh dịch | Bạn không nên gửi quá 1.000 mục nhập cho mỗi lô. |
bắt buộc
[price.value] Required parameter: price.value |
|---|
| Tóm tắt | Đã chỉ định giá mà không có giá trị. Ví dụ: { "currency": "USD" } thay vì { "value": 123, "currency": "USD" }. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Đảm bảo rằng tham số, ở đây là
price, có định dạng phù hợp. Ví dụ: price có 2 trường bắt buộc: value và currency. |
| Mẹo phòng tránh dịch | NA |
[product] INSERT request must specify
product |
|---|
| Tóm tắt | Gửi một yêu cầu tuỳ chỉnh theo lô đến API có chứa một mục với "method": "insert" nhưng không có sản phẩm. |
| Nguyên nhân thường gặp | Quên thay đổi phương thức thành get hoặc delete. |
| Các mẹo xử lý được đề xuất | Chỉ định một sản phẩm để chèn thông qua trường product. |
| Mẹo phòng tránh dịch | Đảm bảo rằng các mục nhập hàng loạt có phương thức
insert chỉ định một sản phẩm và các mục nhập hàng loạt có phương thức get
hoặc
delete chỉ định một mã sản phẩm. |
[productId] DELETE request must specify
productId |
|---|
| Tóm tắt | Đã gửi một yêu cầu theo lô tuỳ chỉnh đến API có chứa một mục có "method": "delete" nhưng không có mã nhận dạng sản phẩm. |
| Nguyên nhân thường gặp | Quên thay đổi phương thức thành insert. |
| Các mẹo xử lý được đề xuất | Chỉ định một sản phẩm để xoá thông qua trường productID. |
| Mẹo phòng tránh dịch | Đảm bảo rằng các mục nhập hàng loạt có phương thức
insert chỉ định một sản phẩm và các mục nhập hàng loạt có phương thức get
hoặc
delete chỉ định một mã sản phẩm. |
userRateLimitExceeded
User Rate Limit
Exceeded |
|---|
| Tóm tắt | Yêu cầu đang được thực hiện quá nhanh; hãy giảm tần suất yêu cầu. |
| Nguyên nhân thường gặp | Tham khảo giới hạn yêu cầu HTTP có trong các giới hạn đã xuất bản. Nếu vượt quá các ngưỡng này, bạn sẽ gặp lỗi này. Đôi khi, lưu lượng truy cập tăng đột biến sẽ gây ra vấn đề này hoặc máy chủ của bạn mở rộng sang một số lượng lớn các luồng. |
| Các mẹo xử lý được đề xuất | Giảm tổng số yêu cầu được gửi mỗi phút. Việc phân lô nhiều lệnh gọi phương thức đến cùng một dịch vụ thành một yêu cầu custombatch duy nhất sẽ giảm số lượng yêu cầu HTTP được thực hiện. |
| Mẹo phòng tránh dịch | Khi bạn gặp lỗi này, hãy sử dụng chiến lược xử lý hàng loạt và chiến lược thời gian đợi có lập trình để giảm tốc độ yêu cầu xuống mức phù hợp và bền vững. |
xác thực
[adwords_redirect] |
|---|
| Tóm tắt | Bạn đã gửi một sản phẩm có trường adwords_redirect không phải là URL hợp lệ. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Đảm bảo rằng giá trị của trường
adwords_redirect là một URL hợp lệ. |
| Mẹo phòng tránh dịch | NA |
[item] auth/frontend/not_claimed |
|---|
| Tóm tắt | Bạn chưa xác nhận quyền sở hữu URL trang web của người bán trong Merchant Center. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Xác nhận quyền sở hữu URL trong Merchant Center. Bạn có thể xem quy trình chi tiết để thực hiện việc này trong Trung tâm trợ giúp. |
| Mẹo phòng tránh dịch | NA |
[energy_efficiency_class]
validation/feed |
|---|
| Tóm tắt | Bạn đã chỉ định cả energyEfficiencyClass và
đơn giá cho cùng một sản phẩm. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Chỉ định cấp hiệu suất năng lượng hoặc giá theo đơn vị, không chỉ định cả hai. |
| Mẹo phòng tránh dịch | NA |
[item] internal |
|---|
| Tóm tắt | Đã xảy ra lỗi nội bộ. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Thử gửi lại yêu cầu.
Liên hệ với chúng tôi nếu bạn liên tục không thành công. |
| Mẹo phòng tránh dịch | NA |
[item_group_id] invalid_attribute |
|---|
| Tóm tắt | Bạn đã gửi một mặt hàng có cả itemGroupId và nhiều giá trị cho một thuộc tính biến thể (màu sắc, kích thước, hoa văn hoặc chất liệu). |
| Nguyên nhân thường gặp | Chỉ định nhiều kích thước cho một sản phẩm trong khi chỉ định mã nhóm mặt hàng. |
| Các mẹo xử lý được đề xuất | Gửi một sản phẩm riêng biệt cho từng giá trị của một thuộc tính biến thể nhất định, chẳng hạn như
size. |
| Mẹo phòng tránh dịch | NA |
[additional_image_link]
invalid_attribute |
|---|
| Tóm tắt | Bạn đã gửi hơn 10 đường liên kết của hình ảnh bổ sung. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Giới hạn số lượng
đường liên kết của hình ảnh bổ sung ở mức 10. |
| Mẹo phòng tránh dịch | NA |
[<attribute>] invalid_character |
|---|
| Tóm tắt | Đã gửi một thương hiệu, nội dung mô tả hoặc thuộc tính khác dưới dạng một chuỗi không phân tích cú pháp bằng cách sử dụng phương thức mã hoá yêu cầu được chỉ định. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Kiểm tra thông báo để tìm hiểu thuộc tính nào đang gây ra vấn đề, sau đó xác thực chế độ mã hoá văn bản của giá trị tương ứng trước khi gửi lại. API này chỉ chấp nhận các ký tự UTF-8 hợp lệ. |
| Mẹo phòng tránh dịch | NA |
[<attribute>] invalid_value |
|---|
| Tóm tắt | Bạn đã gửi một màu sắc, nội dung mô tả hoặc thuộc tính khác không hợp lệ. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Đảm bảo tất cả thuộc tính đều tuân thủ quy cách nguồn cấp dữ liệu, hãy tham khảo bài viết trên Trung tâm trợ giúp về quy cách nguồn cấp dữ liệu để biết thêm thông tin. Đối với vấn đề về GTIN hoặc MPN, hãy tham khảo
bài viết trên Trung tâm trợ giúp về số nhận dạng sản phẩm duy nhất. |
| Mẹo phòng tránh dịch | NA |
[<attribute>]
missing_recommended/missing_required |
|---|
| Tóm tắt | Bạn đã gửi một sản phẩm mà không có thuộc tính bắt buộc/được đề xuất. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Đảm bảo rằng bạn thêm tất cả thuộc tính bắt buộc / được đề xuất cho sản phẩm của mình. Hãy tham khảo bài viết về quy cách nguồn cấp dữ liệu trên Trung tâm trợ giúp để biết thêm thông tin. |
| Mẹo phòng tránh dịch | NA |
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website |
|---|
| Tóm tắt | Bạn đã gửi một sản phẩm có URL cơ sở khác với URL mà tài khoản Merchant Center đã xác nhận quyền sở hữu. |
| Nguyên nhân thường gặp | NA |
| Các mẹo xử lý được đề xuất | Đảm bảo rằng URL của các sản phẩm đã gửi khớp với trang web mà Merchant Center đã xác nhận quyền sở hữu. |
| Mẹo phòng tránh dịch | NA |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2026-07-06 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2026-07-06 UTC."],[],["The document details errors within the Merchant API, which is the future version of the Content API for Shopping. Key errors involve `notFound` (item does not exist), `not_inserted` (cannot insert due to conflicts), and `quota/too_many_items` (exceeded upload limits). Handling involves verifying product IDs, addressing conflicting entries, and managing quotas. Common causes include incorrect IDs, simultaneous conflicting operations, and exceeding item limits. Prevention focuses on formatting product IDs correctly, batching changes, reducing invalid products, and using product expiration dates. Other errors such as account access, internal issues, URL, currency, ID, and missing parameters are covered.\n"]]