با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
ویژگی های Merchant API دارای سهمیه ها و محدودیت های سختگیرانه هستند.
سیاست به روز رسانی
Merchant API خط‌مشی‌های زیر را از نظر به‌روزرسانی‌ها اعمال می‌کند:
شما فقط می توانید محصولات خود را تا دو بار در روز به روز کنید.
فقط یک بار در روز می توانید حساب های فرعی خود را به روز کنید.
تغییرات مربوط به سهمیه بین Merchant API و Content API for Shopping
سهمیه به ازای هر منبع شمارش خواهد شد، نه برای هر روش. این بدان معناست که برخی از خدمات اکنون پیوند شده اند.
عدم وجود دسته بندی سفارشی بر محاسبه سهمیه تأثیری ندارد. به عنوان مثال، یک درخواست دسته ای حاوی 500 درخواست درج به عنوان 500 درخواست روش درج جداگانه محاسبه می شود.
اتوماسیون سهمیه ای برای حساب ها و محصولات همچنان پابرجاست.
برای تعیین میزان استفاده و محدودیت های فعلی سهمیه خود، از جمله اتوماسیون و لغو، از روش Quota.list استفاده کنید.
سهمیه فراخوانی روش
Merchant API به طور خودکار سهمیه تماس ها را برای products و accounts شما بر اساس میزان استفاده شما تنظیم می کند.
در اینجا نحوه ردیابی میزان استفاده از سهمیه شما آمده است:
سهمیه ها به ازای هر روش است. به عنوان مثال، روش get سهمیه جداگانه ای از روش update دارد.
هر درخواست صرف نظر از نوع آن یک بار به حساب می آید. به عنوان مثال، ما یک list درخواستی از 250 مورد را یک بار حساب می کنیم، نه اینکه 250 مورد درخواست get .
سهمیه بر اساس کاربری که درخواست API را ارائه می دهد، محاسبه می شود. اگر کاربر عضو مستقیم یک حساب پیشرفته باشد، سهمیه در سطح حساب پیشرفته شارژ می شود.
سهمیه‌ها برای گروه، CSS، حساب یا حساب‌های فرعی که هنگام برقراری تماس با آنها احراز هویت می‌کنید اعمال می‌شود. برای مثال، اگر به عنوان یک حساب پیشرفته احراز هویت می کنید، تماس ها در سهمیه حساب پیشرفته شما حساب می شود، اما اگر به عنوان یکی از حساب های فرعی خود احراز هویت می کنید، تماس ها در سهمیه حساب فرعی حساب می شوند.
این نمودار سلسله مراتب گروه های CSS، CSS، حساب ها و حساب های فرعی را نشان می دهد.
سهمیه های خود را بررسی کنید
برای بررسی سهمیه فعلی و استفاده از یک حساب، با quotas.list با name حساب تماس بگیرید.
سهمیه خودکار فقط برای products و خدمات accounts اعمال می شود. اگر برای هر سرویس دیگری نیاز به افزایش سهمیه دارید، سهمیه روزانه خود را برای products یا خدمات accounts دریافت می‌کنید، یا به افزایش موقت برای accounts یا services محصولات نیاز دارید، با اطلاعات زیر با ما تماس بگیرید :
شناسه Merchant Center شما
روش هایی که به محدودیت های سهمیه خود رسیده اید
تخمینی از تعداد تماس‌هایی که در روز برای آن روش‌ها نیاز دارید
دلیل نیاز به افزایش سهمیه
خواه افزایش موقت یا دائمی باشد
توصیه می کنیم سهمیه های خود را به صورت دوره ای بررسی کنید تا مطمئن شوید که سهمیه کافی برای اجرای خود دارید یا اینکه چگونه سهمیه شما به طور خودکار تنظیم می شود.
خطاها
اگر از سهمیه ها فراتر بروید، خطاهای زیر را دریافت می کنید:
در دقیقه: quota/request_rate_too_high
در روز: quota/daily_limit_exceeded
برای مشاهده سهمیه‌ها و میزان استفاده و درخواست افزایش سهمیه در روز یا هر دقیقه، به بررسی سهمیه‌های خود مراجعه کنید.
too_many_subaccounts: Maximum number of sub-accounts reached
محدودیت های نمایندگی منابع
محدودیت‌های زیر محدودیت‌های قابل توجهی را برای مقادیر رشته‌ای خاص و فیلدهای آرایه در بازنمایی منابع مورد استفاده در Merchant API توصیف می‌کنند. این محدودیت‌ها برای Merchant API و ویژگی مربوط به آن در Merchant Center یکسان است.
توجه داشته باشید که این لیست محدودیت ها ممکن است کامل نباشد. ما این محدودیت ها را تمدید نخواهیم کرد.
تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی."],[[["\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[]`"]]
