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