Google Ads API is returning to beta status. Please read our blog post for more details.

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

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

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

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

Уровень доступа Аккаунты Лимит операций Лимит операций get1 Как подать заявку
Доступ к тестовым аккаунтам Тестовые 15 000 в сутки 1000 в сутки Инструкции
Базовый доступ Тестовые и рабочие 15 000 в сутки 1000 в сутки Инструкции
Стандартный доступ Тестовые и рабочие Без ограничения 1000 в сутки Инструкции

1Не применяйте операции get, чтобы получать объекты для отчетов или обработки. Операции get предназначены только для проверки объектов в соответствии с этим руководством.

Подробная информация об уровнях доступа приведена ниже.

Доступ к тестовым аккаунтам

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

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

Чтобы получить доступ к тестовому аккаунту, достаточно выполнить регистрацию в интерфейсе Google Рекламы.

Базовый доступ

Идентификатор разработчика с базовым доступом можно применять для отправки запросов Google Ads API как по тестовым, так и по рабочим аккаунтам. Рабочим называется любой аккаунт, в котором показываются настоящие объявления Google (в отличие от тестовых аккаунтов).

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

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

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

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

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

Стандартный доступ позволяет выполнять любое количество операций mutate и запросов GoogleAdsService.Search, но не более 1000 операций get в сутки. Он предоставляется только тем разработчикам, которым необходимо выполнять неограниченное число операций Google Ads API (это, как правило, крупные компании или сервисы, обслуживающие множество пользователей).

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

Если у вас уже есть базовый доступ, заполните эту форму.

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

Разрешения

Разрешения задаются только для базового и стандартного уровней доступа. Они определяют, какими функциями API может воспользоваться рекламодатель с данным идентификатором, в зависимости от его целей работы с Google Реклама API (см. таблицу ниже).

Ниже приведен список доступных разрешений.

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

Как изменить разрешения

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