Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Content API for Shopping áp dụng các hạn mức và hạn mức 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ị xoá, 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
Trung bình, bạn không nên cập nhật sản phẩm nhiều hơn hai lần mỗi ngày và 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 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 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.
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 theo hạn mức của phương thức đó.
Các cuộc 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 cuộc 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ẽ đượ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ụ.
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 kiểm tra định kỳ hạn mức để đảm bảo bạn có đủ hạn mứ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 hạn mức 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 thức mà bạn đã đạt đến hạn mức hạn mức.
Số lượng 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ẽ nhận được 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.
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 các bản trình bày tài nguyên được sử dụng trong Content API. Các giới hạn này giống nhau đối với cả Content API và tính năng tương ứng trong Merchant Center. Danh sách 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.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThe Content API for Shopping has quotas and limits that can change without notice, with product and sub-account updates recommended no more than twice and once per day, respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe API adjusts \u003ccode\u003eproducts\u003c/code\u003e and \u003ccode\u003eaccounts\u003c/code\u003e quotas dynamically, tracking usage per method, including within \u003ccode\u003ecustombatch\u003c/code\u003e and based on the authenticated account.\u003c/p\u003e\n"],["\u003cp\u003eQuota usage can be checked with \u003ccode\u003equotas.list\u003c/code\u003e, and increases for specific services or if daily limits are reached can be requested through Google Merchant Center support.\u003c/p\u003e\n"],["\u003cp\u003eExceeding quotas results in specific errors like \u003ccode\u003equota/request_rate_too_high\u003c/code\u003e or \u003ccode\u003equota/daily_limit_exceeded\u003c/code\u003e, while resource representation limits exist for certain string and array field values.\u003c/p\u003e\n"],["\u003cp\u003eResource representation limits, which cannot be extended, apply to elements like shipping settings, affecting the number of services, groups, labels, and subtables allowed.\u003c/p\u003e\n"]]],["The Content API for Shopping has quotas and limits that can change without notice. It's advised to update products no more than twice daily and sub-accounts once. Quotas are per-method, with `patch` methods impacting both `get` and `update` quotas. The `products` and `accounts` quotas are automatically adjusted, but other services or temporary increases require contacting support. `quotas.list` checks current usage. Errors indicate `request_rate_too_high` (per minute) or `daily_limit_exceeded` (per day). Some resource limits like shipping settings exist.\n"],null,["# Quotas and limits\n\nThe Content API for Shopping imposes strict quotas and limits on some features.\nAll quotas and limits are subject to elimination, reduction, or change at any\ntime, without notice.\n| **Note:** If you need to call `datafeeds.fetchnow` more than once per day, we recommend you use the [`products`](/shopping-content/reference/rest/%0Av2.1/products) service instead to update your product data. We cannot provide a quota increase on `datafeeds.fetchnow`.\n\nQuota policy\n------------\n\nOn average, don't update your products more than twice per day, and\nyour sub-accounts more than once per day.\n\nMethod call quotas\n------------------\n\nThe Content API for Shopping automatically adjusts your\n[`products`](/shopping-content/reference/rest/v2.1/products) and\n[`accounts`](/shopping-content/reference/rest/v2.1/accounts) quotas based on\nyour usage. Your `accounts` usage is based on your sub-accounts limit.\n\nHere's how we track your quota usage:\n\n- Quotas are per-method. For example, the `get` method has a separate quota from the `update` method.\n- `patch` methods count against both your `get` and `update` quotas.\n- Each method call within a `custombatch` counts separately against that method's quota.\n- Calls count against the quota of the account you authenticate as when you make the call. For example, if you authenticate as an [advanced\n account](//support.google.com/merchants/answer/188487), calls count against your advanced account's quota, but if you authenticate as one of your sub-accounts, calls count against the sub-account's quota.\n\n| **Note:** The [`merchantsupport`](/shopping-content/reference/rest/v2.1/merchantsupport) methods always count against the quota for the account whose issues are requested. This might not be the account authenticating the request.\n\n### Check your quotas\n\nTo check the current quota and usage for an account, call\n[`quotas.list`](/shopping-content/reference/rest/v2.1/quotas/list) with the\n`merchantId` of the account.\n\nWe recommend checking your quotas periodically to ensure you have sufficient\nquota for your implementation.\n\nAutomatic quota only applies to the `products` and `accounts` services. If you\nneed an increased quota for any other service, you're hitting your daily quota\nfor the `products` or `accounts` services, or you need a temporary increase for\nthe `accounts` or products `services`,\n[contact us](https://support.google.com/merchants/contact/shopping_api_support_form)\nwith the following information:\n\n- Your Merchant Center ID.\n- Which methods you've reached your quota limits on.\n- An estimation of how many calls per day you need for those methods.\n- The reason you need a quota increase.\n\n### Errors\n\nIf you exceed the Content API for Shopping quotas, you receive the following\nerrors:\n\n- Per minute: `quota/request_rate_too_high`\n- Per day: `quota/daily_limit_exceeded`\n\n| **Note:** Calls that receive `quota/request_rate_too_high`, `quota/daily_limit_exceeded`, or authentication errors don't count towards the daily quota but any other unsuccessful calls are counted towards it.\n\nTo view your quotas and usage, and request a per-day or per-minute quota\nincrease, see [Check your quotas](#check_your_quotas).\n\nThe following errors can't be resolved by automatic quota increases, and require\nyou to [request additional quota of items, feeds or\nsub-accounts](//support.google.com/merchants/contact/additional_items):\n\n- `too_many_items: Merchant quota exceeded`\n- `too_many_subaccounts: Maximum number of sub-accounts reached`\n\nResource representation limits\n------------------------------\n\nThe following limits describe notable restrictions for certain string values and\narray fields within the resource representations used in the Content API. These\nlimits are the same for both the Content API and their corresponding feature in\nthe Merchant Center. This list of limits may not be complete, and these limits\ncannot be extended.\n\n| Resource | Field | Limit |\n|----------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------|\n| [shippingsettings](/shopping-content/reference/rest/v2.1/shippingsettings) | Shipping services per country (`services`). Shipping groups per shipping service (`rateGroups`). Labels per shipping group (`applicableShippingLabels`). Subtables per shipping group (`subtables`). Number of rows or columns in a single [rate table](#note2). Length of shipping labels. | 20 20 30 100 150 100 |\n\nThe number of rows or columns in a rate table affects the following array fields:\n\n- Array fields within `rowHeaders` or `columnHeaders`:\n - `prices[]`\n - `weights[]`\n - `numberOfItems[]`\n - `postalCodeGroupNames[]`\n - `locations[]`\n - `rows[]`\n - `cells[]`"]]
