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

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

سياسة التحديث

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

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

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

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

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

• تكون الحصص لكل طريقة. على سبيل المثال، تتوفّر حصة منفصلة للطريقة get عن الطريقة update.
• يتم احتساب كل طلب مرة واحدة، بغض النظر عن نوعه. على سبيل المثال، نحتسب طلبًا واحدًا list يتضمّن 250 عنصرًا، وليس 250 طلبًا get.
• يتم تحصيل الرسوم مقابل الحصة استنادًا إلى المستخدم الذي يرسل طلب واجهة برمجة التطبيقات. إذا كان المستخدم عضوًا مباشرًا في حساب متقدّم، سيتم تحصيل الرسوم من الحصة على مستوى الحساب المتقدّم.
• تنطبق الحصص على مجموعة "خدمات مقارنة الأسعار" (CSS) أو 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 أو منتجات 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 التحقّق من الحدود المفروضة على الكيانات على مستوى الحساب. يمكنك استخدام هذه الطرق للتحقّق من حدود المنتجات.

لاسترداد حدّ معيّن للمنتج، مثلاً للحصول على حصة المنطقة الاقتصادية الأوروبية في "إعلانات Google" لحساب معيّن، عليك تحديد رقم تعريف الحساب ورقم تعريف الحدّ في طلبك إلى 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[]