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.
Các tính năng của Merchant API có hạn mức và giới hạn nghiêm ngặt.
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.
Những thay đổi liên quan đến hạn mức giữa Merchant API và Content API for Shopping
Hạn mức sẽ được tính theo tài nguyên, chứ không phải theo phương thức. Điều này có nghĩa là một số dịch vụ hiện đã được liên kết.
Việc không có tính năng tạo lô 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ẽ được tính phí là 500 yêu cầu phương thức chèn riêng lẻ.
Tính năng tự động hoá hạn mức cho tài khoản và sản phẩm vẫn được áp dụng.
Để xác định mức sử dụng và hạn mức hạn mức hiện tại, bao gồm cả chế độ tự động và ghi đè, hãy sử dụng phương thức Quota.list.
Hạn mức lệnh gọi phương thức
Merchant API tự động điều chỉnh hạn mức lệnh 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 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.
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ục một lần, chứ không phải là 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 tài khoản nâng cao, thì các lệnh gọi sẽ 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ẽ 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ụ.
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 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 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 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 hạn mức
Số lượng lệnh gọi ước tính mỗi ngày mà bạn cần cho các phương thức đó
Lý do bạn cần tăng hạn mức
Liệu mức tăng này là tạm thời hay vĩnh viễ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 hoặc cách hệ thống tự động điều chỉnh hạn mức.
Lỗi
Nếu vượt quá hạn mức, 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 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 trong nội dung trình bày tài nguyên được sử 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.
[[["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-08-08 UTC."],[[["\u003cp\u003eMerchant API utilizes automatic quota adjustments for \u003ccode\u003eproducts\u003c/code\u003e and \u003ccode\u003eaccounts\u003c/code\u003e services based on usage, tracking requests per-method and applying quotas to specific CSS groups or accounts.\u003c/p\u003e\n"],["\u003cp\u003eUpdates are limited to twice per day for products and once per day for sub-accounts.\u003c/p\u003e\n"],["\u003cp\u003eYou can request quota increases for services other than \u003ccode\u003eproducts\u003c/code\u003e and \u003ccode\u003eaccounts\u003c/code\u003e, exceeding daily quotas, or requiring temporary increases by contacting Google Merchant Center support.\u003c/p\u003e\n"],["\u003cp\u003eExceeding quotas results in specific errors, such as \u003ccode\u003equota/request_rate_too_high\u003c/code\u003e (per minute) and \u003ccode\u003equota/daily_limit_exceeded\u003c/code\u003e (per day), with instructions for checking and requesting increases.\u003c/p\u003e\n"],["\u003cp\u003eResource representations have inherent limits, notably affecting \u003ccode\u003eshippingsettings\u003c/code\u003e with restrictions on shipping services, groups, labels, and table dimensions.\u003c/p\u003e\n"]]],[],null,["# Quotas and limits\n\nMerchant API features carry strict quotas and limits.\n| **Note:** Quotas and limits are subject to elimination, reduction, or change at any time, without notice.\n\nUpdate policy\n-------------\n\nMerchant API enforces the following policies in terms of updates:\n\n- You can only update your products up to twice per day.\n- You can only update your sub-accounts once per day.\n\nQuota-related changes between Merchant API and Content API for Shopping\n-----------------------------------------------------------------------\n\n- Quota will be counted per resource, not per method. This means some services are now linked.\n- The absence of custom batching doesn't affect quota calculation. For example, a batch request containing 500 insert requests will be charged as 500 individual insert method requests.\n- Quota automation for accounts and products remains in place.\n- To determine your current quota usage and limits, including automation and overrides, use the [Quota.list method](/merchant/api/reference/rest/quota_v1/accounts.quotas/list).\n\n| **Note:** For the `accounts.list` method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. To list several sub-accounts, you should use the `accounts.listSubaccounts` method, which is more suitable for advanced accounts use case.\n\nMethod call quotas\n------------------\n\nMerchant API automatically adjusts call quotas for your\n[`products`](/merchant/api/guides/products/overview) and\n[`accounts`](/merchant/api/guides/accounts/overview) based on your usage.\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- Each request counts once, regardless of its type. For example, we count a `list` request of 250 items once, not as 250 `get` requests.\n- Quota is charged based on the user who makes the API request. If the user is a direct member of an advanced account, the quota will be charged at the level of the advanced account.\n- Quotas apply to the Comparison Shopping Services (CSS) group, CSS, account, or [sub-accounts](/merchant/api/guides/accounts/sub-accounts) against which you authenticate when you make the call. For example, if you authenticate as an [advanced account](https://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\u003cbr /\u003e\n\nThe diagram shows the hierarchy of CSS groups, CSS, accounts, and sub-accounts.\n\n### Check your quotas\n\nTo check the current quota and usage for an account, call\n[`quotas.list`](/merchant/api/reference/rest/quota_v1/accounts.quotas/list)\nwith the `name` of the account.\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`, [contact\nus](/merchant/api/support/get-help) with the following information:\n\n- Your Merchant Center ID\n- The methods you've reached your quota limits on\n- An estimate of the number of calls per day you need for those methods\n- The reason you need a quota increase\n- Whether it's a temporary or permanent increase\n\nWe recommend checking your quotas periodically to ensure you have sufficient\nquota for your implementation, or how your quota is adjusted automatically.\n\n### Errors\n\nIf you exceed the quotas, you receive the following errors:\n\n- Per minute: `quota/request_rate_too_high`\n- Per day: `quota/daily_limit_exceeded`\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 Merchant API. These\nlimits are the same for both the Merchant API and their corresponding feature in\nthe Merchant Center.\n\nNote that this list of limits may not be complete. We won't extend these limits.\n\n| Resource | Field | Limit |\n|------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------|\n| [`shippingsettings`](/merchant/api/reference/rest/accounts_v1/accounts.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[]`"]]
