Ограничения на использование
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Квота проверяется на основе 60-секундной скользящей средней , что допускает резкие скачки нагрузки . По умолчанию на API Classroom действуют ограничения, указанные в следующей таблице:
| Предел | Стандарт квоты |
|---|
| Запросов в день на одного клиента | 4 000 000 (в среднем 46 запросов в секунду) |
| Запросов в минуту на клиента | 3000 (50 QPS) |
| Запросов в минуту на пользователя | 1200 (20 QPS) |
Допустимый QPS может быть увеличен или уменьшен в зависимости от ряда эксплуатационных факторов.
Если вам необходимо сделать больше запросов, чем установлено для вашего проекта:
- Во-первых, убедитесь, что вы реагируете на ошибки, допускающие повторные попытки (например, на ошибку
RESOURCE_EXHAUSTED , которая возвращается, когда запрос превышает ваши ограничения), повторяя запрос, желательно используя экспоненциальную задержку. - Если вы опрашиваете изменения на конечной точке, где это предлагается, рассмотрите возможность использования push-уведомлений .
- Если вам все равно необходимо сделать больше запросов, чем установлено для вашего проекта, см. инструкции по запросу более высоких лимитов ниже.
Чтобы просмотреть или изменить лимиты использования для вашего проекта или запросить увеличение квоты, выполните следующие действия:
- Если у вас еще нет платежного аккаунта для вашего проекта, создайте его.
- Посетите страницу «Включенные API» библиотеки API в консоли API и выберите API из списка.
- Чтобы просмотреть и изменить настройки квот, выберите «Квоты» . Чтобы просмотреть статистику использования, выберите «Использование» .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-30 UTC.
[null,null,["Последнее обновление: 2025-07-30 UTC."],[],[],null,["# Usage Limits\n\nQuota is checked on a **60-second moving average** , which **allows for spikes in\nusage**. By default, the Classroom API is subject to the limits in the following\ntable:\n\n| Limit | Quota Standard |\n|-------------------------------|-------------------------|\n| Queries per day per client | 4,000,000 (Avg. 46 QPS) |\n| Queries per minute per client | 3,000 (50 QPS) |\n| Queries per minute per user | 1,200 (20 QPS) |\n\nThe permitted QPS may be increased or decreased depending on a number of\noperational factors.\n\nIf you need to make more requests than the limits applied to your project:\n\n1. First, ensure that you respond to retryable errors (such as the `RESOURCE_EXHAUSTED` error that is returned when a request exceeds your limits) by retrying the request, preferably using exponential backoff.\n2. If you are polling for changes on an endpoint where this is offered, consider using [push notifications](/workspace/classroom/guides/push-notifications) instead.\n3. If you still need to make more requests than the limits assigned to your project, see below for instructions on requesting higher limits.\n\nTo view or change usage limits for your project, or to request an increase to\nyour quota, do the following:\n\n1. If you don't already have a [billing account](//cloud.google.com/billing/docs/how-to/manage-billing-account) for your project, then create one.\n2. [Visit the Enabled APIs page of the\n API library](https://console.cloud.google.com/apis/enabled) in the API Console, and select an API from the list.\n3. To view and change quota-related settings, select **Quotas** . To view usage statistics, select **Usage**."]]
