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

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

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

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

Уровень доступа Может получить доступ... Лимит ежедневной работы 1 Применять
Доступ к тестовому аккаунту Тестовые аккаунты 15 000 операций/день инструкции
Базовый доступ Тестовые и производственные счета 15 000 операций/день инструкции
Стандартный доступ Тестовые и производственные счета Неограниченное количество операций/день инструкции

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

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

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

Подача заявки на доступ к тестовому аккаунту

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

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

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

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

Подача заявки на базовый доступ

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

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

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

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

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

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

Подача заявки на стандартный доступ

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

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

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

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

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

Изменение разрешенного использования

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