Trang này ghi lại các mối lo ngại đã biết của nhà phát triển đối với Merchant API.
Lỗi ngẫu nhiên UnauthenticatedException
Đã báo cáo: 30/3/2026 UTC | Cập nhật gần đây nhất: 17/4/2026 UTC
Nhiều khách hàng đang gặp phải lỗi UnauthenticatedException không liên tục khi tải sản phẩm lên và truy cập vào các Merchant Center API khác.
Lỗi xảy ra ngẫu nhiên, ngay cả khi 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.
Chúng tôi đã triển khai biện pháp giảm thiểu và đang tiếp tục điều tra để tìm ra giải pháp lâu dài. Nếu bạn gặp phải lỗi này, bạn nên thử lại các lệnh gọi API.
Độ trễ cao, thông báo DEADLINE_EXCEEDED và INTERNAL_ERROR cho các phương thức sản phẩm và kho hàng
Đã báo cáo: 18/3/2026 UTC | Cập nhật gần đây nhất: 13/5/2026 UTC
Một số người dùng gặp phải tình trạng độ trễ kéo dài và thông báo DEADLINE_EXCEEDED hoặc INTERNAL_ERROR thường xuyên 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ý. Chúng tôi vẫn đang nỗ lực giải quyết vấn đề này.
Nếu bạn tiếp tục gặp phải tình trạng độ trễ cao, bạn nên giảm kích thước lô yêu cầu. Nếu bạn nhận được các thông báo lỗi nêu trên, bạn có thể thử tăng thời gian chờ ở phía máy khách.
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
Đã báo cáo: 28/1/2026 UTC | Cập nhật gần đây nhất: 31/3/2026 UTC
Chúng tôi nhận được báo cáo về các vấn đề về hiệu suất ở phía máy khách liên quan đến thông lượng 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:
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
Chúng tôi đã cải thiện để tăng 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. Việc này bỏ qua giới hạn 100 luồng thông thường của một kênh gRPC 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 công suất bằng nhóm kênh.
Mã nhận dạng sản phẩm có ký tự đặc biệt
Đã báo cáo: 3/10/2025 UTC | Cập nhật gần đây nhất: 8/4/2026 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ã nhận dạng sản phẩm.
Các mã nhận dạng 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ã nhận dạng sản phẩm.
Vì Merchant API kết hợp trực tiếp mã nhận dạng sản phẩm vào name tài nguyên như một phần của 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 các 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 các ký tự này, bạn phải mã hoá phân đ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ó phần đệ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. Nhờ đó, bạn có thể sử dụng trực tiếp đầu ra của lệnh gọi danh sách hoặc lệnh gọi nhận 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
Đã báo cáo: 10/4/2024 UTC | Cập nhật gần đây nhất: 12/5/2024 UTC
Đã xảy ra độ trễ đã biết khi 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 DataSource mới. Lỗi Data source not found được trả về khi cố gắng chèn các mặt hàng trong vòng 5 phút kể từ khi nguồn dữ liệu được tạo.
Đã giải quyết: Chúng tôi đã loại bỏ độ trễ này, 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 phải vấn đề nào khác không?
Hãy chuyển đến trang Nhận trợ giúp về Merchant API và Gửi ý kiến phản hồi của chúng tôi nếu bạn gặp phải vấn đề nào khác.