Токен разработчика – это буквенно-цифровая строка из 22 символов, которая использовалась для подключения приложения к Google Ads API. Поддержка токенов разработчика прекращена 9 сентября 2026 г. В этом руководстве кратко описаны изменения и приведены ответы на часто задаваемые вопросы о переходе.
Перейти к обзору Google Ads API в Cloud Console
Что изменится?
В рамках прекращения поддержки токенов разработчика мы внесли несколько изменений в процесс регистрации в 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 в управляющих аккаунтах Google Рекламы. Эти функции доступны на обзорной странице Google Ads API в консоли Google Cloud.
Вы по-прежнему можете перейти на страницу Центра 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 Рекламы назначены подходящие роли владельца или редактора в облачном проекте Google Cloud. На эти адреса мы будем отправлять обязательные уведомления о будущих изменениях в Google Ads API. В течение некоторого времени мы продолжим отправлять стандартные соглашения о предоставлении услуг на контактный электронный адрес, указанный в Центре API. Мы сообщим вам, когда этот процесс изменится.
Исправьте код приложения. Рекомендуем обновить приложение, чтобы больше не передавать токен разработчика в вызовах API. Мы опубликовали обновленные версии клиентских библиотек, MCP-сервера Google Ads API и Google Ads API Developer Assistant, которые позволяют выполнять вызовы 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 снова начнут работать.
Временное решение
Вы можете подать заявку на доступ к Explorer, используя новый проект Google Cloud.
Часто задаваемые вопросы
Ниже приведены ответы на часто задаваемые вопросы о прекращении поддержки токенов разработчика и уровнях доступа к 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 с базовым доступом и другой облачный проект 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, который вы больше не используете, никаких дополнительных действий с вашей стороны не требуется. Если проект не используется в течение 90 дней, Google отзывает доступ к API.
Моему проекту Google Cloud не были назначены уровни доступа к API. "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. Необходимые разрешения по умолчанию есть у следующих ролей: "Владелец", "Редактор", "Администратор квот" и "Администратор использования сервисов". Дополнительную информацию можно найти в документации по разрешениям на квоты.
Проверить назначенные роли можно на странице IAM облачного проекта Google Cloud. Попросите администратора проекта Google Cloud предоставить необходимые роли IAM для вашего проекта Google Cloud.