Токен разработчика — это 22-символьная буквенно-цифровая строка, позволяющая вашему приложению подключаться к API Google Ads. Вы можете получить его, зарегистрировавшись на странице Центра API в своем аккаунте Google Ads Manager. При каждом вызове API вы отправляете токен разработчика в составе запроса, устанавливая заголовок http или gRPC developer-token .
Каждому токену разработчика присваивается уровень доступа , который определяет количество вызовов API, которые вы можете совершать в день с помощью этого токена, а также среду, к которой вы можете обращаться.
При регистрации токена разработчика вам по умолчанию может быть предоставлен уровень доступа Explorer . Это позволяет вам выполнять вызовы к рабочим учетным записям, но с определенными ограничениями. В некоторых случаях, когда мы не можем автоматически проверить вашу заявку на токен разработчика, мы можем вместо этого предоставить вашему токену разработчика уровень доступа Test Account . Это позволит вам выполнять вызовы API только к тестовым учетным записям. Чтобы снять ограничения уровней доступа Explorer и Test Account, вы должны запросить уровень доступа Basic или Standard для вашего токена разработчика. После того, как ваша заявка на токен разработчика будет рассмотрена и одобрена, вашему токену разработчика будет предоставлен соответствующий уровень доступа.
Вам нужен новый токен разработчика?
Решение о том, стоит ли вам регистрироваться для получения нового токена разработчика, зависит от нескольких факторов. Вот несколько распространенных сценариев:
Сценарий | Следующие шаги |
| Ваша компания никогда раньше не использовала API Google Ads, и вы хотите разработать собственные приложения. | Зарегистрируйтесь и получите новый токен разработчика. Узнайте больше. |
| Ваша компания активно использует или использовала API Google Ads в прошлом. | Google обычно предоставляет одной компании один токен разработчика, поэтому, если ваша компания уже использует API Google Ads, вам следует повторно использовать имеющийся токен разработчика. Подробнее. |
| Ваша компания уже использует API Google Ads, но также разрабатывает новый продукт или инструмент. | Если вы уверены, что не можете использовать свой существующий токен разработчика, вы можете подать заявку на новый, объяснив свой сценарий использования в заявке. В остальной части этого руководства вы можете использовать свой существующий токен разработчика. Подробнее |
| Ваша компания использует стороннее приложение. | Токен разработчика необходим только в том случае, если вы разрабатываете собственное приложение. Если вы используете стороннее приложение или сервис, то разработчик этого приложения должен получить токен разработчика для своего приложения. Если вам что-то непонятно, обратитесь в группу по соблюдению требований API . |
Кто может подать заявку на получение токена разработчика?
Как компании, так и отдельные разработчики могут подать заявку на получение токена разработчика. В таблице ниже приведено краткое описание того, какие данные необходимо предоставить при регистрации для получения токена разработчика.
| Если вы | Затем предоставьте следующие данные разработчика. | Дополнительные примечания |
|---|---|---|
| Разработчик, представляющий вашу компанию или продуктовую команду. | Название вашей компании и URL-адрес вашей компании | Google обычно выдает один токен разработчика на компанию, но в каждом конкретном случае одобряет отдельные токены разработчика для разных инструментов. |
| Разработчик-любитель, не представляющий компанию. | Укажите название вашей компании как Individual . Вместо названия компании вы можете указать альтернативные URL-адреса, например, URL-адрес вашего профиля на GitHub или LinkedIn. | Вам необходимо иметь какое-либо присутствие в интернете и предоставить Google URL-адрес, который поможет нам оценить ваши планы по использованию Google Ads API. Общие URL-адреса, такие как test.com и example.com не принимаются. |
Как подать заявку на получение токена разработчика
Процесс получения токена разработчика состоит из двух этапов.
Шаг 1: Выберите или создайте аккаунт Google Ads Manager.
Если у вас уже есть аккаунт Google Ads Manager, выберите его при подаче заявки на получение токена разработчика. Если этот аккаунт менеджера еще не связан с другими вашими аккаунтами, мы рекомендуем разместить его в корневой иерархии аккаунтов, чтобы упростить процесс проверки токена и управление аккаунтами в дальнейшем.
Если у вас нет учетной записи администратора, вы можете создать ее, следуя инструкциям в Справочном центре .
Шаг 2: Подайте заявку на доступ к API Google Ads.
Обратите внимание, что процесс проверки токена разработчика может занять некоторое время. Подробнее .
Перейдите по ссылке https://ads.google.com/aw/apicenter в своем веб-браузере. При необходимости войдите в свою учетную запись Google Ads Manager.
Заполните форму доступа к API и примите Условия использования.
Убедитесь, что предоставленная вами информация верна и URL-адрес веб-сайта вашей компании работает. Если веб-сайт не запущен, Google может не обработать вашу заявку и отклонить её.
Убедитесь, что указанный вами адрес электронной почты для связи по вопросам API регулярно проверяется. Команда Google по соблюдению требований API может связаться с вами по этому адресу электронной почты в процессе проверки для уточнения информации. Если с вами не удастся связаться, Google может отказать в дальнейшем рассмотрении вашей заявки.
Вы можете изменить адрес электронной почты для связи по API в Центре API . Поддерживайте эту информацию в актуальном состоянии даже после завершения процесса подачи заявки, чтобы Google мог отправлять вам важные уведомления о работе сервиса.
После завершения процесса подачи заявки токен разработчика появится в вашем API-центре с одним из следующих результатов:
- Ваш токен разработчика имеет уровень доступа Explorer со статусом «Одобрено» . Это означает, что Google смог автоматически проверить и одобрить вашу заявку на получение токена разработчика для уровня доступа Explorer. Вы можете начать выполнять вызовы API к своему рабочему или тестовому аккаунту .
- Ваш токен разработчика имеет уровень доступа к тестовой учетной записи со статусом «Ожидает одобрения» . Это означает, что Google не смог автоматически проверить и одобрить вашу заявку на получение токена разработчика для уровня доступа Explorer. Вы можете начать выполнять вызовы API к тестовым учетным записям . После завершения этого руководства мы рекомендуем вам ознакомиться с тем, как подать заявку на базовый уровень доступа.
Убедитесь, что вы вошли в аккаунт Google Ads Manager.
Для доступа к токену разработчика необходимо войти в свою учетную запись Google Ads Manager, при этом это не может быть учетная запись Google Ads Test Manager.
Чтобы проверить, вошли ли вы в свой аккаунт Google Ads Manager, выполните следующие действия:
Перейдите по ссылке https://ads.google.com/aw/apicenter в своем веб-браузере.
Если вы вошли в свою учетную запись клиента, на странице отобразится сообщение: «Центр API доступен только для учетных записей менеджеров».
Если в правом верхнем углу красным цветом отображается «Тестовый аккаунт» , значит, ваш аккаунт является либо тестовым менеджером, либо тестовым рекламодателем .
Где найти свой токен разработчика
Если токен разработчика существует, его можно найти на странице Центра API в вашем аккаунте Google Ads Manager.