Токен разработчика – это буквенно-цифровая строка из 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 в управляющих аккаунтах Google Рекламы. Эти функции доступны на обзорной странице Google Ads API в консоли Google Cloud.
Вы по-прежнему можете перейти на страницу Центра API, чтобы посмотреть данные разработчика. В будущем поддержка этой страницы будет прекращена.
Новые коды ошибок
В версии 25 и более поздних Google Ads API выдает ошибку AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION, если вы пытаетесь использовать облачный проект Google Cloud с тестовым доступом для вызовов в рабочем аккаунте. В более ранних версиях API (24 и более ранних) вместо этого возникает ошибка 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 Рекламы назначены подходящие роли владельца или редактора в облачном проекте 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 до одобренного базового или исследовательского после 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 токена разработчика всем найденным проектам Cloud.
Можно ли после этого изменения иметь несколько облачных проектов с разными уровнями доступа?
Да, у вас может быть несколько проектов Google Cloud с разными уровнями доступа к API. Например, у вас может быть один проект Google 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 Cloud.
У меня есть одобренный токен разработчика, но я им не пользовался. Можно ли использовать этот токен разработчика?
Нет, вы не можете использовать этот токен разработчика. Возможны два варианта:
Ваш токен разработчика может быть отозван из-за неактивности. Согласно правилам 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.
Какие разрешения IAM необходимы для управления уровнями доступа к API?
Чтобы управлять уровнями доступа к Google Ads API, вам нужны разрешения на управление квотами для облачного проекта Google Cloud. Необходимые разрешения по умолчанию включены в следующие роли: "Владелец", "Редактор", "Администратор квот" и "Администратор Service Usage". Дополнительную информацию можно найти в документации по разрешениям на квоты.
Проверить назначенные роли можно на странице IAM в облачном проекте Google Cloud. Попросите администратора проекта Google Cloud предоставить необходимые роли IAM для вашего проекта Google Cloud.