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

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

Тип запроса, ограничение и код ошибки
Разбивка на страницы запросов 10 000 строк на странице INVALID_PAGE_SIZE
Операции с базовым доступом 15 000 операций API в день RESOURCE_EXHAUSTED
Мутировать запросы 10 000 операций на запрос TOO_MANY_MUTATE_OPERATIONS
Планирование запросов на обслуживание 1 запрос в секунду RESOURCE_EXHAUSTED
Запросы на службу загрузки конверсий 2000 конверсий за запрос TOO_MANY_CONVERSIONS_IN_REQUEST
Запросы на обслуживание счетов и бюджета аккаунта 1 операция на запрос на изменение TOO_MANY_MUTATE_OPERATIONS

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

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

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

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

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

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

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

Мутировать запросы

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

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

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

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

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

Разбивка на страницы запросов

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

Запросы с разбивкой на страницы, такие как поисковые запросы, также подпадают под действие ограничения Page size cannot exceed 10,000 rows ​​и отклоняются, если он нарушает это ограничение, с ошибкой: INVALID_PAGE_SIZE .

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

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

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

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

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

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

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

Услуги по планированию

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

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

Объект плана ключевых слов Максимальное количество
KeywordPlan для каждого аккаунта 10 000
KeywordPlanAdGroup для каждого KeywordPlan 200
KeywordPlanAdGroupKeyword для каждого KeywordPlan 10 000
KeywordPlanCampaignKeyword (минус-слова) 1000
KeywordPlanCampaign по KeywordPlan 1

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

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

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

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

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

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

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

  • Между изменениями заказа бюджета в одном аккаунте должно пройти не менее 12 часов. Внесение изменений до истечения 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 .

Другие виды лимитов

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

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

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