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

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

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

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

  • يمكنك تعديل منتجاتك مرتين بحد أقصى في اليوم.
  • يمكنك تعديل حساباتك الفرعية مرة واحدة فقط في اليوم.
  • سيتم احتساب الحصة لكل مورد، وليس لكل طريقة. وهذا يعني أنّه تم ربط بعض الخدمات.
  • لا يؤثّر عدم توفّر ميزة "تجميع مخصّص" في احتساب الحصة. على سبيل المثال، سيتم تحصيل رسوم منك مقابل 500 طلب إدراج فردي إذا كان الطلب المجمّع يحتوي على 500 طلب إدراج.
  • ستظلّ ميزة إعداد الحصص تلقائيًا للحسابات والمنتجات سارية.
  • لتحديد استخدام الحصة الحالية وحدودها، بما في ذلك عمليات التشغيل الآلي والاستثناءات، استخدِم طريقة Quota.list.

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

تعدّل 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[]