Ограничения и квоты

В этом руководстве рассказывается о лимитах и квотах при работе с Data Manager API.

Ограничения на количество проектов

Чтобы использовать Data Manager API, вам понадобится проект Google Cloud. В проекте Google Cloud есть клиент OAuth и учетные данные, которые используются для аутентификации запросов к API.

Data Manager API применяет ограничение частоты запросов для каждого проекта Google Cloud, разделенные по сервисам и типам операций (чтение и изменение):

Сервис Операция Количество запросов в сутки Количество запросов за минуту
IngestionService Изменение (запись) 100 000 300
IngestionService Чтение 100 000 300
Все остальные сервисы вместе Изменение (запись) 50 000 300
Все остальные сервисы вместе Чтение 50 000 300

Запросы, превышающие лимиты, отклоняются с ошибкой RESOURCE_EXHAUSTED и статусом HTTP 429 Too Many Requests.

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

Названия квот

Каждое ограничение соответствует названию квоты и показателю в Google Cloud. Если запрос превышает лимит, Data Manager API возвращает название лимита квоты в стандартной полезной нагрузке ErrorInfo в разделе metadata.quota_limit:

Название квоты Сервис Операция Окно Ограничение
IngestionMutateRequestsPerDayPerProject IngestionService Изменить День 100 000
IngestionMutateRequestsPerMinutePerProject IngestionService Изменить минута 300
IngestionReadRequestsPerDayPerProject IngestionService Чтение День 100 000
IngestionReadRequestsPerMinutePerProject IngestionService Чтение минута 300
ManagementMutateRequestsPerDayPerProject Все остальные сервисы Изменить День 50 000
ManagementMutateRequestsPerMinutePerProject Все остальные сервисы Изменить минута 300
ManagementReadRequestsPerDayPerProject Все остальные сервисы Чтение День 50 000
ManagementReadRequestsPerMinutePerProject Все остальные сервисы Чтение минута 300

Проверьте значение metadata.quota_limit в полезной нагрузке ErrorInfo, чтобы определить, какая ошибка возникла: из-за превышения дневного лимита или лимита в минуту. В зависимости от этого решите, нужно ли временно приостановить работу и повторить попытку с экспоненциальным увеличением интервала или приостановить работу до сброса дневной квоты. Подробнее об ошибках, связанных с квотами и ограничением частоты запросов…

Ограничения на количество запросов

Ниже приведены ограничения для определенных запросов.

  • IngestAudienceMembersRequest и RemoveAudienceMembersRequest:

    • 10 000 ресурсов AudienceMember в списке audience_members

    • 10 идентификаторов пользователей в UserData для AudienceMember

    • 10 ресурсов Destination в списке destinations

  • RemoveAllAudienceMembersRequest:

    • 10 ресурсов Destination в списке destinations

  • IngestEventsRequest:

    • 2000 ресурсов Event в списке events

    • 10 идентификаторов пользователей в UserData для Event

    • 10 ресурсов Destination в списке destinations