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

API Google Ads накладывает ограничения на операции API, например, на количество операций, которые можно отправить в одном запросе mutate. В следующей таблице приведены некоторые важные ограничения и квоты, о которых следует знать.

Ежедневные лимиты операций API

Суточные лимиты использования API основаны на количестве операций API, выполненных на один токен разработчика. Операции API представляют собой сумму запросов на получение и операций мутации. Суточные лимиты на операции API зависят от уровня доступа токена разработчика. В руководстве «Уровни доступа и допустимое использование» описаны конкретные лимиты на операции API для каждого уровня доступа.

Запросы, нарушающие эти ограничения, отклоняются с ошибкой: RESOURCE_EXHAUSTED .

ограничения gRPC

Все клиентские библиотеки API Google Ads используют gRPC для генерации запросов и ответов. По умолчанию размер сообщения gRPC составляет 4 МБ, но наши клиентские библиотеки устанавливают максимальный размер сообщения в 64 МБ для повышения эффективности.

Ответы не должны превышать этот лимит. Например, поисковый запрос, включающий множество полей, может сгенерировать ответ размером более 64 МБ. Чтобы обойти это ограничение, можно уменьшить количество выбранных полей или использовать потоковую передачу . Для мутаций отправляйте меньше операций на запрос.

Запросы, нарушающие это ограничение, не будут генерировать ошибку GoogleAdsError , но будут генерировать ошибку gRPC 429 Resource Exhausted . См. список кодов ошибок и сообщений gRPC .

Запросы на мутацию

Помимо учета ежедневной квоты операций пользователя, запрос на мутацию не может содержать более 10 000 операций на запрос.

Запросы, нарушающие это ограничение, отклоняются с ошибкой: TOO_MANY_MUTATE_OPERATIONS .

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

Поисковые запросы

Запрос Search или SearchStream учитывается как одна операция в ежедневной квоте операций пользователя. Один запрос SearchStream учитывается как одна операция API независимо от количества пакетов.

Постраничные запросы

Запросы с разбивкой на страницы (например, запросы, содержащие действительный токен next_page_token ) не учитываются в ежедневной квоте пользователя. Однако запросы с разбивкой на страницы, содержащие просроченный или недействительный токен страницы, генерируют исключение и учитываются в ежедневной квоте пользователя.

Более подробную информацию о пагинации см. в разделе Пагинация результатов .

Другие типы запросов

Запрос, который не является запросом Get , Mutate , Search или SearchStream учитывается как одна операция в ежедневной квоте операций пользователя.

Вот несколько примеров таких запросов:

• BatchJobService.ListMutateJobResults
• ConversionUploadService.UploadCallConversions
• ConversionUploadService.UploadClickConversions
• OfflineUserDataJobService.AddOfflineUserDataJobOperations
• OfflineUserDataJobService.CreateOfflineUserDataJob
• UserDataService.UploadUserData

Запросы, возвращающие исключения API

Запросы, отклоненные с ошибкой GoogleAdsFailure , по-прежнему учитываются в ежедневной квоте операций пользователя.

Запросы, которые не были выполнены, но не возвращают GoogleAdsFailure , например, из-за ошибки на уровне сети, не будут учитываться в ежедневной квоте пользователя, поскольку эти запросы никогда не будут доставлены службе. Примером этого является сбой сетевого подключения.

Служба планирования ключевых слов

Из-за стоимости и сложности на следующие методы обслуживания по планированию ключевых слов распространяются отдельные ограничения по сравнению с другими типами запросов.

• Ограничено 1 запросом в секунду на CID:

  • KeywordPlanIdeaService.GenerateKeywordIdeas
  • KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
  • KeywordPlanIdeaService.GenerateKeywordForecastMetrics

  Запросы, нарушающие эти ограничения, отклоняются с ошибкой: RESOURCE_EXHAUSTED .

• 1 QPS рассчитывается как 60 запросов за 60 секунд.

• Ограничено 2 запросами в секунду на CID:

  • KeywordPlanIdeaService.GenerateAdGroupTheme

Помните об этих ограничениях при создании плана ключевых слов.

Служба анализа аудитории

Следующие методы в методах AudienceInsightsService подпадают под определенные квоты.

• Ограничено примерно 200 запросами в день на CID:

  • AudienceInsightsService.generateAudienceCompositionInsights
  • AudienceInsightsService.generateSuggestedTargetingInsights

• Ограничено 2 запросами в секунду на токен разработчика:

  • AudienceInsightsService.generateTargetingSuggestionMetrics

Служба загрузки конверсий

• Ограничено 2000 конверсиями звонков или кликов на запрос:

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

  Запросы, нарушающие эти ограничения, отклоняются с ошибкой: TOO_MANY_CONVERSIONS_IN_REQUEST .

Служба загрузки корректировок конверсий

• Ограничено 2000 корректировок конверсий на запрос:

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

  Запросы, нарушающие эти ограничения, отклоняются с ошибкой: TOO_MANY_ADJUSTMENTS_IN_REQUEST .

Услуги по выставлению счетов и бюджетированию счетов

• Изменения можно вносить только в те учетные записи, для которых настроено ежемесячное выставление счетов.

  Запросы, нарушающие это ограничение, отклоняются с ошибкой: MUTATE_NOT_ALLOWED .

• Для запросов на мутацию разрешена только 1 операция.

  Запросы, нарушающие это ограничение, отклоняются с ошибкой: TOO_MANY_MUTATE_OPERATIONS .

• Интервал между изменениями в заказе бюджета для одного и того же аккаунта должен составлять не менее 12 часов. Внесение изменений до истечения этого срока может привести к неустранимым сбоям, которые может устранить только ваш менеджер по работе с аккаунтом Google Рекламы.

Приглашения в аккаунты клиентов

Новых пользователей можно приглашать в существующие клиентские учётные записи с помощью CustomerUserAccessService . Поскольку эта функция отправляет приглашения другим пользователям, она может быть использована не по назначению, поэтому её применение ограничено:

• Пользователи не могут получать более одного ожидающего приглашения для одной и той же учётной записи клиента. При последующем запросе на отправку приглашения пользователю, у которого уже есть ожидающее приглашение, возвращается эта ошибка: ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION .

• Учётные записи клиентов не могут одновременно содержать более 70 ожидающих приглашений. Если отправленный запрос приводит к превышению этого значения, возвращается следующая ошибка: ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED .

Данные пользователя

Управление пользовательскими данными осуществляется с помощью UserDataService и OfflineUserDataJobService . В каждой операции создания или удаления UserData каждый набор user_identifiers должен соответствовать одному пользователю.

Чтобы обеспечить это, возвращается ошибка OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS или UserDataError.TOO_MANY_USER_IDENTIFIERS , если в наборе UserData содержится более 20 user_identifiers .

Вам разрешено использовать до 100 000 идентификаторов пользователей независимо от количества операций.

Другие типы ограничений

Повторяющееся поле, например список операций, в запросе которого содержится слишком много элементов, может привести к ошибке REQUEST_SIZE_LIMIT_EXCEEDED . Это же сообщение об ошибке может быть вызвано и другими проблемами.

Если вы столкнулись с этим ограничением и делаете запросы, в которых используется повторяющееся поле, попробуйте сократить количество элементов в повторяющемся поле, развернув список операций в запросе на изменение.

При выполнении запроса GAQL максимальное количество элементов в предложении IN составляет 20 000. При превышении этого ограничения возвращается ошибка FILTER_HAS_TOO_MANY_VALUES .