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

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

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

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

• يمكنك تعديل منتجاتك مرّتين فقط في اليوم. يجب توزيع الطلبات اليومية بالتساوي على مدار اليوم للالتزام بالحصة المخصّصة لكل دقيقة.
• يمكنك تعديل حساباتك الفرعية مرّتين فقط في اليوم.
• يمكنك استدعاء طُرق مصدر البيانات لحساباتك الفرعية، مثل list أو create، مرّتين فقط لكل حساب فرعي في اليوم.

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

تعدّل واجهة برمجة التطبيقات Merchant API تلقائيًا حِصص الطلبات لما يلي:

• products و accounts استنادًا إلى استخدامك
• datasources للحسابات المتقدّمة استنادًا إلى عدد حساباتها الفرعية

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

• الحِصص مخصّصة لكل طريقة. على سبيل المثال، تتضمّن طريقة get حصة منفصلة عن طريقة update.
• يتم احتساب كل طلب مرة واحدة، بغض النظر عن نوعه. على سبيل المثال، نحتسب طلب list يتضمّن 250 سلعة مرة واحدة، وليس كـ 250 طلب get.
• يتم تحصيل الحصة استنادًا إلى المستخدم الذي يقدّم طلب بيانات من واجهة برمجة التطبيقات. إذا كان المستخدم عضوًا مباشرًا في حساب بامتيازات متقدّمة، سيتم تحصيل الحصة على مستوى الحساب بامتيازات متقدّمة.
• بالنسبة إلى خدمة datasources، لا ينطبق توسيع الحصة التلقائي إلا على الحسابات المتقدّمة استنادًا إلى عدد حساباتها الفرعية. تكون الحِصص للحسابات المستقلة والحسابات الفرعية ثابتة، ولا يتم بشكل عام السماح بزيادتها. للاطّلاع على الحدود القصوى لحصة datasource، استخدِم accounts.limits طُرق.
• تنطبق الحِصص على مجموعة "خدمات مقارنة الأسعار" (CSS) أو CSS أو الحساب أو الحسابات الفرعية التي يتم إثبات هويتك عليها عند إجراء الطلب. على سبيل المثال، إذا أثبتت هويتك كحساب بامتيازات متقدّمة، يتم احتساب الطلبات ضمن حصة حسابك بامتيازات متقدّمة، ولكن إذا أثبتت هويتك كأحد حساباتك الفرعية، يتم احتساب الطلبات ضمن حصة الحساب الفرعي.

يعرض الرسم البياني التسلسل الهرمي لمجموعات CSS وCSS والحسابات والحسابات الفرعية.

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

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

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

الاطّلاع على حِصص طلباتك

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

تنطبق الحصة التلقائية على خدمات products وaccounts وdatasources.

• بالنسبة إلى الموارد التي تتضمّن حِصصًا تلقائية (products وaccounts وdatasources للحسابات المتقدّمة): يمكنك طلب زيادة مؤقتة فقط في سيناريوهات خاصة، مثل الإطلاق في سوق جديد أو خلال مواسم التسوّق التي تشهد زيادة في عدد الزيارات. لا نقبل طلبات زيادة الحصة بشكل دائم لهذا النوع من الموارد.
• بالنسبة إلى جميع الموارد الأخرى التي لا تتضمّن حِصصًا تلقائية: يمكنك طلب زيادة الحصة حسب الحاجة.

استخدِم مشكلة Quota increase request من نموذج التواصل مع فريق الدعم واملأها بالمعلومات التالية:

• معرّف 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.

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

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

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