Các vấn đề đã biết

Trang này ghi lại những vấn đề đã biết mà nhà phát triển gặp phải với Merchant API.

UnauthenticatedException lỗi ngẫu nhiên

Đã báo cáo: 30/3/2026 theo giờ UTC

Nhiều khách hàng đang gặp phải UnauthenticatedExceptionlỗi không liên tục khi tải sản phẩm lên và truy cập vào các API khác của Merchant Center. Lỗi xảy ra ngẫu nhiên, ngay cả khi có các lần thử lại, và ảnh hưởng đến cả các lệnh gọi ban đầu và các lần thử tiếp theo. Một số kết nối không thành công trong khi những kết nối khác thành công trong một khoảng thời gian ngắn.

Hiện chưa có giải pháp thay thế hoặc đề xuất nào.

Độ trễ cao, DEADLINE_EXCEEDED và INTERNAL_ERROR cho các phương thức sản phẩm và kho hàng

Ngày báo cáo: 18/3/2026 (giờ UTC) | Ngày giải quyết: 31/3/2026 (giờ UTC)

Một số người dùng gặp phải tình trạng độ trễ kéo dài và thường xuyên nhận được thông báo DEADLINE_EXCEEDED hoặc INTERNAL_ERROR khi sử dụng các phương thức productInputs và regionalInventories. Nguyên nhân chính được xác định là một sự cố ở cấp phụ trợ ảnh hưởng đến hiệu quả xử lý.

Giải pháp: Sự cố này đã được giảm thiểu hoàn toàn vào ngày 31 tháng 3 năm 2026. Sau khi giảm nhẹ, tỷ lệ lỗi đã giảm đáng kể. Nếu vẫn gặp phải độ trễ cao, bạn nên xác minh thời gian chờ phía máy khách và giảm kích thước lô yêu cầu.

Vấn đề về công suất đối với các phương thức insert của sản phẩm và kho hàng

Ngày báo cáo: 28/1/2026 (theo giờ UTC) | Lần cập nhật gần đây nhất: 31/3/2026 (theo giờ UTC)

Chúng tôi nhận được báo cáo về các vấn đề hiệu suất phía máy khách với thông lượng trong khi truyền một lượng lớn dữ liệu đến Merchant API. Bạn có thể gặp phải vấn đề này khi sử dụng thư viện ứng dụng cho các phương thức sau:

Chúng tôi đã cải thiện hiệu suất của nhiều hệ thống phụ trợ. Nếu vẫn gặp phải vấn đề này, bạn có thể cần định cấu hình một nhóm kênh để tối đa hoá thông lượng. Thao tác này bỏ qua giới hạn thông thường là 100 luồng của một kênh gRPC duy nhất bằng cách quản lý nhiều kết nối cơ bản. Để biết thêm thông tin, hãy xem bài viết Tái cấu trúc mã cho các yêu cầu đồng thời: Cải thiện thông lượng bằng nhóm kênh.

Giá trị nhận dạng sản phẩm có ký tự đặc biệt

Ngày báo cáo: 3/10/2025 (theo giờ UTC) | Lần cập nhật gần đây nhất: 8/4/2026 (theo giờ UTC)

Người dùng có thể gặp phải vấn đề khi quản lý các sản phẩm mà productId hoặc offerId không tuân thủ nguyên tắc định dạng mã sản phẩm. Những mã sản phẩm như vậy có thể chứa các ký tự đặc biệt, đáng chú ý nhất là dấu gạch chéo (/), dấu hai chấm (:), dấu ngã (~) và dấu phần trăm (%). Các nền tảng như Merchant Center đã cho phép một số ký tự đặc biệt trong mã sản phẩm.

Vì Merchant API kết hợp mã nhận dạng sản phẩm trực tiếp vào tài nguyên name trong URL (ví dụ: accounts/{account}/products/{productId}), nên các ký tự này có thể gây trở ngại cho việc định tuyến và phân tích cú pháp URL tiêu chuẩn, dẫn đến lỗi 404 Not Found hoặc 400 Bad Request không mong muốn trong các thao tác GET, PATCH hoặc DELETE.

Để tương tác an toàn với các sản phẩm chứa những ký tự này, bạn phải mã hoá đoạn productId hoặc offerId của tên tài nguyên. Thuật toán mã hoá là mã hoá Base64URL không có khoảng đệm. Để biết thêm thông tin, hãy xem accounts.productInputs.name.

Đã giải quyết: Chúng tôi đã triển khai một giải pháp để chuẩn hoá hành vi trên toàn bộ hệ sinh thái Merchant API. Chúng tôi đã thêm một trường mới base64_encoded_name vào các phản hồi API cung cấp tên tài nguyên được mã hoá trước, cho phép bạn sử dụng trực tiếp đầu ra của một danh sách hoặc lệnh gọi get làm đầu vào cho các bản cập nhật tiếp theo mà không cần thực hiện mã hoá thủ công.

Độ trễ sau khi tạo nguồn dữ liệu

Ngày báo cáo: 10/4/2024 (theo giờ UTC) | Lần cập nhật gần đây nhất: 12/5/2024 (theo giờ UTC)

Đã xảy ra một sự chậm trễ đã biết khi bạn cố gắng chèn sản phẩm, chương trình khuyến mãi hoặc bài đánh giá ngay sau khi tạo một DataSource mới. Lỗi Data source not found đã được trả về khi cố gắng chèn các mục trong vòng 5 phút kể từ khi nguồn dữ liệu được tạo.

Đã giải quyết: Tình trạng chậm trễ này đã được loại bỏ, cho phép tương tác ngay lập tức hơn với các nguồn dữ liệu mới tạo.

Bạn có gặp vấn đề nào khác không?

Hãy truy cập vào trang Yêu cầu trợ giúp về Merchant API và trang Gửi ý kiến phản hồi của chúng tôi nếu bạn gặp bất kỳ vấn đề nào khác.