Google Ads API устанавливает ограничения на операции API, такие как количество операций, которые могут быть отправлены в одном запросе mutate. В следующей таблице приведены некоторые важные ограничения и квоты, о которых следует знать.
| Тип запроса, ограничение и код ошибки | ||
|---|---|---|
| Операции с базовым доступом | 15 000 операций API в день | RESOURCE_EXHAUSTED |
| Запросы на мутацию | 10 000 операций на запрос | TOO_MANY_MUTATE_OPERATIONS |
| Планирование запросов на обслуживание | 1 QPS | RESOURCE_EXHAUSTED |
| Запросы на услугу конвертации загрузки | 2000 конверсий на запрос | TOO_MANY_CONVERSIONS_IN_REQUEST |
| Запросы на обслуживание счетов и бюджета счета | 1 операция на запрос мутации | TOO_MANY_MUTATE_OPERATIONS |
Ежедневные лимиты операций API
Ежедневные лимиты использования API основаны на количестве операций API, выполненных на один токен разработчика. Операции API представляют собой общую сумму запросов get и операций mutate. Лимиты ежедневных операций API зависят от уровня доступа токена разработчика. В руководстве по уровням доступа и допустимому использованию описываются конкретные лимиты операций API для каждого уровня доступа.
Запросы, нарушающие эти ограничения, отклоняются с ошибкой: RESOURCE_EXHAUSTED .
ограничения gRPC
Все клиентские библиотеки API Google Ads используют gRPC для генерации запросов и ответов. По умолчанию размер сообщения gRPC составляет 4 МБ, но наши клиентские библиотеки устанавливают максимальный размер сообщения в 64 МБ для повышения эффективности.
Ответы не должны превышать этот лимит. Например, поисковый запрос, включающий много полей, может сгенерировать ответ, размер которого превышает 64 МБ. Чтобы обойти этот лимит, можно уменьшить количество выбранных полей или использовать потоковую передачу . Для mutates отправьте меньше операций на запрос.
Запросы, нарушающие это ограничение, не будут генерировать GoogleAdsError , но будут генерировать ошибку 429 Resource Exhausted gRPC. См. список кодов ошибок и сообщений 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:
Помните об этих ограничениях при создании плана ключевых слов.
| Объект плана ключевых слов | Максимальное количество |
|---|---|
KeywordPlan для учетной записи | 10,000 |
KeywordPlanAdGroup для KeywordPlan | 200 |
KeywordPlanAdGroupKeyword на KeywordPlan | 10,000 |
KeywordPlanCampaignKeyword (отрицательные ключевые слова) | 1000 |
KeywordPlanCampaign по KeywordPlan | 1 |
Служба анализа аудитории
На следующие методы AudienceInsightsService распространяются определенные квотные ограничения.
Ограничено примерно 200 запросами в день на CID:
Ограничено 2 запросами в секунду на токен разработчика:
Служба загрузки конверсий
Ограничено 2000 конверсий звонков или кликов на запрос:
Запросы, нарушающие эти ограничения, отклоняются с ошибкой:
TOO_MANY_CONVERSIONS_IN_REQUEST.
Служба загрузки корректировки конверсии
Ограничено 2000 корректировок конверсий на запрос:
Запросы, нарушающие эти ограничения, отклоняются с ошибкой:
TOO_MANY_ADJUSTMENTS_IN_REQUEST.
Услуги по выставлению счетов и составлению бюджета
Изменения можно вносить только в те учетные записи, для которых настроено ежемесячное выставление счетов.
Запросы, нарушающие это ограничение, отклоняются с ошибкой:
MUTATE_NOT_ALLOWED.Для запросов на изменение разрешена только 1 операция.
Запросы, нарушающие это ограничение, отклоняются с ошибкой:
TOO_MANY_MUTATE_OPERATIONS.Вам следует подождать не менее 12 часов между изменениями заказа бюджета для одного и того же аккаунта. Внесение изменений до истечения 12 часов может привести к неустранимым сбоям, которые может устранить только ваш представитель аккаунта Google Ads.
Приглашения в клиентские аккаунты
Новые пользователи могут быть приглашены в существующие клиентские учетные записи с помощью 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 .