Токен разработчика – это 22-символьная буквенно-цифровая строка, которая использовалась для подключения вашего приложения к Google Ads API. Поддержка токенов разработчика была прекращена 9 сентября 2026 г.. В этом руководстве описаны изменения и приведены ответы на часто задаваемые вопросы о переходе на новую версию.
Что изменится?
В рамках прекращения поддержки токенов разработчика мы внесли ряд изменений в процесс регистрации в Google Ads API и управления доступом к API. В этом разделе описаны основные изменения.
Уровни доступа к API связаны с проектами Google Cloud
9 сентября 2026 г. мы прекратим поддержку токенов разработчика. Уровень доступа вашего текущего активного токена разработчика был автоматически перенесен в ваши проекты Google Cloud на основе действий с API за 90 дней до прекращения поддержки. Вы можете продолжать передавать токены разработчика в заголовках вызовов API, но это необязательно, и серверы API будут игнорировать их. Существующий код продолжит работать без изменений. Уровни доступа к API определяются проектом Google Cloud, который вы использовали для создания учетных данных OAuth.
- Если ваше приложение использует процедуру аутентификации, то это проект, которому принадлежат идентификатор и секретный код клиента OAuth.
- Если вы используете сервисный аккаунт, это проект, которому принадлежит ваш сервисный аккаунт.
Новый процесс регистрации в Google Ads API
Вы можете запросить доступ к Google Ads API прямо в консоли Google Cloud, не имея управляющего аккаунта Google Рекламы. Не запрашивайте токен разработчика на странице API Center и не пытайтесь получить доступ к API на странице API Center в управляющем аккаунте Google Рекламы, поскольку эти процессы перенесены в консоль Google Cloud и запросы, отправленные со страницы API Center, не будут обработаны.
Новый интерфейс управления доступом через API
Мы отключили все новые функции регистрации и управления доступом к API, такие как подача заявки на доступ к API и управление уровнями доступа к API на странице API Center в управляющих аккаунтах Google Рекламы. Эти функции доступны на обзорной странице Google Ads API в Google Cloud Console.
Вы по-прежнему можете просматривать данные о разработчике на странице Центра API. В будущем поддержка этой страницы будет прекращена.
Новые коды ошибок
В версии 25 Google Ads API при попытке использовать проект Google Cloud с тестовым доступом для вызова производственного аккаунта будет возвращена ошибка AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION. В более ранних версиях API вместо этого будет возникать ошибка AuthorizationError.ACTION_NOT_PERMITTED. Если вы столкнулись с этой ошибкой, перейдите на обзорную страницу Google Ads API для своего облачного проекта Google Cloud и запросите доступ к Explorer.
Для получения базового и стандартного доступа необходимо подтвердить бренд
Для новых заявок на доступ уровня "Базовый" и "Стандартный" необходимо пройти проверку бренда для проекта Google Cloud. Пользователям, у которых уже есть доступ, проходить проверку бренда не обязательно, но рекомендуется.
Заявки на базовый доступ обрабатываются автоматически и проверяются в течение нескольких минут после подтверждения бренда и отправки.
В связи с этими изменениями все заявки на базовый доступ, которые ещё не были рассмотрены, будут закрыты. Заявители, которых коснулись изменения, получат электронное письмо с подробной информацией и должны будут повторно подать заявку на базовый доступ на странице обзора Google Ads API.
Новые адреса электронной почты для связи по вопросам API
В связи с отключением страницы Центра API мы будем использовать список пользователей с правами владельца и редактора в вашем проекте Google Cloud в качестве единственного канала для отправки административных сообщений и уведомлений о соблюдении обязательных требований. Чтобы переход был плавным, мы временно продолжим отправлять обязательные служебные уведомления на адрес электронной почты, указанный в Центре API. Мы будем держать вас в курсе по мере завершения перехода наших каналов связи.
Что делать, если вы уже зарегистрированы как разработчик
Проверьте уровни доступа к API в проекте Google Cloud. Если вы уже являетесь разработчиком, рекомендуем проверить обзорную страницу Google Ads API в проектах Google Cloud и убедиться, что для них задан тот же уровень доступа к API, что и для вашего существующего токена разработчика. Чтобы устранить расхождения, следуйте инструкциям в этом руководстве.
Проверьте контактный адрес электронной почты для связи по вопросам API. Перейдите на страницу IAM (Identity and Access Management) для своего облачного проекта Google Cloud. Убедитесь, что активным разработчикам и менеджерам аккаунтов назначены подходящие роли владельца или редактора в вашем облачном проекте Google Cloud. Мы начнем отправлять на эти адреса обязательные уведомления о сервисе (MSA), чтобы сообщать вам о будущих изменениях в Google Ads API. В течение некоторого времени мы продолжим отправлять соглашения MSA на контактный адрес электронной почты, указанный в Центре API. Мы сообщим вам, когда этот процесс изменится.
Исправьте код приложения. Рекомендуем обновить приложение, чтобы больше не передавать токен разработчика в вызовах API. Мы опубликовали обновленные версии клиентских библиотек, сервера MCP Google Рекламы и Помощника разработчика Google Ads API, которые позволяют выполнять вызовы API без токена разработчика. В одной из будущих основных версий Google Ads API мы начнем отклонять токены разработчика в вызовах API. Если ваше приложение использует эти библиотеки, обновите зависимости приложения до последней версии.
Если вам нужна дополнительная помощь или у вас есть вопросы, обратитесь в службу поддержки Google Ads API.
Известные проблемы
В этом разделе описаны все известные проблемы, связанные с прекращением поддержки токенов разработчика.
Пользователи не получают доступ к исследованию или базовый доступ, даже если они прошли проверку бренда
Нам известно о проблеме, из-за которой некоторые пользователи с проектами, прошедшими проверку бренда, получают отказ при запросе базового доступа. Пользователи получат электронное письмо с отказом, в котором будет указано, что для базового доступа требуется подтвержденный профиль бренда OAuth. Заявка была отклонена, поскольку вы не завершили проверку бренда для своего проекта". Некоторым пользователям, которые регистрируются для получения доступа к Explorer, также приходит отказ по электронной почте с текстом: "В настоящее время мы не можем предоставить доступ к Explorer для вашего облачного проекта Google Cloud, поскольку он не соответствует критериям допуска к прямому доступу к производственному аккаунту в соответствии с правилами и условиями использования Google Ads API".
Основная причина
Ваш облачный проект Google Cloud может быть зарегистрирован в программе бесплатного пробного периода Google Cloud или связан с заблокированным или отключенным платежным аккаунтом.
Как подтвердить личность рекламодателя
Проверьте статус платежей Google Cloud. Если в вашем платежном проекте указано "Бесплатный пробный аккаунт" или он заблокирован или отключен, значит проблема затронула вас.
Статус
Мы выявили основную причину проблемы и работаем над ее устранением.
Временное решение
Эту проблему можно решить несколькими способами. Выберите наиболее подходящий вариант.
Как перейти на платный тарифный план в облачном проекте Google Cloud
Перейдите на платный тарифный план для проекта Google Cloud. Подождите несколько минут и попробуйте запросить базовый доступ ещё раз.
Как отключить оплату для проекта Google Cloud
Если в вашем проекте Google Cloud не запущены другие сервисы, отмените оплату проекта Google Cloud. Подождите несколько минут и попробуйте запросить базовый доступ ещё раз.
Как использовать другой проект Google Cloud
Если у вас есть другой проект Google Cloud, в котором подтвержден бренд, используйте его, чтобы запросить базовый доступ.
Проекты с недавно одобренными уровнями доступа "Базовый" или "Исследователь" получают ошибку AUTHORIZATION_ERROR
Нам известно о проблеме, из-за которой некоторые пользователи, повысившие уровень доступа к проекту Google Cloud до одобренного базового или исследовательского после 9 сентября 2026 г., получают ошибку AUTHORIZATION_ERROR при вызовах Google Ads API к рабочим аккаунтам.
Основная причина
Google Ads API не учитывает повышение уровня доступа к API, выполненное в консоли Google Cloud для некоторых проектов.
Как подтвердить личность рекламодателя
Эта проблема возникает, если выполняются все следующие условия:
- У вас есть токен разработчика с уровнем доступа "Тестирование".
- Вы использовали свой проект Google Cloud и токен разработчика для вызовов Google Ads API до 9 сентября 2026 г.
- Вы повысили уровень доступа к проекту Google Cloud до Explorer, Basic или стандартного доступа после 9 сентября 2026 г.
- Ваши вызовы API к рабочему аккаунту завершаются неудачно с ошибкой
AUTHORIZATION_ERROR. Вызовы API к тестовым аккаунтам выполняются успешно.
Статус
Мы устранили эту проблему и сейчас развертываем исправление на наших серверах. После этого ваши вызовы API снова начнут работать.
Временное решение
Вы можете использовать новый проект Google Cloud, чтобы подать заявку на доступ к Explorer.
Часто задаваемые вопросы
Что произойдет с уровнями доступа к API?
Уровни доступа к API по-прежнему действуют в Google Ads API. Однако они предоставляются проекту консоли Google Cloud, а не токену разработчика. При выполнении вызовов API уровни доступа к API определяются проектом Google Cloud, который вы использовали для создания учетных данных OAuth.
- Если ваше приложение использует процедуру аутентификации, то это проект, которому принадлежат идентификатор и секретный код клиента OAuth.
- Если вы используете сервисный аккаунт, это проект, которому принадлежит ваш сервисный аккаунт.
Как были определены проекты, для которых нужно перенести уровни доступа к API?
Если у вас уже был одобренный токен разработчика до 9 сентября 2026 г., его уровни доступа были перенесены в ваши проекты Google Cloud следующим образом:
- Мы изучили журналы вызовов API за последние 90 дней, чтобы определить, какие проекты Cloud использовались для вызовов API с вашим одобренным токеном разработчика.
- Мы назначили уровни доступа к API токена разработчика всем найденным проектам Cloud.
Можно ли после этого изменения иметь несколько проектов Cloud с разными уровнями доступа?
Да, вы можете создать несколько проектов Google Cloud с разными уровнями доступа к API. Например, у вас может быть один проект Google Cloud с базовым доступом и другой проект Google Cloud со стандартным доступом.
Пример
Предположим, у вас есть четыре токена разработчика и шесть проектов Cloud со следующими данными:
- Токен разработчика 1:
abcdefghijkl1234567890имеет стандартный доступ. Он использовался с идентификаторами проектов:1234567890,5678912345,45678912345. - Токен разработчика 2:
xyzabcdefghi6789012345имеет базовый доступ. Он использовался в проектах с идентификаторами:1231235678. - Токен разработчика 3:
asdfgflkjhjz7654321012имеет базовый доступ, но никогда не использовался для вызова API. Она была одобрена в течение 90 дней до 9 сентября 2026 г. - Токен разработчика 4:
qwertypoiuyu6543298790имел стандартный доступ, но не использовался в течение последних 90 дней. Идентификатор проекта9876564900использовался с этим токеном разработчика более 90 дней назад. - Облачный проект: идентификатор проекта
7171234567никогда не использовался ни с одним из токенов разработчика для вызова API.
Уровни доступа API будут перенесены из токенов разработчика в проекты Google Cloud следующим образом:
| Токен разработчика | Идентификатор проекта | Уровень доступа | Описание |
|---|---|---|---|
abcdefghijkl1234567890 |
1234567890 |
Стандартный доступ | Токен разработчика и идентификатор проекта связаны друг с другом. |
abcdefghijkl1234567890 |
5678912345 |
Стандартный доступ | Токен разработчика и идентификатор проекта связаны друг с другом. |
abcdefghijkl1234567890 |
45678912345 |
Стандартный доступ | Токен разработчика и идентификатор проекта связаны друг с другом. |
xyzabcdefghi6789012345 |
1231235678 |
Стандартный доступ | Токен разработчика и идентификатор проекта связаны друг с другом. |
asdfgflkjhjz7654321012 |
-- |
-- |
Доступ к API для токена разработчика не был перенесен ни в один проект, поскольку он никогда не использовался для вызова API. |
qwertypoiuyu6543298790 |
9876564900 |
Проверка доступа | Доступ к API для токена разработчика был отозван из-за отсутствия активности в течение 90 дней. По умолчанию для проекта задан уровень доступа к API "Тестовый доступ". |
-- |
7171234567 |
Проверка доступа | Это новый проект, который не использовался ни с одним токеном разработчика. По умолчанию для проекта задан уровень доступа к API "Тестовый доступ". |
У меня несколько одобренных токенов разработчика. В какой проект вы перенесете уровни доступа к API?
Уровни доступа каждого одобренного токена разработчика будут перенесены в проекты Google Cloud, связанные с этим токеном. Пример
Я использую несколько проектов Google Cloud. В какой проект вы перенесете уровни доступа к API?
Если за последние 90 дней вы использовали несколько проектов Google Cloud с одобренным токеном разработчика, то все эти проекты получат те же уровни доступа к API, что и ваш токен разработчика. Пример
Уровни доступа к API были назначены проекту, который я больше не использую. "Google Новости для издателей"
Если доступ к Google Ads API назначен проекту Google Cloud, который вы больше не используете, никаких дополнительных действий с вашей стороны не требуется. Google отзовет доступ к API для неиспользуемого проекта через 90 дней бездействия.
Уровни доступа к API не были назначены моему облачному проекту Google Cloud. "Google Новости для издателей"
Уровень доступа вашего токена разработчика не был перенесен в проект Google Cloud, скорее всего, потому что вы никогда не использовали токен разработчика и проект Cloud для вызова API или срок действия доступа к API вашего токена разработчика истек из-за неактивности. Чтобы устранить проблему, запросите для проекта подходящий уровень доступа к API на обзорной странице Google Ads API. Пример
Где посмотреть уровни доступа к API для проекта?
Уровень доступа к API для проекта Google Cloud можно посмотреть на обзорной странице Google Ads API.
Как запросить более высокий уровень доступа к API?
Вы можете запросить более высокий уровень доступа к API для своего проекта Google Cloud на обзорной странице Google Ads API.
Что произойдет с моей заявкой на доступ к API?
Все заявки на базовый доступ, отправленные из Центра API управляющего аккаунта Google Рекламы до 9 сентября 2026 г., будут закрыты. Вам нужно повторно запросить базовый доступ на обзорной странице Google Ads API в проекте Google Cloud. Если это изменение затронет вас, вы получите электронное письмо с необходимыми инструкциями.
Все заявки на стандартный доступ, отправленные из Центра API управляющего аккаунта Google Рекламы до 9 сентября 2026 г., будут рассмотрены в обычном порядке. Если запрос будет одобрен, облачному проекту Google Cloud, связанному с вашим токеном разработчика, будет предоставлен стандартный доступ.
Можно ли связать одобренный токен разработчика с новым облачным проектом Google Cloud?
До 9 сентября 2026 г. команда Google Ads API поддерживала перенос токена разработчика в новый облачный проект Google Cloud в каждом отдельном случае. С 9 сентября 2026 г. эта функция больше не поддерживается, так как мы прекратили поддержку токенов разработчика. Если вам нужно использовать новый проект Google Cloud, запросите доступ к API на обзорной странице Google Ads API в этом проекте.
У меня есть одобренный токен разработчика, но я его не использовал. Можно ли использовать этот токен разработчика?
Нет, вы не можете использовать этот токен разработчика. Возможны два варианта:
Доступ к токену разработчика может быть отозван из-за неактивности. Согласно правилам Google, Google может отозвать ваш токен API, если он не использовался в течение 90 дней подряд. Если вы давно не использовали токен разработчика, скорее всего, его уровни доступа были отозваны из-за неактивности. В этом случае подайте новую заявку на доступ к API для своего проекта Google Cloud на обзорной странице Google Ads API. Пример
Ваш токен разработчика был одобрен в течение 90 дней до 9 сентября 2026 г., но вы его не использовали. Поскольку вы не использовали одобренный токен разработчика с проектом Google Cloud до 9 сентября 2026 г., уровни доступа не были перенесены в облачный проект. В результате вы больше не сможете использовать токен разработчика. Если вы попытаетесь выполнить вызов API для рабочего аккаунта с этим токеном разработчика, мы вызовем исключение
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION. Чтобы устранить ошибку, запросите доступ к нужному API на обзорной странице Google Ads API в проекте Google Cloud. Пример
В обоих случаях вы можете подать заявку на доступ к Explorer и Basic и получить автоматическую проверку. Вам больше не нужно обращаться в команду Google по соблюдению нормативных требований, чтобы завершить процесс проверки. Если вам нужен стандартный доступ, потребуется проверка вручную. Однако при запросе стандартного доступа вы можете указать данные одобренного токена разработчика, чтобы команда по соблюдению требований могла рассмотреть вашу заявку.
Можно ли прекратить отправлять токены разработчика в запросах к API?
Да, вы можете перестать отправлять токены разработчика в запросах к API. Если вы используете клиентскую библиотеку, возможно, вам потребуется обновить ее до последней версии. Чтобы узнать, поддерживает ли библиотека вызовы API без указания токена разработчика, проверьте ее журнал изменений.
Я участвовал в пилотной программе по управлению уровнем доступа в облаке. Как это повлияет на меня?
Пилотная программа по управлению уровнями доступа в облаке была создана для того, чтобы разработчики Google Cloud могли выполнять вызовы API без отправки токена разработчика в составе запроса к API. Поскольку мы прекратили поддержку токенов разработчика, эта программа также будет закрыта.
Уровни доступа вашего активного токена разработчика были перенесены в ваш облачный проект Google Cloud, поэтому существующий код должен продолжать работать без изменений. Если вам нужно использовать новый облачный проект Google Cloud, запросите доступ к API на обзорной странице Google Ads API в этом проекте.
Мой токен разработчика был в белом списке. Как это повлияет на меня?
Google может проводить пилотные программы, в рамках которых некоторые разработчики получают доступ к экспериментальным функциям. Доступ к этим функциям иногда предоставляется путем добавления вашего токена разработчика в белый список. Если вы участвовали в таком пилотном проекте, то никаких действий с вашей стороны не требуется.
Мы обновили все пилотные программы, чтобы в качестве механизма добавления в белый список использовались проекты Google Cloud, а не токены разработчика. Статус белого списка токена разработчика был перенесен в связанные проекты Google Cloud. Существующий код продолжит работать без изменений. Если проблема не исчезнет, обратитесь к менеджеру Google по работе с клиентами, который зарегистрировал вас в пилотной программе.
У меня есть одобренный токен разработчика, и я хочу использовать его с новым проектом Google Cloud. Разрешено ли это?
Нет, вы не можете использовать новый проект Google Cloud с одобренным токеном разработчика. Поскольку вы никогда не использовали одобренный токен разработчика с новым проектом Google Cloud до 9 сентября 2026 г., его уровни доступа не были перенесены в облачный проект. Если вы попытаетесь выполнить вызов API с этим токеном разработчика, мы вернем ошибку CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION, поскольку токены разработчика больше не используются для определения уровней доступа к API. Чтобы устранить ошибку, запросите доступ к нужному API на обзорной странице Google Ads API в проекте Google Cloud. Пример
Мой токен разработчика был раскрыт. Нужно ли сбросить токен разработчика?
Нет, в этом случае сбрасывать токен разработчика не нужно. Поскольку мы перенесли уровни доступа к API вашего токена разработчика в ваш проект Google Cloud, неавторизованный пользователь больше не сможет использовать ваш токен разработчика со своим проектом Google Cloud.
Что произойдет с Центром API?
Существующая страница "Центр API" в управляющем аккаунте Google Рекламы больше не поддерживается и будет удалена в ближайшее время. Если у вас уже есть токен разработчика, вы можете войти в управляющий аккаунт Google Рекламы и посмотреть его данные. Однако эти данные предоставляются только для справки. Не выполняйте на этой странице никаких действий, связанных с уровнями доступа к токену разработчика, например не запрашивайте более высокий уровень доступа к API.
Если вам нужно запросить более высокий уровень доступа к API, сделайте это на обзорной странице Google Ads API в проекте Google Cloud.
Нужен ли управляющий аккаунт Google Рекламы для использования Google Ads API?
Для использования Google Ads API больше не требуется управляющий аккаунт Google Рекламы. Управляющий аккаунт нужен только в том случае, если вам необходимо связать несколько аккаунтов и управлять ими с помощью API.
Я новый разработчик. Как зарегистрироваться в Google Ads API?
Чтобы зарегистрироваться в Google Ads API, следуйте инструкциям в руководстве по началу работы. Не запрашивайте токен разработчика в Центре API управляющего аккаунта Google Рекламы. Такие заявки не будут обработаны. В ближайшем будущем мы прекратим поддержку Центра API.
Какие разрешения IAM необходимы для управления уровнями доступа к API?
Чтобы управлять уровнями доступа к Google Ads API, вам нужны разрешения на управление квотами для проекта Google Cloud. Необходимые разрешения по умолчанию включены в следующие роли: "Владелец", "Редактор", "Администратор квот" и "Администратор Service Usage". Дополнительную информацию можно найти в документации о разрешениях на квоты.
Чтобы посмотреть назначенные вам роли, перейдите на страницу IAM в облачном проекте Google Cloud. Обратитесь к администратору проекта Google Cloud и попросите предоставить необходимые роли IAM для вашего проекта Google Cloud.