سهمیه ها و محدودیت ها

حساب کاربری فروشنده و استفاده شما از API فروشنده مشمول سهمیه‌ها و محدودیت‌هایی است.

سیاست به‌روزرسانی

رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) سیاست‌های زیر را در رابطه با به‌روزرسانی‌ها اعمال می‌کند:

• شما فقط می‌توانید محصولات خود را تا دو بار در روز به‌روزرسانی کنید. برای رعایت سهمیه هر دقیقه، باید تماس‌های روزانه را به طور مساوی در طول روز پخش کنید.
• شما فقط می‌توانید حساب‌های فرعی خود را تا دو بار در روز به‌روزرسانی کنید.
• شما فقط می‌توانید متدهای منبع داده را برای زیرحساب‌های خود مانند list یا create تا دو بار در روز برای هر زیرحساب فراخوانی کنید.

سهمیه‌بندی فراخوانی متد

رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) به طور خودکار سهمیه تماس‌ها را برای موارد زیر تنظیم می‌کند:

• products و accounts بر اساس میزان استفاده شما.
• datasources برای حساب‌های پیشرفته بر اساس تعداد حساب‌های فرعی آنها.

نحوه پیگیری میزان استفاده از سهمیه شما به این صورت است:

• سهمیه‌ها به ازای هر متد هستند. برای مثال، متد get سهمیه‌ای جداگانه از متد update دارد.
• هر درخواست، صرف نظر از نوع آن، یک بار شمارش می‌شود. برای مثال، ما یک درخواست list شامل ۲۵۰ آیتم را یک بار شمارش می‌کنیم، نه اینکه ۲۵۰ درخواست get .
• سهمیه بر اساس کاربری که درخواست API را ارسال می‌کند، محاسبه می‌شود. اگر کاربر عضو مستقیم یک حساب پیشرفته باشد، سهمیه در سطح حساب پیشرفته محاسبه خواهد شد.
• برای سرویس datasources ، مقیاس‌بندی سهمیه خودکار فقط برای حساب‌های پیشرفته بر اساس تعداد حساب‌های فرعی آنها اعمال می‌شود. سهمیه‌ها برای حساب‌های مستقل و حساب‌های فرعی ثابت هستند و افزایش آنها معمولاً پشتیبانی نمی‌شود. برای بررسی محدودیت‌های سهمیه datasource ، از متدهای accounts.limits استفاده کنید.
• سهمیه‌ها برای گروه خدمات خرید مقایسه‌ای (CSS)، CSS، حساب یا زیرحساب‌هایی که هنگام برقراری تماس با آنها احراز هویت می‌کنید، اعمال می‌شوند. برای مثال، اگر به عنوان یک حساب پیشرفته احراز هویت شوید، تماس‌ها با سهمیه حساب پیشرفته شما محاسبه می‌شوند، اما اگر به عنوان یکی از زیرحساب‌های خود احراز هویت کنید، تماس‌ها با سهمیه حساب فرعی محاسبه می‌شوند.

نمودار، سلسله مراتب گروه‌های CSS، CSS، حساب‌ها و زیرحساب‌ها را نشان می‌دهد.

تغییرات سهمیه فراخوانی متد از API محتوا برای خرید

اگر از API محتوا برای خرید استفاده کرده‌اید، به تغییرات سهمیه فراخوانی متد زیر در API فروشنده توجه کنید:

• عدم وجود دسته بندی سفارشی بر محاسبه سهمیه تأثیری ندارد. برای مثال، یک درخواست دسته ای حاوی ۵۰۰ درخواست درج، به عنوان ۵۰۰ درخواست روش درج جداگانه محاسبه می شود.
• اتوماسیون سهمیه‌بندی برای حساب‌ها و محصولات همچنان برقرار است.
• برای تعیین میزان استفاده و محدودیت‌های سهمیه فعلی خود، از جمله خودکارسازی و لغوها، از متد Quota.list استفاده کنید.

سهمیه تماس‌هایتان را بررسی کنید

برای بررسی سهمیه تماس فعلی و میزان استفاده از یک حساب، quotas.list را به همراه name حساب فراخوانی کنید.

سهمیه‌بندی خودکار برای products ، accounts و سرویس‌های datasources اعمال می‌شود.

• برای منابعی که سهمیه خودکار دارند ( products ، accounts و datasources برای حساب‌های پیشرفته): شما فقط می‌توانید برای سناریوهای خاص مانند راه‌اندازی در یک بازار جدید یا در فصول خرید پرترافیک، درخواست افزایش سهمیه موقت دهید. ما افزایش سهمیه دائمی را برای این نوع منابع نمی‌پذیریم.
• برای سایر منابع بدون سهمیه‌بندی خودکار: می‌توانید در صورت نیاز درخواست افزایش سهمیه دهید.

از فرم Quota increase request از فرم پشتیبانی تماس استفاده کنید و اطلاعات زیر را در آن وارد کنید:

• شناسه مرکز تجاری شما
• روش‌هایی که در آنها به محدودیت سهمیه خود رسیده‌اید
• تخمین تعداد تماس‌های مورد نیاز روزانه برای آن روش‌ها
• دلیل نیاز به افزایش سهمیه
• چه افزایش موقت باشد چه دائمی

توصیه می‌کنیم سهمیه‌های خود را به صورت دوره‌ای بررسی کنید تا از سهمیه کافی برای پیاده‌سازی خود یا نحوه تنظیم خودکار سهمیه خود اطمینان حاصل کنید.

خطاها

اگر از سهمیه تعیین شده تجاوز کنید، خطاهای زیر را دریافت خواهید کرد:

• در هر دقیقه: 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 به شما امکان می‌دهند محدودیت‌های مربوط به موجودیت‌های سطح حساب را بررسی کنید. می‌توانید از این متدها برای بررسی محدودیت‌های محصول استفاده کنید.

برای بازیابی محدودیت خاص محصول، به عنوان مثال، برای دریافت سهمیه تبلیغات EEA یک حساب، باید شناسه حساب و شناسه محدودیت را در فراخوانی accounts.limits.get مشخص کنید. شناسه محدودیت ترکیبی از نوع محدودیت و دامنه آن است. به عنوان مثال، products~ADS_EEA برای محصولاتی که تبلیغات را در EEA هدف قرار می‌دهند و products~ADS_NON_EEA برای محصولاتی که تبلیغات را خارج از 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

برای اطلاعات بیشتر در مورد سهمیه‌بندی محصولات، به بخش «درک سهمیه‌بندی در مرکز فروشندگان گوگل» مراجعه کنید.

محدودیت‌های نمایش منابع

محدودیت‌های زیر، محدودیت‌های قابل توجهی را برای مقادیر رشته‌ای خاص و فیلدهای آرایه‌ای در نمایش منابع مورد استفاده در Merchant API شرح می‌دهند. این محدودیت‌ها هم برای Merchant API و هم برای ویژگی مربوطه در Merchant Center یکسان هستند.

توجه داشته باشید که این لیست محدودیت‌ها ممکن است کامل نباشد. ما این محدودیت‌ها را گسترش نخواهیم داد.

تعداد ردیف‌ها یا ستون‌های جدول نرخ، فیلدهای آرایه‌ای زیر را تحت تأثیر قرار می‌دهد:

• فیلدهای آرایه درون rowHeaders یا columnHeaders :
  • prices[]
  • weights[]
  • numberOfItems[]
  • postalCodeGroupNames[]
  • locations[]
  • rows[]
  • cells[]