تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تفرض Content API for Shopping حصصًا وحدودًا صارمة على بعض الميزات.
تخضع جميع الحصص والحدود للإزالة أو الخفض أو التغيير في أي
وقت وبدون إشعار.
سياسة الحصة
في المتوسّط، لا تعدِّل منتجاتك أكثر من مرّتين في اليوم، ولا تعدِّل حساباتك الفرعية أكثر من مرّة في اليوم.
حصص طلب الإجراءات
تعدّل Content API for Shopping تلقائيًا حصص
products و
accounts استنادًا إلى
استخدامك. يستند استخدامك لخدمة accounts إلى الحد الأقصى المسموح به للحسابات الفرعية.
في ما يلي كيفية تتبُّع استخدامك للمساحة المتوفّرة:
يتم تحديد الحصص لكل طريقة. على سبيل المثال، تتضمّن طريقة get حصة منفصلة
عن طريقة update.
يتم احتساب patch طريقة ضمن حصتَي get وupdate.
يتم احتساب كلّ طلب أسلوب ضمن custombatch بشكل منفصل وفقًا لحصة
هذا الأسلوب.
يتم احتساب المكالمات ضمن الحصة المحدّدة للحساب الذي تُجري المصادقة عليه عند
إجراء المكالمة. على سبيل المثال، إذا سجّلت الدخول باستخدام حساب
متقدّم، يتم احتساب المكالمات ضمن حصة
حسابك المتقدّم، ولكن إذا سجّلت الدخول باستخدام أحد
حساباتك الفرعية، يتم احتساب المكالمات ضمن حصة الحساب الفرعي.
التحقّق من الحصص
للتحقّق من الحصة الحالية ومعدل الاستخدام لحساب معيّن، يُرجى الاتصال برقم quotas.list باستخدام الرقم المرجعي merchantId للحساب.
ننصحك بالتحقّق من حصصك بشكل دوري للتأكّد من توفّر حصة كافية لتنفيذ عملية الربط.
لا تنطبق الحصة التلقائية إلا على خدمتَي products وaccounts. إذا كنت تحتاج إلى
زيادة في الحصة لأي خدمة أخرى، أو إذا كنت تبلغ الحصة اليومية
لخدمات products أو accounts، أو إذا كنت بحاجة إلى زيادة مؤقتة للخدمة
accounts أو المنتجات services،
يُرجى التواصل معنا
مع تضمين المعلومات التالية:
معرّف مركز التجّار
الطرق التي بلغت فيها حدود الحصة
تقدير لعدد المكالمات التي تحتاجها يوميًا باستخدام هذه الطرق
سبب حاجتك إلى زيادة الحصة
الأخطاء
إذا تجاوزت حصص Content API for Shopping، ستظهر لك رسائل الخطأ التالية:
لكل دقيقة: quota/request_rate_too_high
في اليوم: quota/daily_limit_exceeded
للاطّلاع على حصصك واستخدامك وطلب زيادة حصة في اليوم أو في الدقيقة، يُرجى الاطّلاع على الاطّلاع على حصصك.
too_many_subaccounts: Maximum number of sub-accounts reached
حدود تمثيل الموارد
توضِّح الحدود التالية قيودًا ملحوظة على قيم سلاسل معيّنة وحقول ملفّات برمجية برمجية ضمن تمثيلات الموارد المستخدَمة في Content API. هذهحدود
متماثلة لكلّ من Content API والميزة المقابلة لها في
Merchant Center. قد لا تكون قائمة الحدود هذه كاملة، ولا يمكن تمديد هذه الحدود.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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[]`"]]
