Токен разработчика – это буквенно-цифровая строка из 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 на странице Центра API в управляющем аккаунте Google Рекламы. Эти процессы перенесены в консоль Google Cloud, и запросы, отправленные со страницы Центра API, не будут обработаны.
Новый интерфейс управления доступом к API
Мы отключили все новые функции регистрации и управления доступом к API, такие как подача заявки на доступ к API и управление уровнями доступа к API на странице API Center в управляющих аккаунтах Google Рекламы. Эти функции доступны на обзорной странице Google Ads API в Google Cloud Console.
Вы по-прежнему можете перейти на страницу Центра API, чтобы посмотреть данные разработчика. В будущем поддержка этой страницы будет прекращена.
Новые коды ошибок
В версии 25 и более поздних Google Ads API выдает ошибку AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION, если вы пытаетесь использовать облачный проект Google Cloud с тестовым доступом для вызовов в рабочий аккаунт. В более ранних версиях API (v24 и ниже) вместо этого возникает ошибка AuthorizationError.ACTION_NOT_PERMITTED. Если вы столкнулись с этой ошибкой, перейдите на обзорную страницу Google Ads API для своего облачного проекта Google Cloud и подайте заявку на доступ к API 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. На эти адреса мы будем отправлять обязательные уведомления о будущих изменениях в Google Ads API. В течение некоторого времени мы продолжим отправлять соглашения MSA на контактный адрес электронной почты, указанный в Центре API. Мы сообщим вам, когда этот процесс изменится.
Исправьте код приложения. Рекомендуем обновить приложение, чтобы больше не передавать токен разработчика в вызовах API. Мы опубликовали обновленные версии клиентских библиотек, сервера MCP Google Рекламы и Помощника разработчика Google Ads API, которые позволяют выполнять вызовы API без токена разработчика. В одной из будущих основных версий Google Ads API мы начнем отклонять токены разработчика в вызовах API. Если в вашем приложении используются эти библиотеки, обновите зависимости приложения, чтобы использовать последнюю версию.
Если у вас есть вопросы или вам нужна помощь, обратитесь в службу поддержки Google Ads API.
Известные проблемы
В этом разделе описаны все известные проблемы, связанные с прекращением поддержки токенов разработчика.
Пользователи не получают доступ уровня Explorer или Basic даже после подтверждения бренда.
Нам известно, что некоторые пользователи с подтвержденными проектами брендов получают отказ при подаче заявки на базовый доступ. Пользователи получат электронное письмо с отказом, в котором будет указано, что для базового доступа требуется подтвержденный профиль бренда OAuth. Заявка была отклонена, поскольку вы не завершили проверку бренда для своего проекта". Некоторым пользователям, которые регистрируются для получения доступа к Explorer, также приходит отказ по электронной почте с текстом: "В настоящее время мы не можем предоставить доступ к Explorer для вашего облачного проекта Google Cloud, поскольку он не соответствует критериям допуска к прямому доступу к производственному аккаунту в соответствии с правилами и условиями использования Google Ads API".
Основная причина
Ваш облачный проект Google Cloud может быть зарегистрирован в программе бесплатного пробного периода Google Cloud или связан с заблокированным или отключенным платежным аккаунтом.
Как подтвердить личность рекламодателя
Проверьте статус Cloud Billing в Google Cloud. Если в вашем платежном проекте указано "Бесплатный пробный аккаунт" или он заблокирован или отключен, значит проблема затронула вас.
Статус
Мы выявили основную причину проблемы и работаем над ее устранением.
Временное решение
Есть несколько способов решить эту проблему. Выберите наиболее подходящий вариант.
Как перейти на платную версию проекта Google Cloud
Переведите проект Google Cloud на платный уровень. Подождите несколько минут и повторите попытку.
Как отключить платежный аккаунт для проекта Google Cloud
Если в вашем проекте Google Cloud не запущены другие сервисы, отключите платежный аккаунт для проекта Google Cloud. Подождите несколько минут и попробуйте запросить базовый доступ ещё раз.
Как использовать другой проект Google Cloud
Если у вас есть другой проект Google Cloud, в котором бренд подтвержден, используйте его, чтобы подать заявку на базовый доступ.
Проекты с недавно одобренными уровнями доступа "Базовый" или "Исследователь" получают ошибку AUTHORIZATION_ERROR
Нам известно о проблеме, из-за которой некоторые пользователи, повысившие уровень доступа к проекту Google Cloud до одобренного базового или Explorer после 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?
Уровни доступа к API по-прежнему применяются в Google Ads API. Однако они предоставляются вашему проекту в консоли Google Cloud, а не токену разработчика. Когда вы выполняете вызовы API, уровни доступа к API определяются проектом Google Cloud, который вы использовали для создания учетных данных OAuth.
- Если в вашем приложении используется процесс аутентификации пользователей, то это проект, которому принадлежат идентификатор клиента OAuth и секретный код.
- Если вы используете рабочий процесс сервисного аккаунта, то это проект, которому принадлежит ваш сервисный аккаунт.
Как были определены проекты, для которых нужно перенести уровни доступа к API?
Если у вас уже был одобренный токен разработчика до 9 сентября 2026 г., его уровни доступа были перенесены в ваши облачные проекты Google Cloud следующим образом:
- Мы изучили журналы вызовов API за последние 90 дней, чтобы определить, какие проекты Cloud использовались для вызовов API с вашим одобренным токеном разработчика.
- Мы назначили уровни доступа к API токена разработчика всем выявленным облачным проектам.
Можно ли после этого изменения иметь несколько облачных проектов с разными уровнями доступа?
Да, у вас может быть несколько проектов Google Cloud с разными уровнями доступа к API. Например, у вас может быть один проект 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 не унаследовал уровень доступа токена разработчика. Вероятно, вы никогда не использовали токен разработчика и облачный проект для вызова 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 без указания токена разработчика, проверьте ее журнал изменений.
Я участвовал в пилотной программе по управлению уровнями доступа в Cloud. Как это повлияет на меня?
Пилотная программа управляемого доступа Cloud была запущена, чтобы разработчики 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 года, его уровни доступа не были перенесены в облачный проект. Если вы попытаетесь выполнить вызов 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 Center.
Какие разрешения IAM необходимы для управления уровнями доступа к API?
Чтобы управлять уровнями доступа к Google Ads API, вам нужны разрешения на управление квотами для проекта Google Cloud. Необходимые разрешения по умолчанию включены в следующие роли: "Владелец", "Редактор", "Администратор квот" и "Администратор Service Usage". Дополнительную информацию можно найти в документации по разрешениям на квоты.
Проверить назначенные роли можно на странице IAM в облачном проекте Google Cloud. Попросите администратора проекта Google Cloud предоставить необходимые роли IAM для вашего проекта Google Cloud.