Hạn mức

Tài khoản người bán và việc bạn sử dụng Merchant API phải tuân theo hạn mức và giới hạn.

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 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 được tính theo từng phương thức. Ví dụ: phương thức get có một hạn mức riêng so 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ặt hàng một lần, chứ không phải 250 yêu cầu get.
  • Hạn mức được tính dựa trên người dùng đưa ra yêu cầu API. Nếu người dùng là thành viên trực tiếp của một tài khoản nâng cao, thì hạn mức sẽ được tính ở cấp tài khoản nâng cao.
  • 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 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. 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ẽ được 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ụ. Nhóm CSS là cấp xác thực bao quát, có thể có CSS riêng lẻ trong đó, tài khoản trong các tài khoản đó và tài khoản phụ là cấp riêng lẻ nhất.

Thay đổi về hạn mức gọi phương thức của Content API for Shopping

Nếu bạn sử dụng Content API for Shopping, hãy lưu ý những thay đổi sau đây về hạn mức gọi phương thức trong Merchant API:

  • Việc không có tính năng xử lý hàng loạt tuỳ chỉnh không ảnh hưởng đến việc tính hạn mức. Ví dụ: một yêu cầu hàng loạt chứa 500 yêu cầu chèn sẽ bị tính phí là 500 yêu cầu riêng lẻ cho phương thức chèn.
  • Hạn mức tự động cho tài khoản và sản phẩm vẫn được áp dụng.
  • Để xác định hạn mức sử dụng và giới hạn hiện tại của bạn, bao gồm cả tự động hoá và ghi đè, hãy sử dụng phương thức Quota.list.

Kiểm tra hạn mức cuộc gọi

Để kiểm tra hạn mức và mức sử dụng lệnh gọi hiện tại cho 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 dịch vụ products hoặc accounts, hoặc bạn cần tăng hạn mức tạm thời cho dịch vụ accounts hoặc cá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
  • Số lượng ước tính các 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
  • Đây là mức tăng tạm thời hay vĩnh viễn

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

Lỗi

Nếu vượt quá hạn mức, 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ủ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 gọi.

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à bạn cần phải yêu cầu hạn mức bổ sung 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

Hạn mức tài khoản

Các phương thức accounts.limits.get và accounts.limits.list cho phép bạn kiểm tra giới hạn đối với các thực thể ở cấp tài khoản. Bạn có thể sử dụng các phương thức này để kiểm tra giới hạn về sản phẩm.

Để truy xuất một hạn mức sản phẩm cụ thể, chẳng hạn như để nhận hạn mức EEA của quảng cáo trong một tài khoản, bạn cần chỉ định mã tài khoản và mã hạn mức trong lệnh gọi đến accounts.limits.get. Mã nhận dạng hạn mức là sự kết hợp giữa loại hạn mức và phạm vi. Ví dụ: products~ADS_EEA cho các sản phẩm nhắm đến quảng cáo ở EEA và products~ADS_NON_EEA cho các sản phẩm nhắm đến quảng cáo bên ngoài EEA.

Sau đây là ví dụ về yêu cầu lấy giới hạn products~ADS_EEA cho một tài khoản nhất định:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

Để tìm hiểu về các mã nhận dạng giới hạn có sẵn cho tài khoản của bạn, hãy sử dụng accounts.limits.list với bộ lọc cho type="products":

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

Để biết thêm thông tin về hạn mức sản phẩm, hãy xem bài viết Tìm hiểu về hạn mức trong Google Merchant Center.

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 dùng trong Merchant API. Các giới hạn này đều 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 các 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 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[]