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

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

Важно! Начинаете работу с Google Ads API? 9 сентября 2026 г. поддержка токенов разработчика была прекращена, и теперь уровни доступа к API управляются на уровне проектов Google Cloud. После того как вы включите Google Ads API (что дает тестовый доступ), вы можете сразу же подать заявку на обзорной странице Google Ads API в консоли Google Cloud, чтобы получить ознакомительный доступ (в большинстве случаев заявка проверяется и одобряется автоматически,что позволяет выполнять до 2880 операций в день в рабочих аккаунтах). Инструкции по полной настройке вы найдете в кратком руководстве по первому вызову или руководстве по MCP-серверу Google Рекламы.

Перейти к обзору Google Ads API в Cloud Console

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

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

Уровень доступа	Аккаунты	Дневное ограничение на количество операций ^1	Как подать заявку	Сколько времени обычно занимает проверка?
Тест	Тестовые аккаунты	15 000 операций в день	Как подать заявку на доступ к тестированию
Исследователь	Тестовые и рабочие	2880 операций в день для рабочих аккаунтов 15 000 операций в день для тестовых аккаунтов	Как подать заявку на доступ к Explorer
Основные	Тестовые и рабочие	15 000 операций в день для тестовых и рабочих аккаунтов.	Как подать заявку на базовый доступ
Стандартный	Тестовые и рабочие	Неограниченное количество операций в день как для тестовых, так и для рабочих аккаунтов.	Как подать заявку на стандартный доступ	10 рабочих дней

¹ "В день" означает скользящий 24-часовой период времени, в течение которого запросы к API выполнялись с использованием вашего облачного проекта Google Cloud. Если за последние 24 часа вы превысили лимит запросов для вашего уровня доступа, приложение получит сообщение об ошибке.

Проверьте доступ

После включения Google Ads API вашему облачному проекту Google Cloud будет предоставлен тестовый доступ. Это означает, что проект может отправлять запросы к Google Ads API только в отношении тестовых аккаунтов.

Важно! Подробнее о том, как создать тестовый аккаунт, рассказывается в руководстве по тестовым аккаунтам.

Запросить доступ к тестированию

Включите Google Ads API в своем облачном проекте Google Cloud, чтобы автоматически получить тестовый доступ.

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

После того как вы зарегистрируетесь в Google Ads API, Google может предложить вам подать заявку на уровень доступа Explorer.

Уровень доступа Explorer позволяет вашему облачному проекту Google Cloud отправлять запросы к Google Ads API как для тестовых, так и для рабочих аккаунтов. Рабочие аккаунты – это аккаунты, в которых показываются реальные объявления Google. В тестовых аккаунтах объявления не показываются.

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

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

Ограниченная функциональность	Ограничения на использование сервисов и методов
Создание аккаунта	CustomerService.CreateCustomerClient
Управление доступом	CustomerUserAccessInvitationService CustomerUserAccessService
Планирование	KeywordPlanService KeywordPlanIdeaService KeywordPlanCampaignService KeywordPlanCampaignKeywordService KeywordPlanAdGroupService KeywordPlanAdGroupKeywordService AudienceInsightsService ReachPlanService
Оплата и платежи в аккаунте	PaymentsAccountService BillingSetupService AccountBudgetProposalService InvoiceService

Подать заявку на уровень доступа "Исследователь"

1. Перейдите на обзорную страницу Google Ads API в проекте Google Cloud.
2. Убедитесь, что на странице указан уровень доступа Тестовый.
3. Разверните раздел Повысить уровень доступа.
4. Убедитесь, что в качестве следующего уровня доступа указан Исследователь.
5. Нажмите кнопку Запросить доступ, чтобы подать заявку на уровень доступа "Исследователь".

После отправки заявки Google может автоматически повысить уровень доступа к API для вашего проекта до Explorer.

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

Базовый уровень доступа позволяет вашему проекту Google Cloud отправлять запросы к Google Ads API как в тестовые, так и в рабочие аккаунты. Рабочие аккаунты – это аккаунты, в которых показываются реальные объявления Google. В тестовых аккаунтах объявления не показываются.

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

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

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

1. Перейдите на обзорную страницу Google Ads API в проекте Google Cloud.
2. Убедитесь, что на странице указан ваш текущий уровень доступа – Исследователь.
3. Разверните раздел Повысить уровень доступа.
4. Убедитесь, что в поле Следующий уровень доступа указано Базовый.
5. Убедитесь, что нет предупреждений о том, что вы не завершили проверку бренда для своего проекта. Если да, то следуйте инструкциям, чтобы завершить проверку бренда, прежде чем продолжить.
6. Нажмите кнопку Подать заявку на доступ, чтобы запросить базовый уровень доступа.

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

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

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

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

Как подать заявку на стандартный доступ

1. Перейдите на обзорную страницу Google Ads API в проекте Google Cloud.
2. Убедитесь, что на странице указан ваш текущий уровень доступа – Базовый.
3. Разверните раздел Повысить уровень доступа.
4. Убедитесь, что в поле Следующий уровень доступа указано значение Стандартный.
5. Нажмите кнопку Подать заявку, чтобы начать подачу заявки на стандартный уровень доступа.

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

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

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

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

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

Разрешения

Допустимое использование применяется только к проектам Google Cloud со стандартным уровнем доступа. Разрешенное использование определяется на основе предполагаемого использования Google Ads API. Эти разрешения определяют, какие функции API может использовать ваш инструмент, как описано в таблице ниже.

Разрешение	Описание
Создание объявлений и управление ими	Предоставлять доступ ко всем сервисам API для создания кампаний Google Рекламы, групп объявлений, объявлений и ключевых слов и управления ими.
Отчеты	Выполняйте только запросы GoogleAdsService.Search или GoogleAdsService.SearchStream или вызовы только для чтения. Подходит разработчикам, которые используют API исключительно для получения статистики.
Анализ ключевых слов и рекомендаций	Разрешите облачному проекту Google Cloud доступ к RecommendationService, KeywordPlanIdeaService и KeywordPlanService. Эти данные используются только инструментами, которым нужны рекомендации, чтобы упростить создание кампаний Google Рекламы и управление ими.

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

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