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

تفرض 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[]