Токен разработчика — это 22-символьная буквенно-цифровая строка, которая использовалась для подключения вашего приложения к API Google Ads. Использование токенов разработчика было прекращено 9 сентября 2026 года . В этом руководстве кратко изложены изменения и приведены часто задаваемые вопросы об этой миграции, чтобы помочь существующим разработчикам.
Что меняется?
В рамках прекращения поддержки токенов разработчиков мы внесли ряд изменений в процесс подключения к API Google Ads и управление доступом к API. В этом разделе освещены ключевые изменения.
Уровни доступа к API связаны с проектами Google Cloud.
We sunset developer tokens on September 9, 2026. Your current and active developer token access level have been automatically transferred to your Google Cloud projects based on recent API activity. You can continue sending developer tokens in your API call headers, but this is optional and ignored by the API servers. Your existing code will continue working without any changes. Your API Access levels are now determined by the Google Cloud project you used to generate your OAuth credentials.
- Если ваше приложение использует процесс аутентификации пользователя , то именно этому проекту принадлежат идентификатор и секрет клиента OAuth.
- Если вы используете рабочий процесс с учетной записью службы , то именно этому проекту принадлежит ваша учетная запись службы.
Новый интерфейс регистрации для Google Ads API.
You can now sign up for access to Google Ads API directly in the Google Cloud Console without requiring a Google Ads manager account. Don't sign up for a developer token from the API Center page or attempt to apply for API access from the API Center page in your Google Ads manager account as these processes have been transitioned to Google Cloud Console and won't be processed if initiated from the API Center page.
Новый интерфейс управления доступом к API.
Мы убрали все новые функции регистрации и управления доступом к API, такие как подача заявки на доступ к API и управление уровнями доступа к API на странице Центра API в аккаунтах Google Ads Manager. Теперь эти функции доступны на странице Обзора API Google Ads в консоли Google Cloud.
Вы по-прежнему можете получить доступ к странице Центра API , чтобы просмотреть свои исторические данные разработчика. Эта страница будет полностью закрыта в будущем.
Новые коды ошибок
Version v25 of the Google Ads API will throw a CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION error if you try to use a Google Cloud project with Test Account Access level to make calls to a production account. Older API versions will throw an ACTION_NOT_PERMITTED error instead. If you run into this error, navigate to the Google Ads API Overview page for your Google Cloud project and apply for Explorer Access .
Для базового и стандартного доступа требуется подтверждение бренда.
Для новых приложений с базовым и стандартным доступом необходимо пройти проверку на соответствие фирменному стилю вашего проекта Google Cloud. Для существующих пользователей проверка фирменного стиля не требуется, хотя и рекомендуется.
Теперь обработка заявок на базовый доступ автоматизирована и занимает всего несколько минут после подтверждения бренда и отправки.
В связи с этими изменениями в процессе обработки заявок все ожидающие рассмотрения заявки на базовый доступ к API будут закрыты в рамках этого перехода. Заявители, которых это коснется, получат электронное письмо с подробной информацией и должны будут повторно подать заявку на доступ к API на странице обзора Google Ads API .
Новый API для отправки контактных адресов электронной почты
As we prepare for decommissioning the API Center page , we will transition to using the list of owner and editor users in your Google Cloud project as the sole channel for administrative and mandatory compliance communications. To ensure a smooth transition, we will temporarily continue to send Mandatory Service Announcements (MSAs) to the email address listed in your API Center. We will keep you updated as we finalize the transition of our communication channels.
Что делать, если вы уже являетесь разработчиком?
Проверьте уровни доступа к API вашего проекта Google Cloud: Если вы являетесь действующим разработчиком, мы настоятельно рекомендуем вам проверить страницу обзора API Google Ads в ваших проектах Google Cloud, чтобы убедиться, что у них тот же уровень доступа к API, что и у вашего существующего токена разработчика. Следуйте инструкциям в этом руководстве, чтобы устранить любые обнаруженные несоответствия.
Review your API contact email address: Visit the IAM (Identity and Access Management) page for your Google Cloud project. Verify that your active Ads developers and account managers are assigned appropriate owner or editor roles in your Google Cloud project. We will start sending Mandatory Service Announcements (MSAs) to these email addresses to notify you about any future changes to the Google Ads API. We will continue sending MSAs to the contact email address listed in your API Center for a temporary period, and we will inform you whenever this process updates.
Fix your app code: We encourage you to update your app to stop sending developer token as part of the API calls. We have published updated versions of the client libraries , the Google Ads MCP server , and the Google Ads API Developer Assistant which let you make API calls without setting a developer token. We will start rejecting developer tokens in API calls in a future major version of the Google Ads API. If your app uses these libraries, update app dependencies to use the latest version.
Если вам нужна дополнительная помощь или у вас возникли дополнительные вопросы, обратитесь в службу поддержки 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?
In the past, the Google Ads API team supported reassociating a developer token with a new Google Cloud project on a case-by-case basis. This is no longer supported as of September 9, 2026, since we have sunset developer tokens. If you need to use a new Google Cloud project, you should apply for the appropriate API access from your Google Cloud project's Google Ads API Overview page .
У меня есть одобренный токен разработчика, но я его никогда не использовал. Могу ли я использовать этот токен разработчика?
Нет, вы не можете использовать этот токен разработчика. Есть два варианта:
Your developer token access might be revoked for inactivity: As per Google policies , Google may revoke your API token if it's not used consecutively for 90 days. If you haven't used your developer token in a while, it is likely that its access levels have been revoked due to inactivity. If this is the case, then reapply for API access for your Google Cloud project from the Google Ads API Overview page . See an example .
Your developer token was recently approved, but you never used it prior to September 9, 2026: Since you never used your approved developer token with a Google Cloud project prior to September 9, 2026, its access levels weren't transferred to the Cloud project. As a result, you cannot use your developer token any longer. We will throw a
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONerror if you attempt to make an API call to a production account with this developer token. To fix the error, apply for the appropriate API access from your Google Cloud project's Google Ads API Overview page . See an example .
In both these cases, you can apply for Explorer Access and Basic Access level applications and get them automatically reviewed; you no longer need to work with Google's Compliance team to complete the review process. If you need Standard Access, you need a manual review. However, you can share your approved developer token details when applying for Standard Access, so that the Compliance team can review your new Standard Access application accordingly.
Могу ли я прекратить отправку токенов разработчика в рамках запросов к API?
Да, вы можете прекратить отправку токенов разработчика в рамках запросов к API. Если вы используете клиентскую библиотеку, вам может потребоваться обновить её до последней версии. Проверьте журнал изменений библиотеки, чтобы убедиться, поддерживает ли она вызовы API без указания токена разработчика.
Я участвовал в пилотной программе по внедрению управляемого доступа к облачным сервисам. Как это на меня повлияет?
Пилотная программа управляемого доступа к облаку была запущена для того, чтобы разработчики Google Cloud могли совершать вызовы API без отправки токена разработчика в составе запроса API. Теперь, когда токены разработчика устарели, эта программа будет прекращена.
Уровни доступа вашего активного токена разработчика были перенесены в ваш проект Google Cloud, поэтому ваш существующий код должен продолжать работать без каких-либо изменений. Если вам необходимо использовать новый проект Google Cloud, вам следует подать заявку на доступ к API на странице обзора Google Ads API вашего проекта Google Cloud.
Мой токен разработчика был включен в список разрешенных. Как это повлияет на меня?
Компания Google может запускать пилотные программы, предоставляющие некоторым разработчикам доступ к экспериментальным функциям. Доступ к этим функциям иногда предоставляется путем добавления вашего токена разработчика в список разрешенных пользователей. Если вы участвовали в такой пилотной программе, то никаких действий с вашей стороны не требуется.
We have updated all the pilot programs to use Google Cloud projects instead of developer tokens as the allowlisting mechanism and transferred the developer token's allowlist status to the associated Google Cloud projects. Your existing code should continue to work without any changes. If you continue facing issues, reach out to your Google Account manager who enrolled you into the pilot program.
У меня есть одобренный токен разработчика, и я хочу использовать его в новом проекте Google Cloud. Разрешено ли это?
No, you cannot use a new Google Cloud project with your approved developer token. Since you never used your approved developer token with the new Google Cloud project prior to September 9, 2026, its access levels weren't transferred to the Cloud project. We will throw an CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION error if you attempt to make an API call with this developer token, since developer tokens are no longer used to determine your API access levels. To fix the error, apply for the appropriate API access from your Google Cloud project's Google Ads API Overview page . See an example .
Мой токен разработчика был скомпрометирован. Нужно ли мне сбросить свой токен разработчика?
Нет, в данном случае вам не нужно сбрасывать токен разработчика. Поскольку мы перенесли уровни доступа к API вашего токена разработчика в ваш проект Google Cloud, неавторизованный пользователь больше не сможет использовать ваш токен разработчика в своем собственном проекте Google Cloud. Однако, при желании, вы можете сбросить токен разработчика в Центре API.
Что произойдет с API Center?
The existing API Center page within the Google Ads manager account is deprecated and will be removed in the near future. If you already have a developer token, you can still log into your Google Ads manager account and view the details. However, these are provided only for your reference. Don't perform any tasks related to developer token Access levels, such as applying for higher API access levels from this page.
Если вам необходимо запросить более высокий уровень доступа к 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 будет закрыт в ближайшем будущем.