تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تفرض ميزات Merchant API حصصًا وحدودًا صارمة.
تعديل السياسة
تفرض Merchant API السياسات التالية في ما يتعلّق بالتعديلات:
يمكنك تعديل منتجاتك مرتين بحد أقصى في اليوم.
يمكنك تعديل حساباتك الفرعية مرة واحدة فقط في اليوم.
التغييرات المتعلّقة بالحصص بين Merchant API وContent API for Shopping
سيتم احتساب الحصة لكل مورد، وليس لكل طريقة. وهذا يعني أنّه تم ربط بعض الخدمات.
لا يؤثّر عدم توفّر ميزة "تجميع مخصّص" في احتساب الحصة. على سبيل المثال،
سيتم تحصيل رسوم منك مقابل 500
طلب إدراج فردي إذا كان الطلب المجمّع يحتوي على 500 طلب إدراج.
لتحديد استخدام الحصة الحالية وحدودها، بما في ذلك عمليات التشغيل الآلي
والاستثناءات، استخدِم طريقة Quota.list.
حصص طلبات الإجراءات
تعدّل Merchant API حصص طلبات البيانات تلقائيًا لحسابك على
products و
accounts استنادًا إلى معدّل الاستخدام.
في ما يلي كيفية تتبُّع استخدامك للمساحة المتوفّرة:
يتم تحديد الحصص لكل طريقة. على سبيل المثال، تتضمّن طريقة get حصة منفصلة
عن طريقة update.
ويتم احتساب كل طلب مرة واحدة، بغض النظر عن نوعه. على سبيل المثال، يتم احتساب طلب
list يتضمّن 250 عنصرًا مرّة واحدة، وليس كـ 250 طلبًا من get.
يتم تحصيل الرسوم من الحصة استنادًا إلى المستخدم الذي يقدّم طلب واجهة برمجة التطبيقات. إذا كان المستخدم عضوًا مباشرًا في حساب متقدّم، سيتم تحصيل الحصة على مستوى الحساب المتقدّم.
تنطبق الحصص على مجموعة "خدمات مقارنة الأسعار" أو "خدمة مقارنة الأسعار" أو الحساب
أو الحسابات الفرعية التي تتم مصادقة تسجيل الدخول إليها عند إجراء المكالمة. على سبيل المثال، إذا سجّلت الدخول باستخدام بيانات اعتماد حساب متقدم، يتم احتساب المكالمات ضمن حصة الحساب المتقدّم، ولكن إذا سجّلت الدخول باستخدام بيانات اعتماد أحد حساباتك الفرعية، يتم احتساب المكالمات ضمن حصة الحساب الفرعي.
للتحقّق من الحصة الحالية ومعدل الاستخدام لحساب معيّن، يُرجى الاتصال برقم 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[]`"]]
