Уровни доступа и разрешенное использование

Каждому токену разработчика API Google Ads назначаются уровень доступа и «допустимое использование». Уровень доступа определяет, можете ли вы влиять на рабочие аккаунты, а также количество операций и запросов, которые вы можете выполнять ежедневно. Допустимое использование определяет конкретные функции API Google Ads, которые разрешено использовать с помощью токена разработчика.

Уровни доступа

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

^1. «В день» рассчитывается на основе скользящего 24-часового периода, в течение которого выполнялись запросы к API с вашим токеном разработчика. Ваше приложение получит ошибку, если оно превысит лимит запросов для вашего уровня доступа в течение последних 24 часов.

Уровень доступа к тестовой учетной записи

После завершения первоначальной регистрации в API Google Ads вам будет выдан токен разработчика с уровнем доступа «Тестовый аккаунт». Это означает, что токен разработчика позволяет отправлять запросы API Google Ads только к тестовым аккаунтам.

Как подать заявку на уровень доступа к тестовому аккаунту

Зарегистрируйтесь в API Google Ads в веб-интерфейсе Google Ads, чтобы автоматически получить уровень доступа к тестовому аккаунту.

Уровень доступа Explorer

После завершения первоначальной регистрации в API Google Ads Google может в некоторых случаях автоматически повысить ваш токен разработчика с уровня доступа Test Account Access до уровня Explorer Access. Уровень доступа Explorer Access позволяет токену разработчика отправлять запросы API Google Ads как к тестовым, так и к рабочим аккаунтам. Рабочие аккаунты — это любые аккаунты, которые показывают настоящую рекламу Google. Тестовые аккаунты не показывают рекламу.

Уровень доступа Explorer позволяет токену разработчика выполнять до 2880 операций в день с аккаунтами production. Этого достаточно для большинства разработчиков, чтобы начать работу с API и создать базовую автоматизацию.

Уровень доступа Explorer ограничивает доступ к следующим функциям. Для использования этих функций необходимо подать заявку на уровень доступа Basic Access или Standard Access .

Как подать заявку на уровень доступа Explorer

Зарегистрируйтесь в API Google Ads через веб-интерфейс Google Ads. В некоторых случаях Google может автоматически повысить ваш токен разработчика до уровня Explorer Access после завершения регистрации.

Базовый уровень доступа

Уровень базового доступа позволяет токену разработчика отправлять запросы к API Google Ads как к тестовым, так и к рабочим аккаунтам. Рабочие аккаунты — это любые аккаунты, которые показывают настоящую рекламу Google в режиме реального времени. Тестовые аккаунты не показывают рекламу.

Базовый уровень доступа позволяет токену разработчика выполнять до 15 000 операций в день. Этого достаточно для большинства разработчиков.

Как подать заявку на уровень базового доступа

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

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

Стандартный уровень доступа

Уровень «Стандартный доступ» позволяет токену разработчика выполнять неограниченное количество операций в день для большинства сервисов. Это включает, помимо прочего, GoogleAdsService Search и SearchStream . Подробнее об ограничениях и исключениях для уровня «Стандартный доступ» см. в разделе «Квоты API» .

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

Как подать заявку на уровень стандартного доступа

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

Если ваш инструмент внешний, будьте готовы предоставить доступ для демо-входа. Обратите внимание, что ваш инструмент должен соответствовать минимально необходимым функциональным возможностям .

Квоты API и ограничения скорости системы

Независимо от уровня доступа, все операции API подчиняются системным ограничениям скорости, которые ограничивают количество операций, которые вы можете выполнить за определённый период времени, то есть количество операций в час. Подробнее об обработке ошибок, связанных с ограничением скорости, см. в разделе «Типы ошибок» .

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

Допустимое использование

Разрешенное использование распространяется только на токены разработчика с уровнями «Базовый доступ» и «Стандартный доступ». Разрешенное использование определяется предполагаемым использованием API Google Рекламы. Эти разрешения определяют, для каких функций API может использоваться токен разработчика, как указано в следующей таблице:

Как изменить допустимое использование

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