الحصص والحدود

تفرض 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_items: Merchant quota exceeded
  • too_many_subaccounts: Maximum number of sub-accounts reached

حدود تمثيل الموارد

تصف الحدود التالية القيود المهمة لقِيم سلاسل معيّنة وحقول مصفوفات ضمن تمثيلات الموارد المستخدَمة في Content API. هذه الحدود هي نفسها لكلّ من Content API والميزة المقابلة لها في Merchant Center. لا يمكن تمديد هذه الحدود، وهذه القائمة قد لا تكون كاملة.

المورد الحقل الحدّ
shippingsettings

خدمات الشحن لكل بلد (services)

مجموعات الشحن لكل خدمة شحن (rateGroups)

تصنيفات لكل مجموعة شحن (applicableShippingLabels)

الجداول الفرعية لكل مجموعة شحن (subtables)

عدد الصفوف أو الأعمدة في جدول أسعار واحد

طول تصنيفات الحزم

20

20

30

100

150

100

يؤثّر عدد الصفوف أو الأعمدة في جدول الأسعار في حقول المصفوفات التالية:

  • حقول المصفوفات ضمن rowHeaders أو columnHeaders:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]