Токен разработчика — это 22-символьная буквенно-цифровая строка, которая использовалась для подключения вашего приложения к API Google Ads. Использование токенов разработчика было прекращено 9 сентября 2026 года . В этом руководстве кратко изложены изменения и приведены часто задаваемые вопросы об этой миграции, чтобы помочь существующим разработчикам.
Что меняется?
В рамках прекращения поддержки токенов разработчиков мы внесли ряд изменений в процесс подключения к API Google Ads и управление доступом к API. В этом разделе освещены ключевые изменения.
Уровни доступа к API связаны с проектами Google Cloud.
9 сентября 2026 года мы прекращаем поддержку токенов разработчиков. Ваш текущий и активный уровень доступа к токенам разработчиков был автоматически перенесен в ваши проекты Google Cloud на основе недавней активности API. Вы можете продолжать отправлять токены разработчиков в заголовках вызовов API, но это необязательно и игнорируется серверами API. Ваш существующий код продолжит работать без каких-либо изменений. Ваши уровни доступа к API теперь определяются проектом Google Cloud, который вы использовали для генерации учетных данных OAuth.
- Если ваше приложение использует процесс аутентификации пользователя , то именно этому проекту принадлежат идентификатор и секрет клиента OAuth.
- Если вы используете рабочий процесс с учетной записью службы , то именно этот проект является владельцем вашей учетной записи службы.
Новый интерфейс регистрации для Google Ads API.
Теперь вы можете зарегистрироваться для доступа к API Google Ads непосредственно в консоли Google Cloud без необходимости создания учетной записи Google Ads Manager. Не регистрируйтесь для получения токена разработчика на странице API Center и не пытайтесь подать заявку на доступ к API со страницы API Center в своей учетной записи Google Ads Manager, поскольку эти процессы были перенесены в консоль Google Cloud и не будут обрабатываться, если их инициировать со страницы API Center.
Новый интерфейс управления доступом к API.
Мы убрали все новые функции регистрации и управления доступом к API, такие как подача заявки на доступ к API и управление уровнями доступа к API на странице Центра API в аккаунтах Google Ads Manager. Теперь эти функции доступны на странице Обзора API Google Ads в консоли Google Cloud.
Вы по-прежнему можете получить доступ к странице Центра API , чтобы просмотреть свои исторические данные разработчика. Эта страница будет полностью закрыта в будущем.
Новые коды ошибок
В версии v25 API Google Ads при попытке использовать проект Google Cloud с тестовым доступом для выполнения вызовов к рабочему аккаунту будет выдаваться ошибка CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION . Более старые версии API будут выдавать ошибку ACTION_NOT_PERMITTED . Если вы столкнулись с этой ошибкой, перейдите на страницу обзора API Google Ads для вашего проекта Google Cloud и запросите доступ к Explorer .
Для базового и стандартного доступа требуется подтверждение бренда.
Для новых заявок на базовый и стандартный доступ необходимо пройти проверку на соответствие фирменному стилю вашего проекта Google Cloud. Для существующих пользователей проверка фирменного стиля не требуется, хотя и рекомендуется.
Теперь обработка базовых заявок на доступ автоматизирована и занимает всего несколько минут после подтверждения бренда и отправки.
В связи с этими изменениями в процессе обработки заявок все ожидающие рассмотрения заявки на базовый доступ будут закрыты в рамках этого перехода. Заявители, которых это коснется, получат электронное письмо с подробной информацией и должны будут повторно подать заявку на базовый доступ на странице обзора API Google Ads .
Новый API для отправки контактных адресов электронной почты
В связи с подготовкой к закрытию страницы API Center , мы переходим на использование списка пользователей-владельцев и редакторов вашего проекта Google Cloud в качестве единственного канала для административных сообщений и сообщений о соблюдении обязательных требований. Для обеспечения плавного перехода мы временно продолжим отправлять обязательные уведомления об услугах (MSA) на адрес электронной почты, указанный в вашем API Center. Мы будем держать вас в курсе по мере завершения перехода на новые каналы связи.
Что делать, если вы уже являетесь разработчиком?
Проверьте уровни доступа к API вашего проекта Google Cloud: Если вы являетесь действующим разработчиком, мы настоятельно рекомендуем вам проверить страницу обзора API Google Ads в ваших проектах Google Cloud, чтобы убедиться, что у них тот же уровень доступа к API, что и у вашего существующего токена разработчика. Следуйте инструкциям в этом руководстве, чтобы устранить любые обнаруженные несоответствия.
Проверьте свой адрес электронной почты для связи по API: посетите страницу IAM (управление идентификацией и доступом) для вашего проекта Google Cloud. Убедитесь, что вашим активным разработчикам и менеджерам аккаунтов Google Ads назначены соответствующие роли владельца или редактора в вашем проекте Google Cloud. Мы начнем отправлять обязательные служебные уведомления (MSA) на эти адреса электронной почты, чтобы уведомлять вас о любых будущих изменениях в API Google Ads. Мы продолжим отправлять MSA на адрес электронной почты, указанный в вашем Центре API , в течение временного периода и будем информировать вас о каждом обновлении этого процесса.
Исправьте код вашего приложения: мы рекомендуем обновить ваше приложение, чтобы оно перестало отправлять токены разработчика в составе вызовов API. Мы опубликовали обновленные версии клиентских библиотек , сервера Google Ads MCP и помощника разработчика Google Ads API , которые позволяют выполнять вызовы API без установки токена разработчика. В одной из будущих основных версий Google Ads API мы начнем отклонять токены разработчика в вызовах API. Если ваше приложение использует эти библиотеки, обновите зависимости приложения, чтобы использовать последнюю версию.
Если вам нужна дополнительная помощь или у вас возникли дополнительные вопросы, обратитесь в службу поддержки Google Ads API .
Часто задаваемые вопросы
Что происходит с уровнями доступа к API?
В Google Ads API по-прежнему действуют уровни доступа к API . Однако теперь они предоставляются вашему проекту в Google Cloud Console, а не вашему токену разработчика. При выполнении вызовов API уровни доступа к API теперь определяются проектом Google Cloud, который вы использовали для генерации учетных данных OAuth.
- Если ваше приложение использует процесс аутентификации пользователя , то именно этому проекту принадлежат идентификатор и секрет клиента OAuth.
- Если вы используете рабочий процесс с учетной записью службы , то именно этот проект является владельцем вашей учетной записи службы.
Как определялись проекты для передачи уровней доступа к API?
Если у вас уже был утвержденный токен разработчика до 9 сентября 2026 года, его уровни доступа были перенесены в ваши проекты Google Cloud следующим образом:
- Мы изучили журналы вызовов API за последние 90 дней, чтобы определить, какие облачные проекты использовались для выполнения вызовов API с использованием вашего утвержденного токена разработчика.
- Мы присвоили всем идентифицированным облачным проектам уровни доступа к API, указанные в токене разработчика.
«Смогу ли я после этого изменения иметь несколько облачных проектов с различными уровнями доступа?»
Да, вы можете иметь несколько проектов Google Cloud с разными уровнями доступа к API. Например, у вас может быть один проект Google Cloud с базовым доступом и другой проект Google Cloud со стандартным доступом.
Пример
В качестве примера предположим, что у вас есть 4 токена разработчика и 6 облачных проектов со следующими характеристиками:
- Токен разработчика 1:
abcdefghijkl1234567890имеет стандартный доступ. Он использовался с идентификаторами проектов:1234567890,5678912345,45678912345. - Токен разработчика 2:
xyzabcdefghi6789012345имеет базовый доступ. Он использовался с идентификаторами проекта:1231235678. - Токен разработчика 3:
asdfgflkjhjz7654321012имеет базовый доступ, но никогда не использовался для вызова API. Он был недавно одобрен. - Токен разработчика 4:
qwertypoiuyu6543298790имел стандартный доступ, но не использовался в течение последних 90 дней. В прошлом с этим токеном разработчика использовался идентификатор проекта9876564900. - Облачный проект: Идентификатор облачного проекта:
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?
Если вы использовали несколько проектов Google Cloud с вашим утвержденным токеном разработчика в течение последних 90 дней, то все эти проекты получат одинаковый уровень доступа к API, соответствующий вашему токену разработчика. См. пример .
Уровни доступа к API были назначены проекту, который я больше не использую. Как мне исправить эту проблему?
Если доступ к API Google Ads предоставлен проекту Google Cloud, который вы больше не используете, никаких дополнительных действий с вашей стороны не требуется. Google отзовет доступ к API для неиспользуемого проекта через 90 дней бездействия.
В моём проекте Google Cloud не были назначены уровни доступа к API. Как исправить эту проблему?
Ваш проект Google Cloud не унаследовал уровень доступа, предоставленный вашим токеном разработчика, вероятно, потому что вы никогда не использовали свой токен разработчика и проект Cloud для выполнения вызовов API, или же срок действия доступа к API, предоставленного вашим токеном разработчика, недавно истек из-за неактивности. Чтобы исправить проблему, запросите соответствующий уровень доступа к API для этого проекта на странице обзора API Google Ads . См. пример .
Где я могу посмотреть уровни доступа к API моего проекта?
Уровень доступа к API вашего проекта Google Cloud можно посмотреть на странице обзора API Google Ads .
Как мне подать заявку на получение более высокого уровня доступа к API?
Вы можете подать заявку на повышение уровня доступа к API для своего проекта в Google Cloud на странице обзора API Google Ads .
Что произойдет с моей заявкой на доступ к API, ожидающей рассмотрения?
Все ожидающие рассмотрения заявки на базовый доступ, инициированные вами через Центр API вашего аккаунта Google Ads Manager до 9 сентября 2026 года, будут закрыты. Вам следует повторно подать заявку на базовый доступ на странице обзора API Google Ads вашего проекта Google Cloud. Если вас затронуло это изменение, вы получите электронное письмо с необходимыми инструкциями.
Все заявки на стандартный доступ, поданные вами через Центр API вашего аккаунта Google Ads Manager по состоянию на 9 сентября 2026 года, будут рассмотрены в обычном порядке. В случае одобрения проекту Google Cloud, связанному с вашим токеном разработчика, будет предоставлен стандартный доступ.
Могу ли я повторно связать свой одобренный токен разработчика с новым проектом Google Cloud?
Ранее команда Google Ads API поддерживала перепривязку токена разработчика к новому проекту Google Cloud в каждом конкретном случае. С 9 сентября 2026 года эта функция больше не поддерживается, поскольку токены разработчиков устарели. Если вам необходимо использовать новый проект Google Cloud, вам следует подать заявку на соответствующий доступ к API на странице обзора Google Ads API вашего проекта Google Cloud.
У меня есть одобренный токен разработчика, но я им никогда не пользовался. Могу ли я использовать этот токен разработчика?
Нет, вы не можете использовать этот токен разработчика. Есть два варианта:
Доступ к вашему токену разработчика может быть отозван из-за неактивности: согласно политике Google , Google может отозвать ваш API-токен, если он не используется непрерывно в течение 90 дней. Если вы давно не использовали свой токен разработчика, вероятно, его доступ был отозван из-за неактивности. В этом случае повторно подайте заявку на доступ к API для вашего проекта Google Cloud на странице обзора Google Ads API . См. пример .
Ваш токен разработчика был недавно одобрен, но вы не использовали его до 9 сентября 2026 года: поскольку вы не использовали свой одобренный токен разработчика в проекте Google Cloud до 9 сентября 2026 года, его уровни доступа не были перенесены в проект Cloud. В результате вы больше не можете использовать свой токен разработчика. Мы выдадим ошибку
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION, если вы попытаетесь выполнить вызов API к рабочему аккаунту с этим токеном разработчика. Чтобы исправить ошибку, запросите соответствующий доступ к API на странице обзора Google Ads API вашего проекта Google Cloud. См. пример .
В обоих случаях вы можете подать заявку на доступ к Explorer и на базовый уровень доступа, и они будут рассмотрены автоматически; вам больше не нужно будет взаимодействовать с командой Google по вопросам соответствия требованиям для завершения процесса проверки. Если вам нужен стандартный доступ, потребуется ручная проверка. Однако вы можете указать данные своего утвержденного токена разработчика при подаче заявки на стандартный доступ, чтобы команда по вопросам соответствия требованиям могла соответствующим образом проверить вашу новую заявку на стандартный доступ.
Могу ли я прекратить отправку токенов разработчика в рамках запросов к API?
Да, вы можете прекратить отправку токенов разработчика в рамках запросов к API. Если вы используете клиентскую библиотеку, вам может потребоваться обновить её до последней версии. Проверьте журнал изменений библиотеки, чтобы убедиться, поддерживает ли она вызовы API без указания токена разработчика.
Я участвовал в пилотной программе по внедрению управляемого доступа к облачным сервисам. Как это на меня повлияет?
Пилотная программа управляемого доступа к облаку была запущена для того, чтобы разработчики Google Cloud могли совершать вызовы API без отправки токена разработчика в составе запроса API. Теперь, когда токены разработчика устарели, эта программа будет прекращена.
Уровни доступа вашего активного токена разработчика были перенесены в ваш проект Google Cloud, поэтому ваш существующий код должен продолжать работать без каких-либо изменений. Если вам необходимо использовать новый проект Google Cloud, вам следует подать заявку на доступ к API на странице обзора Google Ads API вашего проекта Google Cloud.
Мой токен разработчика был включен в список разрешенных. Как это повлияет на меня?
Компания Google может запускать пилотные программы, предоставляющие некоторым разработчикам доступ к экспериментальным функциям. Доступ к этим функциям иногда предоставляется путем добавления вашего токена разработчика в список разрешенных пользователей. Если вы участвовали в такой пилотной программе, то никаких действий с вашей стороны не требуется.
Мы обновили все пилотные программы, переведя их на использование проектов Google Cloud вместо токенов разработчиков в качестве механизма разрешения доступа, и перенесли статус разрешения доступа для токенов разработчиков в соответствующие проекты Google Cloud. Ваш существующий код должен продолжать работать без каких-либо изменений. Если проблемы сохраняются, обратитесь к своему менеджеру аккаунта Google, который зарегистрировал вас в пилотной программе.
У меня есть одобренный токен разработчика, и я хочу использовать его в новом проекте Google Cloud. Разрешено ли это?
Нет, вы не можете использовать свой утвержденный токен разработчика в новом проекте Google Cloud. Поскольку вы никогда не использовали свой утвержденный токен разработчика в новом проекте Google Cloud до 9 сентября 2026 года, его уровни доступа не были перенесены в проект Cloud. Мы выдадим ошибку CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION если вы попытаетесь выполнить вызов API с этим токеном разработчика, поскольку токены разработчика больше не используются для определения уровней доступа к API. Чтобы исправить ошибку, запросите соответствующий доступ к API на странице обзора Google Ads API вашего проекта Google Cloud. См. пример .
Мой токен разработчика был скомпрометирован. Нужно ли мне сбросить свой токен разработчика?
Нет, в данном случае вам не нужно сбрасывать токен разработчика. Поскольку мы перенесли уровни доступа к API вашего токена разработчика в ваш проект Google Cloud, неавторизованный пользователь больше не сможет использовать ваш токен разработчика в своем собственном проекте Google Cloud.
Что произойдет с API Center?
Существующая страница Центра API в аккаунте Google Ads Manager устарела и будет удалена в ближайшем будущем. Если у вас уже есть токен разработчика, вы все еще можете войти в свой аккаунт Google Ads Manager и просмотреть подробную информацию. Однако эта информация предоставлена только для ознакомления. Не выполняйте никаких действий, связанных с уровнями доступа к токену разработчика, например, не подавайте заявки на более высокие уровни доступа к API, используя эту страницу.
Если вам необходимо запросить более высокий уровень доступа к API, сделайте это на странице обзора Google Ads API вашего проекта в Google Cloud.
Нужен ли мне по-прежнему аккаунт Google Ads Manager для использования API Google Ads?
Для использования API Google Ads вам больше не нужна учетная запись менеджера Google Ads. Учетная запись менеджера необходима только в том случае, если вам нужно связать и управлять несколькими учетными записями с помощью API.
Я начинающий разработчик. Как мне зарегистрироваться в Google Ads API?
Следуйте инструкциям в руководстве по началу работы , чтобы зарегистрироваться в Google Ads API. Не регистрируйте токен разработчика в Центре API вашего аккаунта Google Ads Manager; эти заявки обрабатываться не будут. Центр API будет закрыт в ближайшем будущем.