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

تفرض ميزات Merchant API حصصًا وحدودًا صارمة.

تعديل السياسة

تفرض Merchant API السياسات التالية في ما يتعلّق بالتعديلات:

  • يمكنك تعديل منتجاتك مرتين بحد أقصى في اليوم.
  • يمكنك تعديل حساباتك الفرعية مرة واحدة فقط في اليوم.

حصص طلب الإجراءات

تعدّل Merchant API حصص طلبات البيانات تلقائيًا لحسابك على products و accounts استنادًا إلى معدّل الاستخدام.

في ما يلي كيفية تتبُّع استخدامك للمساحة المتوفّرة:

  • يتم تحديد الحصص لكل طريقة. على سبيل المثال، تمتلك طريقة get حصة منفصلة عن طريقة update.
  • ويتم احتساب كل طلب مرة واحدة، بغض النظر عن نوعه. على سبيل المثال، يتم احتساب طلب list يتضمّن 250 عنصرًا مرّة واحدة، وليس كـ 250 طلب get.
  • تنطبق الحصص على مجموعة "خدمات مقارنة الأسعار" أو "خدمة مقارنة الأسعار" أو الحساب أو الحسابات الفرعية التي تتم مصادقة تسجيل الدخول إليها عند إجراء المكالمة. على سبيل المثال، إذا سجّلت الدخول باستخدام حساب متقدم، يتم احتساب المكالمات ضمن حصة الحساب المتقدّم، ولكن إذا سجّلت الدخول باستخدام أحد حساباتك الفرعية، يتم احتساب المكالمات ضمن حصة الحساب الفرعي.

يعرض المخطّط البياني التدرّج الهرمي لمجموعات CSS وخدمات 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_items: Merchant quota exceeded
  • too_many_subaccounts: Maximum number of sub-accounts reached

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

توضِّح الحدود التالية قيودًا ملحوظة على قيم سلاسل معيّنة وحقول ملفّات برمجية ضمن تمثيلات الموارد المستخدَمة في Merchant API. هذهحدود متماثلة لكلٍّ من Merchant API والميزة المقابلة لها في Merchant Center.

يُرجى العِلم أنّ قائمة الحدود هذه قد لا تكون شاملة. ولن نمدّد هذه الحدود.

المورد الحقل الحدّ المسموح به
shippingsettings

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

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

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

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

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

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

20

20

30

100

150

100

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

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