Hạn mức

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ả hạn mức và giới hạn đều 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 trước.

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

Trung bình, bạn không nên cập nhật sản phẩm nhiều hơn 2 lần mỗi ngày và tài khoản phụ nhiều hơn 1 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 dựa trên hạn mức tài khoản phụ.

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 được tính theo từng phương thức. Ví dụ: phương thức get có hạn mức riêng so 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.
  • Mỗi lệnh gọi phương thức trong custombatch được tính riêng vào hạn mức của phương thức đó.
  • Các 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 là 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. Tuy nhiên, nếu bạn xác thực 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

Để 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 định kỳ kiểm tra hạn mức để đảm bảo có đủ hạn mức cho quá trình 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 các accounts hoặc sản phẩm services, hãy liên hệ với chúng tôi và cung cấp các thông tin sau:

  • ID truy cập vào Merchant Center của bạn.
  • Các phương thức mà bạn đã đạt đến hạn mức.
  • Số lượng lệnh gọi ước tính mà bạn cần mỗi ngày cho các 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 của Content API for Shopping, 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 mỗi 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 hạn mức tự động và cần 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 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 trong nội dung trình bày tài nguyên được sử dụng trong Content API. Các giới hạn này đều giống 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à bạn không thể mở rộng 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 cho mỗi quốc gia (services).

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

Nhãn cho mỗi nhóm phí vận chuyển (applicableShippingLabels).

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

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

Độ dài của nhãn vận chuyển.

20

20

30

100

150

100

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