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

يخضع حسابك على Merchant واستخدامك لواجهة 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[]