Квоты и лимиты

Функции API торговца имеют строгие квоты и ограничения.

Обновление политики

API торговца применяет следующие политики в отношении обновлений:

  • Вы можете обновлять свои продукты не чаще двух раз в день.
  • Вы можете обновлять свои субсчета только один раз в день.
  • Квота будет рассчитываться по ресурсу, а не по методу. Это означает, что некоторые сервисы теперь связаны.
  • Отсутствие пользовательского пакетирования не влияет на расчет квоты. Например, пакетный запрос, содержащий 500 запросов на вставку, будет оплачиваться как 500 индивидуальных запросов на метод вставки.
  • Автоматизация квот для счетов и продуктов остается в силе.
  • Чтобы определить текущее использование квот и лимиты, включая автоматизацию и переопределения, используйте метод Quota.list .

Квоты вызовов методов

API торговца автоматически регулирует квоты вызовов для ваших products и accounts в зависимости от вашего использования.

Вот как мы отслеживаем использование вашей квоты:

  • Квоты устанавливаются для каждого метода. Например, метод get имеет отдельную квоту от метода update .
  • Каждый запрос считается один раз, независимо от его типа. Например, мы считаем запрос list из 250 элементов один раз, а не как 250 запросов get .
  • Квота взимается на основе пользователя, который делает запрос API. Если пользователь является прямым членом расширенной учетной записи, квота будет взиматься на уровне расширенной учетной записи.
  • Квоты применяются к группе Comparison Shopping Services (CSS), CSS, учетной записи или субсчетам, по которым вы проходите аутентификацию при совершении звонка. Например, если вы проходите аутентификацию как расширенная учетная запись , звонки учитываются в квоте вашей расширенной учетной записи, но если вы проходите аутентификацию как одна из ваших субсчетов, звонки учитываются в квоте субсчета.

На диаграмме показана иерархия групп CSS, CSS, учетных записей и субсчетов. Группа CSS — это всеобъемлющий уровень аутентификации, с возможностью отдельных CSS внутри нее, учетных записей внутри них и субсчетов как самого индивидуального уровня.

Проверьте свои квоты

Чтобы проверить текущую квоту и использование для учетной записи, вызовите quotas.list , указав name учетной записи.

Автоматическая квота применяется только к products и услугам accounts . Если вам нужна увеличенная квота для любой другой услуги, вы исчерпываете свою дневную квоту для products или услуг accounts или вам нужно временное увеличение для services accounts или продуктов, свяжитесь с нами , предоставив следующую информацию:

  • Ваш идентификатор 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

Ограничения на представление ресурсов

Следующие ограничения описывают заметные ограничения для определенных строковых значений и полей массива в представлениях ресурсов, используемых в API Merchant. Эти ограничения одинаковы как для API Merchant, так и для соответствующей функции в Merchant Center.

Обратите внимание, что этот список ограничений может быть неполным. Мы не будем расширять эти ограничения.

Ресурс Поле Предел
shippingsettings

Услуги доставки по странам ( services ).

Группы доставки по каждой службе доставки ( rateGroups ).

Этикетки для каждой группы доставки ( applicableShippingLabels ).

Подтаблицы по группам отгрузки ( subtables ).

Количество строк или столбцов в одной таблице ставок .

Длина транспортных этикеток.

20

20

30

100

150

100

Количество строк или столбцов в таблице ставок влияет на следующие поля массива:

  • Поля массива в rowHeaders или columnHeaders :
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]