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