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

Ваш торговый счет и использование вами API торговца регулируются квотами и ограничениями.

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

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

• Вы можете обновлять свои продукты не чаще двух раз в день.
• Вы можете обновлять свои субсчета только один раз в день.

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

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

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

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

На диаграмме показана иерархия групп CSS, CSS, учетных записей и субсчетов.

Изменения квоты вызова методов из Content API для покупок

Если вы использовали Content API для покупок, обратите внимание на следующие изменения квоты вызовов методов в Merchant API:

• Отсутствие пользовательского пакетирования не влияет на расчёт квоты. Например, пакетный запрос, содержащий 500 запросов на вставку, тарифицируется как 500 запросов на отдельные методы вставки.
• Автоматизация квот для счетов и продуктов остается в силе.
• Чтобы определить текущее использование квоты и лимиты, включая автоматизацию и переопределения, используйте метод 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 позволяют проверять лимиты на уровне аккаунта . Эти методы можно использовать для проверки лимитов на продукты.

Чтобы получить лимит на конкретный продукт, например, квоту Ads EEA для аккаунта, необходимо указать идентификатор аккаунта и идентификатор лимита в вызове 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[]