Trang này ghi lại các vấn đề đã biết mà nhà phát triển gặp phải khi sử dụng Merchant API.
Vấn đề về thông lượng đố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 (giờ UTC) | Lần cập nhật gần đây nhất: 31/3/2026 (giờ 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 tiế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á công suất. Thao tác này sẽ 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
Ngày báo cáo: Ngày 3 tháng 10 năm 2025 (giờ UTC) | Lần cập nhật gần đây nhất: Ngày 8 tháng 4 năm 2026 (giờ UTC)
Người dùng có thể gặp vấn đề khi quản lý những sản phẩm có productId hoặc offerId không tuân thủ nguyên tắc định dạng mã sản phẩm.
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 trực tiếp mã nhận dạng sản phẩm vào tài nguyên name dưới dạng một phần của URL (ví dụ: accounts/{account}/products/{productId}), nên các ký tự này có thể ảnh hưởng đến việc định tuyến và phân tích cú pháp URL chuẩn, dẫn đến lỗi 404 Not Found hoặc 400 Bad Request ngoài dự kiế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á 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ó 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 hệ sinh thái Merchant API. Chúng tôi đã thêm một trường mới base64_encoded_name vào phản hồi của API để cung cấp tên tài nguyên được mã hoá trước, cho phép bạn sử dụng kết quả của lệnh gọi danh sách hoặc lệnh gọi lấy trực tiếp làm dữ liệu đầ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 (giờ UTC) | Ngày cập nhật gần đây nhất: 12/5/2024 (giờ 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ục 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 bạn tương tác ngay lập tức với các nguồn dữ liệu mới tạo.
Bạn còn 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à Gửi ý kiến phản hồi nếu bạn gặp vấn đề khác.