Квоты защищают инфраструктуру Google от автоматизированных процессов, которые ненадлежащим образом используют API Менеджера кампаний 360. Они гарантируют, что действия одного разработчика не смогут негативно повлиять на более широкое сообщество.
Ограничения квоты
Следующие ограничения квот по умолчанию являются общими для всех ресурсов и методов API Менеджера кампании 360.
- 50 000 запросов на проект в день — можно увеличить .
- 1 запрос в секунду (QPS) на проект.
- В консоли Google API эта квота называется числом запросов в минуту на пользователя и по умолчанию равна 60. При необходимости этот лимит можно увеличить до максимального значения 600 (10 запросов в секунду).
Построитель отчетов применяет дополнительные ограничения квот, которые различаются в зависимости от учетной записи. Чтобы узнать больше, обратитесь к этой статье Справочного центра и таблице ниже.
Превышение квоты
В том маловероятном случае, если ваш запрос не будет выполнен из-за превышения ограничения квоты, API вернет код состояния HTTP и причину ошибки. Кроме того, тело ответа содержит подробное описание причины ошибки. Пример ответа на ошибку см. в руководстве « Сообщения об ошибках» .
В следующем списке показаны возможные ошибки и рекомендуемые действия в случае сбоя запроса, вызванного превышением квоты.
| Код | Причина | Сообщение | Рекомендуемое действие |
|---|---|---|---|
| 403 | ежедневный лимит превышен | Дневной лимит превышен | Не повторяйте попытку, не устранив проблему. Изучите свое использование с помощью консоли Google API и измените свой рабочий процесс, чтобы выполнять меньше запросов. Вы можете запросить дополнительную квоту, если считаете, что ваше использование является разумным. |
| 403 | квотаПревышена | В этом аккаунте превышена квота на количество отчетов в день. | Не пытайтесь больше создавать отчеты для этого аккаунта в этот день. Обратитесь за помощью к своему менеджеру аккаунта. |
| 403 | квотаПревышена | Этот профиль пользователя превысил квоту на количество отчетов в день. | Не пытайтесь больше создавать отчеты для этого профиля пользователя в этот день. Переключитесь на другой профиль пользователя или обратитесь за помощью к менеджеру своего аккаунта. |
| 403 | квотаПревышена | В этом аккаунте превышена квота на количество активных запланированных отчетов (x). | Прежде чем повторить этот запрос, деактивируйте запланированные отчеты, которые вам не нужны. |
| 403 | квотаПревышена | Профиль пользователя, которому принадлежит этот отчет, превысил квоту x активных запланированных отчетов. | Попросите владельца этого отчета деактивировать запланированные отчеты, которые ему не нужны, прежде чем повторить этот запрос. |
| 403 | квотаПревышена | В этом профиле пользователя превышена квота x активных запланированных отчетов. | Прежде чем повторить этот запрос, деактивируйте запланированные отчеты, которые вам не нужны. |
| 403 | квотаПревышена | Невозможно выполнить это действие, так как превышена одна из ваших квот. Обратитесь за помощью к менеджеру своего аккаунта. | Обратитесь за помощью к своему менеджеру аккаунта. |
| 403 | userRateLimitExceeded | Превышен лимит скорости пользователя | Увеличьте ограничение на количество пользователей в консоли Google API или замедлите скорость отправки запросов с помощью экспоненциальной задержки . С помощью этого API не рекомендуется выполнять одновременные запросы на запись или использовать ограничение скорости выше 10 QPS. |
Запрос дополнительной дневной квоты
Если вы считаете, что вашему приложению требуется дополнительная ежедневная квота, вы можете запросить ее, следуя инструкциям ниже.
Следующие инструкции применимы только к проектам, в которых возникла ошибка dailyLimitExceeded . Рекомендуемые действия при других ошибках квот описаны в таблице выше .
- Перейдите к API Менеджера кампаний 360 в консоли Google API.
- Просмотрите статистику использования на странице «Метрики» , чтобы убедиться, что ваше приложение работает должным образом. Прежде чем продолжить, обратите пристальное внимание на вызванные методы и устраните любое неожиданное или чрезмерное использование.
- Если использование выглядит нормально, перейдите на страницу «Квоты» , щелкните значок редактирования рядом с пунктом «Запросов в день» и нажмите ссылку «Подать заявку на увеличение квоты».
Обязательно ознакомьтесь с информацией и следуйте инструкциям, включенным в форму запроса квоты, прежде чем отправлять запрос на увеличение.
,Квоты защищают инфраструктуру Google от автоматизированных процессов, которые ненадлежащим образом используют API Менеджера кампаний 360. Они гарантируют, что действия одного разработчика не смогут негативно повлиять на более широкое сообщество.
Ограничения квоты
Следующие ограничения квот по умолчанию являются общими для всех ресурсов и методов API Менеджера кампании 360.
- 50 000 запросов на проект в день — можно увеличить .
- 1 запрос в секунду (QPS) на проект.
- В консоли Google API эта квота называется числом запросов в минуту на пользователя и по умолчанию равна 60. При необходимости этот лимит можно увеличить до максимального значения 600 (10 запросов в секунду).
Построитель отчетов применяет дополнительные ограничения квот, которые различаются в зависимости от учетной записи. Чтобы узнать больше, обратитесь к этой статье Справочного центра и таблице ниже.
Превышение квоты
В том маловероятном случае, если ваш запрос не будет выполнен из-за превышения ограничения квоты, API вернет код состояния HTTP и причину ошибки. Кроме того, тело ответа содержит подробное описание причины ошибки. Пример ответа на ошибку см. в руководстве « Сообщения об ошибках» .
В следующем списке показаны возможные ошибки и рекомендуемые действия в случае сбоя запроса, вызванного превышением квоты.
| Код | Причина | Сообщение | Рекомендуемое действие |
|---|---|---|---|
| 403 | ежедневный лимит превышен | Дневной лимит превышен | Не повторяйте попытку, не устранив проблему. Изучите свое использование с помощью консоли Google API и измените свой рабочий процесс, чтобы выполнять меньше запросов. Вы можете запросить дополнительную квоту, если считаете, что ваше использование разумно. |
| 403 | квотаПревышена | В этом аккаунте превышена квота на количество отчетов в день. | Не пытайтесь больше создавать отчеты для этого аккаунта в этот день. Обратитесь за помощью к своему менеджеру аккаунта. |
| 403 | квотаПревышена | Этот профиль пользователя превысил квоту на количество отчетов в день. | Не пытайтесь больше создавать отчеты для этого профиля пользователя в этот день. Переключитесь на другой профиль пользователя или обратитесь за помощью к менеджеру своего аккаунта. |
| 403 | квотаПревышена | В этом аккаунте превышена квота на количество активных запланированных отчетов (x). | Прежде чем повторить этот запрос, деактивируйте запланированные отчеты, которые вам не нужны. |
| 403 | квотаПревышена | Профиль пользователя, которому принадлежит этот отчет, превысил квоту x активных запланированных отчетов. | Попросите владельца этого отчета деактивировать запланированные отчеты, которые ему не нужны, прежде чем повторить этот запрос. |
| 403 | квотаПревышена | В этом профиле пользователя превышена квота x активных запланированных отчетов. | Прежде чем повторить этот запрос, деактивируйте запланированные отчеты, которые вам не нужны. |
| 403 | квотаПревышена | Невозможно выполнить это действие, так как превышена одна из ваших квот. Пожалуйста, обратитесь за помощью к своему менеджеру аккаунта. | Обратитесь за помощью к своему менеджеру аккаунта. |
| 403 | userRateLimitExceeded | Превышен лимит скорости пользователя | Увеличьте ограничение на количество пользователей в консоли Google API или замедлите скорость отправки запросов с помощью экспоненциальной задержки . С помощью этого API не рекомендуется выполнять одновременные запросы на запись или использовать ограничение скорости выше 10 QPS. |
Запрос дополнительной дневной квоты
Если вы считаете, что вашему приложению требуется дополнительная ежедневная квота, вы можете запросить ее, следуя инструкциям ниже.
Следующие инструкции применимы только к проектам, в которых возникла ошибка dailyLimitExceeded . Рекомендуемые действия при других ошибках квот описаны в таблице выше .
- Перейдите к API Менеджера кампаний 360 в консоли Google API.
- Просмотрите статистику использования на странице «Метрики» , чтобы убедиться, что ваше приложение работает должным образом. Прежде чем продолжить, обратите пристальное внимание на вызванные методы и устраните любое неожиданное или чрезмерное использование.
- Если использование выглядит нормально, перейдите на страницу «Квоты» , щелкните значок редактирования рядом с пунктом «Запросов в день» и нажмите ссылку «Подать заявку на увеличение квоты».
Обязательно ознакомьтесь с информацией и следуйте инструкциям, включенным в форму запроса квоты, прежде чем отправлять запрос на увеличение.