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

يخضع حسابك على Merchant Center واستخدامك لواجهة برمجة التطبيقات Merchant API للحصص والحدود.

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

تفرض واجهة برمجة التطبيقات Merchant API السياسات التالية من حيث التعديلات:

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

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

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

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

يعرض المخطّط البياني التسلسل الهرمي لمجموعات CSS وخدمات مقارنة الأسعار والحسابات والحسابات الفرعية. مجموعة CSS هي مستوى المصادقة الشامل، مع إمكانية توفّر حسابات CSS فردية ضمنها، وحسابات ضمن تلك الحسابات، وحسابات فرعية كأكثر مستوى فردي.

تغييرات الحصة المخصّصة لطلبات الإجراءات من Content API for Shopping

إذا كنت تستخدم Content API for Shopping، يُرجى العِلم بالتغييرات التالية في الحصة المخصّصة لطلبات الإجراءات في Merchant API:

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

التحقّق من الحِصص المخصّصة لطلبات البيانات

للاطّلاع على الحِصص المخصّصة لطلبات البيانات والاستخدام الحالي لحساب، استخدِم طريقة quotas.list مع name الحساب.

لا تنطبق الحصة التلقائية إلا على خدمتَي products وaccounts. إذا كنت بحاجة إلى زيادة الحصة لأي خدمة أخرى، أو إذا كنت قد بلغت حصتك اليومية لخدمتَي products أو accounts، أو إذا كنت بحاجة إلى زيادة مؤقتة لخدمتَي accounts أو products 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

حدود الحسابات

تتيح لك الطريقتان accounts.limits.get و accounts.limits.list التحقّق من الحدود المفروضة على الكيانات على مستوى الحساب. يمكنك استخدام هاتَين الطريقتَين للتحقّق من حدود المنتجات.

لاسترداد حدّ منتج معيّن، على سبيل المثال، للحصول على الحصة المخصّصة لإعلانات المنطقة الاقتصادية الأوروبية لحساب، عليك تحديد رقم تعريف الحساب ورقم تعريف الحدّ في طلبك إلى accounts.limits.get. رقم تعريف الحدّ هو مزيج من نوع الحدّ ونطاقه. على سبيل المثال، products~ADS_EEA للمنتجات التي تستهدف الإعلانات في المنطقة الاقتصادية الأوروبية، وproducts~ADS_NON_EEA للمنتجات التي تستهدف الإعلانات خارج المنطقة الاقتصادية الأوروبية.

إليك مثال على طلب للحصول على الحدّ products~ADS_EEA لحساب معيّن:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

للتعرّف على أرقام تعريف الحدود المتاحة لحسابك، استخدِم accounts.limits.list مع فلتر type="products"

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

لمزيد من المعلومات عن حِصص المنتجات، يُرجى الاطّلاع على التعرّف على الحِصص في Google Merchant Center.

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

تصف الحدود التالية القيود المهمة لقِيم سلاسل معيّنة وحقول مصفوفات ضمن تمثيلات الموارد المستخدَمة في 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[]
السابق
Manage conversion sources
التالي
Track usage metrics