В таблице ниже перечислены учетные данные, которыми должно управлять приложение. Дополнительную информацию о типах приложений можно найти в документации по 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 минут.