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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

سهمیه خودکار فقط برای products و خدمات accounts اعمال می‌شود. اگر به سهمیه افزایش یافته برای هر سرویس دیگری نیاز دارید، سهمیه روزانه شما برای products یا خدمات accounts تمام شده است، یا به افزایش موقت برای accounts یا services محصولات نیاز دارید، با اطلاعات زیر با ما تماس بگیرید :

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

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

خطاها

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

  • در هر دقیقه: 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) شرح می‌دهند. این محدودیت‌ها هم برای رابط برنامه‌نویسی کاربردی فروشنده و هم برای ویژگی متناظر آنها در مرکز فروشندگان یکسان هستند.

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

منبع میدان حد
shippingsettings

خدمات حمل و نقل در هر کشور ( services ).

گروه‌های حمل و نقل به ازای هر سرویس حمل و نقل ( rateGroups ).

برچسب‌ها به ازای هر گروه حمل و نقل (برچسب‌های applicableShippingLabels ).

زیرجدول‌ها به ازای هر گروه حمل و نقل ( subtables ).

تعداد ردیف‌ها یا ستون‌ها در یک جدول نرخ واحد.

طول برچسب‌های حمل و نقل.

۲۰

۲۰

۳۰

۱۰۰

۱۵۰

۱۰۰

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

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