Sau đây là những lỗi phổ biến nhất:
notFound: Không tìm thấy mục này.not_inserted: Không thể chèn mục này.[link] validation/invalid_value for <destinations>: URL không thuộc về trang web của bạn.- quota/too_many_items: Đã vượt quá hạn mức người bán.
Sau đây là danh sách 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 yêu cầu nhắm đến một tài khoản mà người dùng đã xác thực không có quyền truy cập. |
| Nguyên nhân thường gặp | Lỗi trong mã người bán đích hoặc quên đăng ký người dùng trong Merchant Center. |
| Mẹo xử lý nên dùng | Kiểm tra để đảm bảo rằng bạn đang nhắm đến đúng tài khoản hoặc tự đă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 | Không áp dụng |
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 đã xác thực không có quyền quản trị. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Đặt quyền quản trị cho người dùng đã xác thực. |
| Mẹo phòng tránh dịch | Không áp dụng |
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 hoạt động xung đột cùng một lúc. |
| Nguyên nhân thường gặp | Một yêu cầu theo lô chứa nhiều hoạt động xung đột cho cùng một sản phẩm, hoặc nhiều hoạt động xung đột cho cùng một sản phẩm đã được gửi đến Content API cùng một lúc. |
| Mẹo xử lý nên dùng | Xem các mẹo phòng ngừa. |
| Mẹo phòng tránh dịch | Chứa tất cả các thay đổi của một sản phẩm nhất định đối với một hoạt động trong một tập hợp các 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 các 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 chương trình phụ trợ của Google. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Thử gửi lại yêu cầu. Hãy cho chúng tôi biết về vấn đề này trên diễn đàn nếu liên tục không thành công. |
| Mẹo phòng tránh dịch | Không áp dụng |
không hợp lệ
Invalid channel:
'<channel>' |
|
|---|---|
| Tóm tắt | Bạn cung cấp kênh không hợp lệ trong mã sản phẩm.
Ví dụ: not_a_channel:en:US:sku123. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Không áp dụng |
| Mẹo phòng tránh dịch | Hãy đảm bảo rằng mã 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 cho
Products.insert. |
[countrycode] Invalid country code:
'<country_code>' |
|
| Tóm tắt | Mã quốc gia đã cung cấp trong mã sản phẩm không hợp lệ.
Ví dụ: online:en:not_a_country_code:sku123. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Không áp dụng |
| Mẹo phòng tránh dịch | Hãy đảm bảo mã sản phẩm có dạng channel:languageCode:countryCode:offerId và mã quốc gia là mã quốc gia hợp lệ theo tiêu chuẩn
ISO 3166. |
[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. |
| Mẹo xử lý nên dùng | Không áp dụng |
| Mẹo phòng tránh dịch | Hãy đảm bảo rằng mã 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 có chứa từ bị cấm. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Sử dụng tên được phép. Hãy tham khảo bài viết này trong 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 | Không áp dụng |
[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 | Không áp dụng |
| Mẹo xử lý nên dùng | Hãy đảm bảo bạn đã chỉ định chính xác đơn vị tiền tệ và quốc gia. Tham khảo phần 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 | Không áp dụng |
[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 đã chỉ định 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 | Không áp dụng |
| Mẹo xử lý nên dùng | Thay đổi mã cửa hàng thành online trong URL yêu cầu. |
| Mẹo phòng tránh dịch | Hãy đảm bảo rằng bạn chỉ định online
cho các sản phẩm trực tuyến và mã cửa hàng cho các sản phẩm tại cửa hàng địa phương trong tất cả
các truy vấn kho hàng của bạn. |
[<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 | Không áp dụng |
| Mẹo xử lý nên dùng | Khắc phục quy cách của mục vấn đề, tham khảo bài viết về Quy cách nguồn cấp dữ liệu trong Trung tâm trợ giúp để biết thêm thông tin. |
| Mẹo phòng tránh dịch | Không áp dụng |
notFound
Item not found |
|
|---|---|
| Tóm tắt | Mục mà bạn cố gắng lấy, cập nhật hoặc xoá không tồn tại. |
| Nguyên nhân thường gặp | Tìm cách xoá một sản phẩm không tồn tại hoặc không chỉ định chính xác mã sản phẩm trong URL để xoá. |
| Mẹo xử lý nên dùng | Nhận danh sách sản phẩm bằng
Products.list và chỉ tìm cách tải, cập nhật hoặc xoá những mặt hàng xuất hiện trong đó. Đảm bảo bạn chỉ định mã sản phẩm trong biểu mẫu channel:languageCode:countryCode:offerId, ví dụ: online:ru:RU:277104-ekb thay vì mã mặt hàng như sau: 277104-ekb. |
| Mẹo phòng tránh dịch | Không áp dụng |
not_inserted
The item could not be
inserted. |
|
|---|---|
| Tóm tắt | Do các lỗi khác, bạn không thể chèn sản phẩm vì sản phẩm này sẽ ghi đè lên một mục nhập hợp lệ hiện có. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Hãy 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 tìm cách chèn lại thông tin sản phẩm mới. |
| Mẹo phòng tránh dịch | Không áp dụng |
định mức
too_many_items: Merchant
quota exceeded |
|
|---|---|
| Tóm tắt | Đã tải quá nhiều mặt hàng lên Google Mua sắm. |
| Nguyên nhân thường gặp | Những sản phẩm không xác thực được vẫn có thể
được chèn vào nếu không thay thế được một sản phẩm hợp lệ hiện có. Hãy cân nhắc sử dụng cờ
includeInvalidInsertedItems cho Productstatuses.list để đả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ệ. |
| Mẹo xử lý nên dùng | Kiểm tra và xoá quá nhiều sản phẩm không hợp lệ như nêu 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 chèn hoặc cập nhật sản phẩm. Lưu ý: Hạn mức mặt hàng của tài khoản nhiều khách hàng được kiểm tra so với tổng số sản phẩm trong tất cả các tài khoản phụ. Nếu bạn gặp lỗi này với tài khoản phụ, hãy đảm bảo rằng cả tài khoản phụ và MCA của bạn đề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 còn dung lượng cho các sản phẩm mới trong tài khoản Merchant Center, bạn có thể yêu cầu gửi thêm mặt hàng trong tài khoản của mình. |
| Mẹo phòng tránh dịch | Hãy xem phần Mẹo xử lý được đề xuất. |
too_many_subaccounts:
Maximum number of subaccounts reached |
|
| Tóm tắt | Tài khoản nhiều khách hàng của bạn đã đạt số lượng tài khoản phụ tối đa được phép. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Xoá các tài khoản phụ đã lỗi thời. Nếu tất cả các tài khoản của bạn đều đang hoạt động, bạn có thể yêu cầu 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 | Không áp dụng |
request_rate_too_high:
Request rate too high. Please reduce your throughput |
|
| Tóm tắt | Các yêu cầu được đưa ra quá nhanh; hãy giảm tần suất gửi yêu cầu. |
| Nguyên nhân thường gặp | Tham khảo hạn mức mỗi phút nêu trong 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 gây ra tình trạng này hoặc máy chủ của bạn mở rộng thành số lượng luồng lớn hơn. |
| Mẹo xử lý nên dùng | 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 gặp lỗi này, hãy sử dụng chiến lược thời gian đợi có lập trình để giảm tỷ lệ yêu cầu của bạn 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 hơn số lượng yêu cầu được cho phép mỗi ngày đối với 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 hạn mức đã xuất bản. Nếu vượt quá các ngưỡng này, bạn sẽ gặp lỗi này. |
| Mẹo xử lý nên dùng | 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 vào một yêu cầu duy nhất nếu có thể. Hãy cân nhắc việc thay đổi sản phẩm theo lô trong một khoảng thời gian thích hợp để tránh việc thay đổi nhanh một sản phẩm nhiều lần. Đối với các nội dung cập nhật mục có thể được biểu thị dưới dạng vi dữ liệu trên trang web, hãy cân nhắc sử dụng phương pháp đó để giới hạn số lệnh gọi đến các dịch vụ Nếu bạn vẫn cần có thêm số cuộc gọi hằng ngày đến một phương thức nhất định, vui lòng liên hệ với chúng tôi và cho chúng tôi biết mã truy cập Merchant Center của bạn, phương thức bạn muốn đạt đến hạn mức, thông tin ước tính về số cuộc gọi mỗi ngày bạn cần cho những phương thức đó và lý do bạn cần làm việc này. Chúng tôi sẽ làm việc với bạn để tăng hạn mức. |
| Mẹo phòng tránh dịch | Hãy xem phần Mẹo xử lý được đề xuất. |
too_many_failed_auths:
Too many failed authentications. |
|
| Tóm tắt | Bạn đang thực hiện 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 | Gửi yêu cầu hàng loạt cho các tài khoản phụ đã bị xoá hoặc tài khoản phụ mới tạo trước khi các tài khoản đó hoạt động. |
| Mẹo xử lý nên dùng | Tránh thực hiện các cuộc gọi ảnh hưởng đến tài khoản phụ đã bị xoá. |
| Mẹo phòng tránh dịch | Hãy xem phần Mẹo xử lý được đề xuất. |
request_too_large |
|
| Tóm tắt | Bạn đang gửi quá nhiều entries cho mỗi yêu cầu theo lô hoặc vượt quá giới hạn kích thước yêu cầu là custombatch. |
| Nguyên nhân thường gặp | Bạn có thể thêm tối đa 10.000 entries cho mỗi
yêu cầu custombatch và giới hạn kích thước tải xuống được nén là 32 MB. |
| Mẹo xử lý nên dùng | Hãy chia lô đó thành nhiều lô thấp hơn giới hạn rồi 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 mỗi lô. |
bắt buộc
[price.value] Required parameter: price.value |
|
|---|---|
| Tóm tắt | Đã chỉ định một mức 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 | Không áp dụng |
| Mẹo xử lý nên dùng | Hãy đảm bảo tham số, ở đây là
price, đã được định dạng đúng. Ví dụ: price có hai trường bắt buộc: value và currency. |
| Mẹo phòng tránh dịch | Không áp dụng |
[product] INSERT request must specify
product |
|
| Tóm tắt | Đã gửi một yêu cầu tuỳ chỉnh theo lô cho API chứa mục nhập có "method": "insert" nhưng không có sản phẩm nào. |
| Nguyên nhân thường gặp | Quên thay đổi phương thức thành get
hoặc delete. |
| Mẹo xử lý nên dùng | 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 các mục nhập lô 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 bằng phương thức get
hoặc
delete chỉ định mã sản phẩm. |
[productId] DELETE request must specify
productId |
|
| Tóm tắt | Đã gửi một yêu cầu tuỳ chỉnh theo lô cho API chứa một mục có "method": "delete" nhưng không có mã sản phẩm. |
| Nguyên nhân thường gặp | Quên thay đổi phương thức thành insert. |
| Mẹo xử lý nên dùng | Chỉ định một sản phẩm cần xoá thông qua trường productID. |
| Mẹo phòng tránh dịch | Đảm bảo các mục nhập lô 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 bằng phương thức get
hoặc
delete chỉ định mã sản phẩm. |
userRateLimitExceeded
User Rate Limit
Exceeded |
|
|---|---|
| Tóm tắt | Các yêu cầu được đưa ra quá nhanh; hãy giảm tần suất gửi yêu cầu. |
| Nguyên nhân thường gặp | Hãy tham khảo các giới hạn đối với yêu cầu HTTP được liệt kê trong 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 gây ra tình trạng này hoặc máy chủ của bạn mở rộng ra số lượng luồng lớn hơn. |
| Mẹo xử lý nên dùng | Giảm tổng số yêu cầu được gửi mỗi phút. Việc gộp 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ẽ làm 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 các chiến lược thời gian đợi theo lô và có lập trình để giảm tỷ lệ yêu cầu của bạn xuống mức bền vững phù hợp. |
xác thực
[adwords_redirect] |
|
|---|---|
| Tóm tắt | Đã gửi sản phẩm có trường adwords_redirect
không phải là một URL hợp lệ. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Hãy đảm bảo giá trị của trường
adwords_redirect là một URL hợp lệ. |
| Mẹo phòng tránh dịch | Không áp dụng |
[item] auth/frontend/not_claimed |
|
| Tóm tắt | 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 | Không áp dụng |
| Mẹo xử lý nên dùng | Hãy 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 | Không áp dụng |
[energy_efficiency_class]
validation/feed |
|
| Tóm tắt | Chỉ định cả energyEfficiencyClass và
định giá theo đơn vị cho cùng một sản phẩm. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Chỉ xác định cấp hiệu suất năng lượng hoặc định giá theo đơn vị, chứ không phải cả hai. |
| Mẹo phòng tránh dịch | Không áp dụng |
[item] internal |
|
| Tóm tắt | Lỗi nội bộ. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Thử gửi lại yêu cầu. Hãy cho chúng tôi biết trên diễn đàn nếu liên tục không thành công. |
| Mẹo phòng tránh dịch | Không áp dụng |
[item_group_id] invalid_attribute |
|
| Tóm tắt | Đã gửi một mặt hàng có cả itemGroupId và nhiều giá trị cho 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. |
| Mẹo xử lý nên dùng | Hãy gửi một sản phẩm khác cho mỗi 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 | Không áp dụng |
[additional_image_link]
invalid_attribute |
|
| Tóm tắt | Đã 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 | Không áp dụng |
| Mẹo xử lý nên dùng | Giới hạn số lượng đường liên kết của hình ảnh bổ sung là 10. |
| Mẹo phòng tránh dịch | Không áp dụng |
[<attribute>] invalid_character |
|
| Tóm tắt | Đã gửi thương hiệu, nội dung mô tả hoặc thuộc tính khác dưới dạng chuỗi không phân tích cú pháp bằng phương thức mã hoá yêu cầu được chỉ định. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Hãy 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 chỉ chấp nhận các ký tự UTF-8 hợp lệ. |
| Mẹo phòng tránh dịch | Không áp dụng |
[<attribute>] invalid_value |
|
| Tóm tắt | Đã gửi 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 | Không áp dụng |
| Mẹo xử lý nên dùng | Đảm bảo mọi 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 này trong 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 các vấn đề về GTIN hoặc MPN, hãy tham khảo bài viết về mã nhận dạng sản phẩm duy nhất trong Trung tâm trợ giúp. |
| Mẹo phòng tránh dịch | Không áp dụng |
[<attribute>]
missing_recommended / missing_required |
|
| Tóm tắt | Đã gửi một sản phẩm không có thuộc tính bắt buộc/nên dùng. |
| Nguyên nhân thường gặp | Không áp dụng |
| Mẹo xử lý nên dùng | Đảm bảo bạn đã thêm tất cả các thuộc tính đề xuất / bắt buộc cho sản phẩm. Hãy tham khảo bài viết trong 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 | Không áp dụng |
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website |
|
| Tóm tắt | Đã 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 | Không áp dụng |
| Mẹo xử lý nên dùng | Hãy đả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 | Không áp dụng |