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

На ваш торговый аккаунт и использование вами 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 , или вам требуется временное увеличение квоты для services accounts или продуктам, свяжитесь с нами , предоставив следующую информацию:

• Идентификатор вашего торгового центра
• Методы, для которых вы достигли лимита квоты
• Примерное количество звонков в день, которое вам потребуется для этих методов.
• Причина, по которой вам необходимо увеличить квоту.
• Независимо от того, временное это повышение или постоянное.

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

Ошибки

При превышении квот вы получите следующие ошибки:

• За минуту: 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[]