Токен разработчика — это 22-символьная буквенно-цифровая строка, позволяющая вашему приложению подключаться к API Google Ads. Вы можете получить токен, зарегистрировавшись на странице Центра API вашего аккаунта Google Ads. При каждом вызове API вы отправляете токен разработчика в составе запроса, устанавливая заголовок http или gRPC developer-token .
Каждому токену разработчика назначается уровень доступа , который определяет количество вызовов API, которые вы можете совершать в день с помощью токена, а также среду, к которой вы можете совершать вызовы. При регистрации токена разработчика ему по умолчанию предоставляется уровень тестового доступа . Это позволяет выполнять вызовы 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-вызовы к тестовым аккаунтам .
Проверьте, вошли ли вы в учетную запись менеджера.
Для доступа к токену разработчика вам необходимо войти в свою учетную запись менеджера. Эта учетная запись не может быть тестовой учетной записью менеджера.
Чтобы проверить, вошли ли вы в учетную запись менеджера, выполните следующие действия:
Перейдите по адресу https://ads.google.com/aw/apicenter в своем веб-браузере.
Если вы вошли в учетную запись клиента, на странице отобразится следующее: API-центр доступен только для учетных записей менеджеров.
Если в правом верхнем углу красным цветом отмечена тестовая учетная запись , ваша учетная запись принадлежит либо тестовому менеджеру, либо тестовому рекламодателю .
Где найти токен разработчика
Токен разработчика, если он существует, можно найти на странице API Center вашего аккаунта менеджера Google Ads.