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

Content API for Shopping áp dụng 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. Tất cả các hạn mức và giới hạn sẽ 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à không cập nhật các 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 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 cho cá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 được tính cho mỗi 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.
  • 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 một custombatch sẽ được tính riêng vào hạn mức của phương thức đó.
  • Các lệnh gọi sẽ đượ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 một tài khoản nâng cao, thì 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 định kỳ hạn mức của mình để đảm bảo bạn 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 đ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 các sản phẩm services, hãy liên hệ với chúng tôi và cung cấp những thông tin sau:

  • ID truy cập vào Merchant Center của bạn.
  • Những phương thức bạn đã dùng hết hạn mức.
  • Thông tin ước tính về số lượng cuộc gọi mỗi ngày 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 phải 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 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.

Các lỗi sau đây không thể khắc phục bằng cách tự động tăng hạn mức, và 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 thể hiện tài nguyên

Các giới hạn sau đây mô tả những 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 đối với 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à không thể mở rộng.

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

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

Số 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ố hàng hoặc cột trong một bảng giá.

Độ 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 đây:

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