В таблице ниже приведен список учетных данных, которыми должно управлять приложение. Для получения информации о различных типах приложений обратитесь к нашей документации по OAuth .
| Процесс аутентификации | Удостоверение личности | Тип учетных данных | Цель |
|---|---|---|---|
| Все типы приложений | Токен разработчика | Учетные данные приложения | Позволяет использовать API Google Ads с утвержденным уровнем доступа . |
Веб-приложения на JavaScript Приложения для Android | Идентификатор клиента OAuth | Учетные данные приложения | Обеспечивает уникальную идентификацию приложения при выполнении аутентификации OAuth. |
| Токен доступа и токен обновления | Учетные данные пользователя | Представляет собой разрешение пользователя на предоставление приложению доступа к его аккаунту Google Ads от его имени. | |
Веб-приложения на стороне сервера Приложения для настольных компьютеров и iOS Приложения для телевизоров и устройств | Идентификатор клиента OAuth и секретный ключ клиента | Учетные данные приложения | Обеспечивает уникальную идентификацию приложения при выполнении аутентификации OAuth. |
| Токен доступа и токен обновления | Учетные данные пользователя | Представляет собой разрешение пользователя на предоставление приложению доступа к его аккаунту Google Ads от его имени. | |
| Служебные счета | ключ учетной записи службы OAuth | Учетные данные приложения | Используется для подписи запроса OAuth. |
| токен доступа служебной учетной записи | Учетные данные пользователя | Отражает авторизацию сервисного аккаунта. Пользователь предоставил сервисному аккаунту доступ к своему аккаунту Google Ads. |
При управлении учетными данными для приложения Google Ads API следует учитывать несколько моментов.
Обеспечьте безопасную обработку учетных данных приложения.
Учетные данные приложения — это настройки, специфичные для вашего приложения и не отличающиеся для разных пользователей. Обращайтесь с учетными данными вашего приложения OAuth с особой осторожностью, поскольку они позволяют любому, кто их имеет, использовать идентификационные данные вашего приложения для получения доступа к информации о пользователях. Храните учетные данные вашего приложения OAuth в безопасном месте и защищайте их так же, как и пароль. По возможности используйте менеджер секретов, например Google Cloud Secret Manager, для хранения учетных данных приложения. Никогда не размещайте учетные данные клиента в общедоступных репозиториях кода. Мы настоятельно рекомендуем избегать их размещения в любых репозиториях кода.
Обеспечьте безопасную обработку учетных данных пользователей.
Учетные данные пользователя — это токены OAuth, представляющие собой авторизацию пользователя. Они предоставляются вам пользователями, которые дают вам разрешение действовать и получать доступ к данным от их имени — либо напрямую, аутентифицируя ваше приложение, либо косвенно, предоставляя доступ к их аккаунту Google Ads вашему сервисному аккаунту. Никогда не передавайте токены в открытом виде и всегда храните зашифрованные токены в состоянии покоя, чтобы обеспечить дополнительный уровень защиты в случае утечки данных. Отозывайте токены или разрешения сервисного аккаунта, когда вам больше не нужен доступ к аккаунту пользователя. После отзыва токенов удалите их навсегда из вашего приложения или системы.
Обработка отзыва и истечения срока действия токенов обновления.
Если вы используете аутентификацию пользователей, следует помнить, что токены обновления могут быть аннулированы в любой момент. Например, при использовании многопользовательской аутентификации пользователь может отозвать доступ к вашему приложению. Хотя приложение, использующее однопользовательскую аутентификацию, с меньшей вероятностью пострадает от этого, ручной или автоматизированный процесс, предназначенный для защиты пользователей, также может удалить токен обновления, или же токен обновления может истечь. Если вашему приложению требуется уведомление об аннулировании токена для обеспечения удобства использования, необходимо интегрироваться с нашей службой защиты от межсетевых атак .
Используйте учетные данные пользователей повторно во всех запросах API.
Токены доступа OAuth имеют короткий срок действия и истекают через час. При использовании наших клиентских библиотек истечение срока действия и обновление токенов доступа осуществляется потокобезопасным способом. Все, что вам нужно сделать, это создать объект сессии Google Ads API с соответствующими учетными данными OAuth и использовать его на протяжении всего срока действия.
Если вы разрабатываете собственную стратегию обновления и управления токенами доступа, вам следует отслеживать срок действия токена доступа и использовать его повторно как можно чаще. Если вы не знаете, когда токен доступа был обновлен в последний раз, вы можете попытаться обновить его, предполагая, что он уже истек. Если срок действия токена доступа не близок к истечению, сервер возвращает тот же токен доступа вместе с количеством миллисекунд, оставшихся до истечения срока его действия . Мы рекомендуем принудительно обновлять токен доступа, если до истечения срока его действия осталось менее 5 минут.