Функции API торговца имеют строгие квоты и ограничения.
Обновление политики
API торговца применяет следующие политики в отношении обновлений:
- Вы можете обновлять свои продукты не чаще двух раз в день.
- Вы можете обновлять свои субсчета только один раз в день.
Изменения, связанные с квотами между API Merchant и API Content for Shopping
- Квота будет рассчитываться по ресурсу, а не по методу. Это означает, что некоторые сервисы теперь связаны.
- Отсутствие пользовательского пакетирования не влияет на расчет квоты. Например, пакетный запрос, содержащий 500 запросов на вставку, будет оплачиваться как 500 индивидуальных запросов на метод вставки.
- Автоматизация квот для счетов и продуктов остается в силе.
- Чтобы определить текущее использование квот и лимиты, включая автоматизацию и переопределения, используйте метод Quota.list .
Квоты вызовов методов
API торговца автоматически регулирует квоты вызовов для ваших products
и accounts
в зависимости от вашего использования.
Вот как мы отслеживаем использование вашей квоты:
- Квоты устанавливаются для каждого метода. Например, метод
get
имеет отдельную квоту от методаupdate
. - Каждый запрос считается один раз, независимо от его типа. Например, мы считаем запрос
list
из 250 элементов один раз, а не как 250 запросовget
. - Квота взимается на основе пользователя, который делает запрос API. Если пользователь является прямым членом расширенной учетной записи, квота будет взиматься на уровне расширенной учетной записи.
- Квоты применяются к группе Comparison Shopping Services (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 | Услуги доставки по странам ( Группы доставки по каждой службе доставки ( Этикетки для каждой группы доставки ( Подтаблицы по группам отгрузки ( Количество строк или столбцов в одной таблице ставок . Длина транспортных этикеток. | 20 20 30 100 150 100 |
Количество строк или столбцов в таблице ставок влияет на следующие поля массива:
- Поля массива в
rowHeaders
илиcolumnHeaders
:-
prices[]
-
weights[]
-
numberOfItems[]
-
postalCodeGroupNames[]
-
locations[]
-
rows[]
-
cells[]
-