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

Content API for Shopping áp đặt các hạn mức và giới hạn nghiêm ngặt đối với một số tính năng. Mọi hạn mức và giới hạn có thể bị loại bỏ, giảm hoặc thay đổi bất cứ lúc nào mà không cần thông báo.

Chính sách về hạn mức

Đừng cập nhật sản phẩm nhiều hơn 2 lần mỗi ngày và cũng đừng cập nhật tài khoản phụ nhiều hơn một lần mỗi ngày.

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

Content API for Shopping tự động điều chỉnh hạn mức products và accounts dựa trên mức sử dụng của bạn. Mức sử dụng accounts của bạn dựa trên hạn mức tài khoản phụ.

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

  • Hạn mức là cho mỗi phương thức. Ví dụ: phương thức get có một hạn mức riêng với phương thức update.
  • Các phương thức patch được tính vào cả hạn mức get và update của bạn.
  • Mỗi lệnh gọi phương thức trong custombatch đều được tính riêng vào hạn mức của phương thức đó.
  • Số lệnh gọi được tính vào hạn mức của tài khoản 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, các lệnh gọi sẽ được tính vào hạn mức của tài khoản nâng cao, nhưng nếu bạn xác thực với tư cách là một trong các tài khoản phụ, thì các lệnh gọi sẽ được tính vào hạn mức của tài khoản phụ.

Kiểm tra hạn mức của bạn

Để 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 merchantId của tài khoản.

Bạn nên kiểm tra hạn mức của mình theo định kỳ để đảm bảo có đủ hạn mức cho việc triển khai.

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 sẽ đạt đến hạn mức hằng ngày cho các dịch vụ products hoặc accounts, hoặc cần tăng hạn mức 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 những thông tin sau:

  • ID truy cập vào Merchant Center của bạn.
  • Những phương pháp mà bạn đã đạt đến giới hạ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 cho những phương thức đó.
  • Lý do bạn cần tăng hạn mức.

Lỗi

Nếu vượt quá hạn mức Content API for Shopping, bạn sẽ gặp 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ủa bạn cũng như yêu cầu tăng hạn mức mỗi ngày hoặc mỗi phút, hãy xem phần Kiểm tra hạn mức của 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à đòi hỏi bạn phải yêu cầu bổ sung hạn mức cho các 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 biểu diễn tài nguyên

Các giới hạn sau đây mô tả các hạn chế đáng chú ý đối với một số giá trị chuỗi và trường mảng trong cách biểu diễn tài nguyên dùng trong Content API. Các giới hạn này là như nhau cho cả Content API và tính năng tương ứng trong Merchant Center. Danh sách các giới hạn này có thể chưa đầy đủ và các giới hạn này không được kéo dài thêm.

Tài nguyên Kỹ thuật Hạn mức
shippingsettings

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

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

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

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

Số lượng hàng hoặc cột trong một bảng mức phí.

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

20

20

30

100

150

100

Số lượng hàng hoặc cột trong bảng mức phí ả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[]