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