Dưới đây là danh sách các lỗi theo thứ tự bảng chữ cái.
xác thực/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 đã xác thực không có quyền truy cập.
Nguyên nhân thường gặp
Lỗi mã người bán mục tiêu hoặc quên
đăng ký người dùng trong Merchant Center.
Mẹo xử lý được đề xuất
Hãy 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ý đượ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
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 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 đối với cùng một sản phẩm được gửi tới Content API cùng một lúc.
Mẹo xử lý được đề xuất
Xem các mẹo
phòng ngừa.
Mẹo phòng tránh dịch
Chứa mọi thay đổi của một sản phẩm cụ thể đối với một thao tác trong một tập hợp các yêu cầu được phân lô. Cố gắng tránh nhiều lệnh gọi đồng thời đến Content API cho cùng một mã 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 phần phụ trợ của Google.
Nguyên nhân thường gặp
Không áp dụng
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 giải pháp này 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ột 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ý được đề xuất
Không áp dụng
Mẹo phòng tránh dịch
Đả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 về Products.insert.
[countrycode] Invalid country code:
'<country_code>'
Tóm tắt
Mã quốc gia bạn cung cấp trong một 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ý được đề xuất
Không áp dụng
Mẹo phòng tránh dịch
Đảm bảo rằng 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 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ý được đề xuất
Không áp dụng
Mẹo phòng tránh dịch
Đảm bảo rằng mã sản phẩm của bạn có dạng
channel:languageCode:countryCode:offerId.
Tìm cách 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 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
Không áp dụng
Mẹo xử lý được đề xuất
Hãy 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 sản phẩm tại cửa hàng đị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 là không hợp lệ.
Mục bạn cố gắng tải, 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 chính xác mã sản phẩm trong URL để
xoá.
Mẹo xử lý được đề xuất
Xem danh sách sản phẩm bằng cách sử dụng Products.list và chỉ cố gắng tải, cập nhật hoặc xoá những mặt hàng xuất hiện ở đó. Hãy đả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 chứ không phải mã sản phẩm sẽ có dạ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, không thể chèn sản phẩm
vì sản phẩm này sẽ thay thế mục nhập tốt hiện có.
Nguyên nhân thường gặp
Không áp dụng
Mẹo xử lý được đề xuất
Hãy kiểm tra các lỗi khác cho cùng một cuộc gọi và giải quyết các lỗi đó trước khi cố gắng 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
Các sản phẩm không xác thực được vẫn có thể được chèn nếu các sản phẩm này 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 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ý được đề xuất
Kiểm tra và loại bỏ quá nhiều sản phẩm không hợp lệ 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 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ệ thống sẽ kiểm tra hạn mức mặt hàng của tài khoản nhiều khách hàng 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.
request_rate_too_high:
Request rate too high. Please reduce your throughput
Tóm tắt
Yêu cầu đượ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 phần 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 dẫn đến vấn đề này hoặc máy chủ của bạn mở rộng sang số lượng luồng lớn hơn.
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 gặp lỗi này, hãy sử dụng các chiến lược thời gian đợi có lập trình để giảm tỷ lệ yêu cầu xuống mức bền vững và 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ụ nhất định.
Nguyên nhân thường gặp
Tham khảo hạn mức mỗi ngày được liệt kê trong
giới hạn được công bố. Nếu vượt quá các ngưỡng này, bạn sẽ gặp lỗi này.
Mẹo xử lý được đề xuất
Bạn có thể 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 sản phẩm theo lô trong một khoảng thời gian thích hợp để tránh việc sản phẩm thay đổi nhanh chóng nhiều lần. Đối với thông tin 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, 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 lệnh 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 dùng để đạt đến hạn mức, thông tin ước tính về số lệnh gọi mỗi ngày mà bạn cần thực hiện cho những phương thức đó cũng như lý do. 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
Xem 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 các tài khoản phụ mới tạo trước khi
các tài khoản đó được cung cấp.
Mẹo xử lý được đề xuất
Tránh thực hiện các cuộc gọi
ảnh hưởng đến một tài khoản phụ đã bị xoá.
Mẹo phòng tránh dịch
Xem 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 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ể 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ệp nén được chuyển là 32 MB.
Mẹo xử lý được đề xuất
Hãy chia lô dữ liệu đó thành nhiều
lô có giá trị 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 trong 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ý được đề xuất
Hãy đảm bảo rằng tham số ở đây là price được định dạng đúng. Ví dụ: price có 2 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 yêu cầu tuỳ chỉnh theo lô tới API
chứa một mục nhập có "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.
Mẹo xử lý được đề xuất
Hãy 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 bằng 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ột mã sản phẩm.
[productId] DELETE request must specify
productId
Tóm tắt
Đã gửi yêu cầu tuỳ chỉnh theo lô tới API
chứa mục nhập 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ý được đề xuất
Hãy 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 rằng các mục nhập hàng loạt bằng 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ột mã sản phẩm.
userRateLimitExceeded
User Rate Limit
Exceeded
Tóm tắt
Yêu cầu đượ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
Hãy tham khảo các giới hạn yêu cầu HTTP được liệt kê trong 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 dẫn đến 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.
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 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 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 lọc theo lô và đợi có lập trình để giảm tỷ lệ yêu cầu xuống mức bền vững phù hợp.
xác thực
[adwords_redirect]
Tóm tắt
Đã gửi một sản phẩm có trường adwords_redirect không phải là URL hợp lệ.
Đã gửi 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 đã chỉ định.
Nguyên nhân thường gặp
Không áp dụng
Mẹo xử lý được đề xuất
Hãy kiểm tra thông báo để tìm hiểu thuộc tính nào đang gây ra sự cố, sau đó xác thực quá trình 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
Không áp dụng
[<attribute>] invalid_value
Tóm tắt
Bạn đã gửi màu sắc, nội dung mô tả hoặc thuộc tính khác không hợp lệ.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2024-07-03 UTC."],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],[]]
