Каждому токену разработчика API Google Ads назначаются уровень доступа и «допустимое использование». Уровень доступа определяет, можете ли вы влиять на рабочие аккаунты, а также количество операций и запросов, которые вы можете выполнять ежедневно. Допустимое использование определяет конкретные функции API Google Ads, которые разрешено использовать с помощью токена разработчика.
Уровни доступа
В таблице перечислены три различных уровня доступа. Если у вас ещё нет доступа к API Google Ads, вы можете зарегистрироваться для получения тестового доступа. Вы можете повысить уровень доступа, выполнив дополнительные действия в приложении.
| Уровень доступа | Возможен доступ... | Лимит суточной работы 1 | Применять |
|---|---|---|---|
| Доступ к тестовой учетной записи | Тестовые аккаунты | 15 000 операций в день | Инструкции |
| Базовый доступ | Тестовые и производственные счета | 15 000 операций в день | Инструкции |
| Стандартный доступ | Тестовые и производственные счета | Неограниченное количество операций в день | Инструкции |
1. «В день» рассчитывается на основе скользящего 24-часового периода, в течение которого выполнялись запросы к API с вашим токеном разработчика. Ваше приложение получит ошибку, если оно превысит лимит запросов для вашего уровня доступа в течение последних 24 часов.
Доступ к тестовой учетной записи
После завершения первоначальной регистрации в API Google Ads вам будет выдан токен разработчика с уровнем доступа «Тестовый аккаунт». Это означает, что токен разработчика позволяет отправлять запросы API Google Ads только к тестовым аккаунтам.
Как подать заявку на доступ к тестовому аккаунту
Зарегистрируйтесь в API Google Ads в веб-интерфейсе Google Ads, чтобы автоматически получить уровень доступа к тестовому аккаунту.
Базовый доступ
Уровень базового доступа позволяет токену разработчика отправлять запросы к API Google Ads как к тестовым, так и к рабочим аккаунтам. Рабочие аккаунты — это любые аккаунты, которые показывают настоящую рекламу Google в режиме реального времени. Тестовые аккаунты не показывают рекламу.
Базовый уровень доступа позволяет токену разработчика выполнять до 15 000 операций в день. Этого достаточно для большинства разработчиков.
Как подать заявку на базовый доступ
Если у вас есть токен разработчика с доступом к тестовой учётной записи и вы хотите подать заявку на доступ к рабочей учётной записи, заполните форму заявки на базовый доступ . Убедитесь, что вы выполнили следующие шаги:
- Убедитесь, что у вас уже есть токен разработчика с уровнем доступа к тестовой учетной записи.
- Убедитесь, что контактный адрес электронной почты API в API-центре актуален. Для доступа к API-центру необходимо войти в свой аккаунт менеджера. Вы не сможете завершить процесс подачи заявки без действующего и регулярно проверяемого адреса электронной почты. Убедитесь, что все ваши активные аккаунты Google Рекламы связаны с аккаунтом менеджера с помощью API-токена.
Стандартный доступ
Уровень «Стандартный доступ» позволяет токену разработчика выполнять неограниченное количество операций в день для большинства сервисов. Это включает, помимо прочего, GoogleAdsService Search и SearchStream . Подробнее об ограничениях и исключениях для уровня «Стандартный доступ» см. в разделе «Квоты API» .
Уровень стандартного доступа предоставляется только разработчикам, которым требуются неограниченные операции API Google Ads, например крупным компаниям или инструментам, обслуживающим множество пользователей.
Независимо от уровня доступа, все операции API подчиняются системным ограничениям скорости. Подробнее об обработке ошибок, связанных с ограничением скорости, см. в разделе Типы ошибок .
Как подать заявку на стандартный доступ
Если у вас есть токен разработчика с уровнем базового доступа и вы хотите подать заявку на неограниченные операции API Google Ads, заполните форму заявки на стандартный доступ .
Если ваш инструмент внешний, будьте готовы предоставить доступ для демо-входа. Обратите внимание, что ваш инструмент должен соответствовать минимально необходимым функциональным возможностям .
Допустимое использование
Разрешенное использование распространяется только на токены разработчика с уровнями «Базовый доступ» и «Стандартный доступ». Разрешенное использование определяется предполагаемым использованием API Google Рекламы. Эти разрешения определяют, для каких функций API может использоваться токен разработчика, как указано в следующей таблице:
| Допустимое использование | Описание |
|---|---|
| Создание/управление рекламой | Предоставить доступ ко всем сервисам API для создания и управления кампаниями Google Ads, группами объявлений, объявлениями и ключевыми словами. |
| Отчетность | Выполняйте только запросы GoogleAdsService.Search или GoogleAdsService.SearchStream , либо вызовы только для чтения. Это предназначено для разработчиков, которые используют API только для запроса статистики. |
| Исследование ключевых слов и рекомендаций | Разрешить токену доступ к сервисам ReferenceService, KeywordPlanIdeaService и KeywordPlanService. Это необходимо только инструментам, которым требуются рекомендации для упрощения создания и управления кампаниями Google Рекламы. |
Как изменить допустимое использование
Если ваш токен разработчика одобрен для уровня «Базовый доступ» или «Стандартный доступ», вы можете заполнить заявку на обновление разрешенного использования . Заполните заявку, если хотите обновить разрешенное использование или предоставить клиентам доступ к вашему инструменту.