Hạn mức và giới hạn

Các tính năng của Merchant API có hạn mức và giới hạn nghiêm ngặt.

Cập nhật chính sách

Merchant API thực thi các chính sách sau đây về nội dung cập nhật:

  • Bạn chỉ có thể cập nhật sản phẩm tối đa 2 lần mỗi ngày.
  • Bạn chỉ có thể cập nhật tài khoản phụ một lần mỗi ngày.

Hạn mức lệnh gọi phương thức

Merchant API tự động điều chỉnh hạn mức lệnh gọi cho products và accounts dựa trên mức sử dụng của bạn.

Sau đây là cách chúng tôi theo dõi mức sử dụng hạn mức của bạn:

  • Hạn mức là theo phương thức. Ví dụ: phương thức get có hạn mức riêng biệt với phương thức update.
  • Mỗi yêu cầu được tính một lần, bất kể loại yêu cầu. Ví dụ: chúng tôi tính một yêu cầu list gồm 250 mục một lần, chứ không phải là 250 yêu cầu get.
  • Hạn mức áp dụng cho nhóm Dịch vụ so sánh giá (CSS), CSS, tài khoản hoặc tài khoản phụ mà bạn xác thực khi thực hiện lệnh gọi. Ví dụ: nếu bạn xác thực dưới dạng tài khoản nâng cao, thì các lệnh gọi sẽ tính vào hạn mức của tài khoản nâng cao. Tuy nhiên, nếu bạn xác thực dưới dạng một trong các tài khoản phụ, thì các lệnh gọi sẽ tính vào hạn mức của tài khoản phụ.

Sơ đồ này cho thấy hệ thống phân cấp của các nhóm CSS, CSS, tài khoản và tài khoản phụ. Hình ảnh cho thấy nhóm CSS là cấp xác thực tổng quát, với khả năng có CSS riêng lẻ trong đó, các tài khoản trong những CSS đó và tài khoản phụ là cấp cá nhân nhất.

Kiểm tra hạn mức

Để kiểm tra hạn mức và mức sử dụng hiện tại của một tài khoản, hãy gọi quotas.list bằng name của tài khoản đó.

Hạn mức tự động chỉ áp dụng cho các dịch vụ products và accounts. Nếu bạn cần tăng hạn mức cho bất kỳ dịch vụ nào khác, bạn đang đạt đến hạn mức hằng ngày cho các dịch vụ products hoặc accounts, hoặc bạn cần tăng tạm thời cho accounts hoặc sản phẩm services, hãy liên hệ với chúng tôi kèm theo thông tin sau:

  • Mã truy cập Merchant Center của bạn
  • Các phương thức mà bạn đã đạt đến hạn mức hạn mức
  • Số lượng lệnh gọi ước tính mỗi ngày mà bạn cần cho các phương thức đó
  • Lý do bạn cần tăng hạn mức
  • Liệu mức tăng này là tạm thời hay vĩnh viễn

Bạn nên kiểm tra định kỳ hạn mức để đảm bảo bạn có đủ hạn mức triển khai hoặc cách hệ thống tự động điều chỉnh hạn mức.

Lỗi

Nếu vượt quá hạn mức, bạn sẽ gặp các lỗi sau:

  • Mỗi phút: quota/request_rate_too_high
  • Mỗi ngày: quota/daily_limit_exceeded

Để xem hạn mức và mức sử dụng, cũng như yêu cầu tăng hạn mức hằng ngày hoặc hằng phút, hãy xem bài viết Kiểm tra hạn mức.

Bạn không thể giải quyết các lỗi sau bằng cách tự động tăng hạn mức và bạn cần phải yêu cầu bổ sung hạn mức cho mặt hàng, nguồn cấp dữ liệu hoặc tài khoản phụ:

  • too_many_items: Merchant quota exceeded
  • too_many_subaccounts: Maximum number of sub-accounts reached

Giới hạn về cách trình bày tài nguyên

Các giới hạn sau đây mô tả các quy định hạn chế đáng chú ý đối với một số giá trị chuỗi và trường mảng nhất định trong nội dung trình bày tài nguyên được sử dụng trong Merchant API. Các giới hạn này giống nhau đối với cả Merchant API và tính năng tương ứng trong Merchant Center.

Xin lưu ý rằng danh sách giới hạn này có thể chưa đầy đủ. Chúng tôi sẽ không gia hạn các giới hạn này.

Tài nguyên Trường Hạn mức
shippingsettings

Dịch vụ vận chuyển theo quốc gia (services).

Nhóm vận chuyển theo dịch vụ vận chuyển (rateGroups).

Số nhãn trên mỗi nhóm vận chuyển (applicableShippingLabels).

Bảng phụ theo nhóm vận chuyển (subtables).

Số lượng hàng hoặc cột trong một bảng giá.

Chiều dài của nhãn vận chuyển.

20

20

30

100

150

100

Số hàng hoặc cột trong bảng giá sẽ ảnh hưởng đến các trường mảng sau:

  • Các trường mảng trong rowHeaders hoặc columnHeaders:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]