Токен разработчика — это 22-символьная буквенно-цифровая строка, которая позволяет вашему приложению подключаться к API Google Ads. После того, как Google выдаст вам токен, вы сможете просмотреть его или создать новый на странице API Center вашего управляющего аккаунта Google Ads.
Каждому токену разработчика назначается уровень доступа , который контролирует количество вызовов API, которые вы можете сделать в день с помощью токена, а также среду, к которой вы можете делать вызовы.
Чтобы выполнять вызовы API к вашей рабочей учётной записи, необходимо запросить уровень базового или стандартного доступа для вашего токена разработчика во время подачи заявки на получение токена. Поскольку эти уровни доступа не требуются для выполнения вызовов к тестовым учётным записям, вы можете продолжить выполнение упражнений, но рекомендуем вам ознакомиться с подачей заявки на уровень базового доступа после изучения этого руководства.
Вам нужен новый токен разработчика?
Стоит ли вам регистрировать новый токен разработчика или нет, зависит от нескольких факторов. Вот несколько распространённых сценариев:
Сценарий | Следующие шаги |
| Ваша компания никогда раньше не использовала API Google Ads, и вы хотите разработать собственные приложения. | Зарегистрируйтесь и получите новый токен разработчика. Узнать больше |
| Ваша компания активно использует или использовала API Google Ads в прошлом | Google обычно предоставляет один токен разработчика на компанию, поэтому, если ваша компания уже использует API Google Ads, вам следует повторно использовать существующий токен разработчика. Подробнее |
| Ваша компания уже использует API Google Ads, но также разрабатывает новый продукт или инструмент. | Если вы уверены, что не можете использовать свой текущий токен разработчика, вы можете подать заявку на новый, объяснив свой вариант использования в заявке. Далее в этом руководстве вы можете использовать свой текущий токен разработчика. Подробнее |
| Ваша компания использует стороннее приложение | Токен разработчика нужен только при разработке собственного приложения. Если вы используете стороннее приложение или сервис, разработчику этого приложения необходимо получить токен разработчика. Если у вас возникли вопросы по вашему случаю, обратитесь в службу соответствия API . |
Как подать заявку на получение токена разработчика
Подача заявки на получение токена разработчика состоит из двух этапов.
Шаг 1: Выберите или создайте аккаунт менеджера Google Ads
Если у вас уже есть управляющий аккаунт Google Ads, выберите его при подаче заявки на получение токена. Если этот управляющий аккаунт ещё не связан с другими вашими аккаунтами, рекомендуем разместить его в корне иерархии аккаунтов, чтобы упростить процесс проверки токенов и управление аккаунтами в дальнейшем.
Если у вас нет учетной записи менеджера, вы можете создать ее, следуя инструкциям Справочного центра .
Шаг 2: Подайте заявку на доступ к API Google Ads
Обратите внимание, что процесс проверки токена разработчика может занять некоторое время. Подробнее .
Перейдите по адресу https://ads.google.com/aw/apicenter в веб-браузере. При необходимости войдите в свой аккаунт Google Ads.
Заполните форму доступа к API и примите Условия и положения.
Убедитесь, что ваша информация верна, а URL-адрес веб-сайта вашей компании работает. Если веб-сайт неактивен, Google может не обработать вашу заявку и отклонить её.
Убедитесь, что указанный вами контактный адрес электронной почты API ведет на регулярно просматриваемый почтовый ящик. Команда Google по обеспечению соответствия требованиям API может обратиться на этот адрес электронной почты в процессе рассмотрения заявки для получения разъяснений. Если с вами не получится связаться, Google может отказать в обработке вашей заявки.
Вы можете изменить свой контактный адрес электронной почты для API в Центре API . Поддерживайте эту информацию актуальной даже после подачи заявки, чтобы Google мог отправлять вам важные уведомления об услугах.
После завершения процесса подачи заявки токен разработчика появится в вашем API Center со статусом «Ожидает одобрения» . Теперь вашему токену разработчика присвоен уровень доступа «Тестовый аккаунт» , и вы можете начать выполнять API-вызовы к тестовым аккаунтам .
Получив токен разработчика, запишите его значение, так как оно понадобится вам при выполнении первого вызова API.
Проверьте, вошли ли вы в учетную запись менеджера.
Для доступа к токену разработчика вам необходимо войти в свою учетную запись менеджера. Эта учетная запись не может быть тестовой учетной записью менеджера.
Чтобы проверить, вошли ли вы в учетную запись менеджера, выполните следующие действия:
Перейдите по адресу https://ads.google.com/aw/apicenter в своем веб-браузере.
Если вы вошли в учетную запись клиента, на странице отобразится следующее : API-центр доступен только для учетных записей менеджеров.
Если в правом верхнем углу красным цветом отмечена тестовая учетная запись , ваша учетная запись принадлежит либо тестовому менеджеру, либо тестовому рекламодателю .
Где найти токен разработчика
Токен разработчика, если он существует, можно найти на странице API Center вашего аккаунта менеджера Google Ads.