Искусственный интеллект Google предоставляет продавцам контекстные данные, помогая им оценивать риски транзакций и принимать решения о целесообразности их проведения. Это позволяет продавцам полностью контролировать покупки, совершаемые на их платформах.
Эти данные передаются преимущественно во время вызова API Complete Checkout .
В спецификации от 23.01.2026 эти сигналы находятся в объекте risk_signals .
Google предоставляет продавцам следующие типы данных:
Данные сессии
| Название сигнала | Описание | Путь API |
|---|---|---|
| IP-адрес | IP-адрес пользователя в сессии. | ip_address |
| Время начала сессии | Время начала покупки (метка времени Unix epoch). | session_start_time |
Данные устройства
| Название сигнала | Описание | Путь API |
|---|---|---|
| Тип устройства | Тип используемого устройства (например, MOBILE УСТРОЙСТВО, DESKTOP , TABLET или UNKNOWN ). Определяется на основе User Agent. | device_type |
| Часовой пояс устройства | Текущий часовой пояс устройства, используемого в сессии. | device_timezone |
Данные о местоположении
Следующие приблизительные сигналы географического местоположения получены для оказания помощи в предотвращении мошенничества и обнаружении захвата учетных записей.
| Название сигнала | Описание | Путь API |
|---|---|---|
| Страна пользователя | Примерное местоположение покупателя (например, United States ). | user_country |
| Состояние пользователя | Примерное указание штата или провинции, где находится покупатель (например, California ). | user_state |
Данные браузера
| Название сигнала | Описание | Путь API |
|---|---|---|
| Агент пользователя | Строка с информацией о клиенте браузера. | user_agent |
| Язык браузера | Язык, используемый в браузере на устройстве (например, "en"). | locale |
| Высота области просмотра | Высота области просмотра браузера в пикселях. | viewport_height_px |
| Ширина области просмотра | Ширина области просмотра браузера в пикселях. | viewport_width_px |
Данные заказа
В вызовах API Create/Update Checkout доступны следующие данные, которые обеспечивают контекст для заказа:
| Название сигнала | Описание | Путь к API ( Create/Update Checkout ) |
|---|---|---|
| Идентификатор продукта | Помогает продавцу идентифицировать товар. | line_items[x].item.id |
| Идентификатор выполнения заказа | Помогает определить тип и способ доставки. | Зависит от настроек выполнения заказа. |
Данные о доставке и выставлении счетов
Адрес и информация о покупателе предоставляются в основном во время вызовов API Create/Update Checkout .
- Информация для покупателя:
| Название сигнала | Описание | Путь к API ( Create/Update Checkout ) |
|---|---|---|
| Адрес электронной почты пользователя | Адрес электронной почты Google пользователя, вошедшего в систему. | buyer.email |
- Адрес доставки: доступен в
Create/Update Checkoutв полеfulfillment.methods.destinations[x](гдеtype— "shipping", аx—selected_destination_id).
| Название сигнала | Описание | Путь API | Необязательный |
|---|---|---|---|
| Имя | Имя получателя | first_name | Нет |
| Фамилия | Фамилия получателя | last_name | Нет |
| Полное имя | Полное имя получателя | full_name | Да |
| Номер телефона | Номер телефона получателя | phone_number | Да |
| Адрес улицы | Главная улица, адресная строка | street_address | Нет |
| Расширенный адрес | Квартира, люкс и т. д. | extended_address | Да |
| Город | Город или населенный пункт | address_locality | Нет |
| Область | Штат или регион | address_region | Нет |
| Почтовый индекс | Почтовый индекс | postal_code | Нет |
| Страна | Код страны | address_country | Нет |
- Адрес для выставления счетов: доступен в
Complete Checkout. Поля те же, что и в таблице «Адрес доставки», и находятся в объектеpayment.instruments[x].billing_address(гдеx— этоselected_instrument_id).
Данные для проверки платежей
В объекте risk_signals в ответе Complete Checkout доступны следующие поля.
| Название сигнала | Описание | Путь API |
|---|---|---|
| Полные результаты AVS | Результат проверки системы проверки адресов (AVS). | avs_full_result |
| Результат CVV | Результат проверки кода подтверждения карты (CVV). | cvv_result |
| Запущена аутентификация | Указывает, была ли выполнена дополнительная аутентификация пользователя. | authentication_triggered |
| Авторизация обработана с помощью 3DS. | Указывает, была ли выполнена проверка 3D Secure. | authorization_processed_with_3ds |
Пример
В следующем примере показана структура объекта сигналов риска для версии 2026-01-23 .
{
"risk_signals": {
"ip_address": "123.456.7.890",
"session_start_time": "1778090291092",
"device_type": "DESKTOP",
"device_timezone": "America/Los_Angeles",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36",
"locale": "en",
"viewport_height_px": 893,
"viewport_width_px": 1515,
"avs_full_result": "Y",
"cvv_result": "M",
"authentication_triggered": true,
"authorization_processed_with_3ds": true
}
}
Искусственный интеллект Google предоставляет продавцам контекстные данные, помогая им оценивать риски транзакций и принимать решения о целесообразности их проведения. Это позволяет продавцам полностью контролировать покупки, совершаемые на их платформах.
Эти данные передаются преимущественно во время вызова API Complete Checkout .
В спецификации от 23.01.2026 эти сигналы находятся в объекте risk_signals .
Google предоставляет продавцам следующие типы данных:
Данные сессии
| Название сигнала | Описание | Путь API |
|---|---|---|
| IP-адрес | IP-адрес пользователя в сессии. | ip_address |
| Время начала сессии | Время начала покупки (метка времени Unix epoch). | session_start_time |
Данные устройства
| Название сигнала | Описание | Путь API |
|---|---|---|
| Тип устройства | Тип используемого устройства (например, MOBILE УСТРОЙСТВО, DESKTOP , TABLET или UNKNOWN ). Определяется на основе User Agent. | device_type |
| Часовой пояс устройства | Текущий часовой пояс устройства, используемого в сессии. | device_timezone |
Данные о местоположении
Следующие приблизительные сигналы географического местоположения получены для оказания помощи в предотвращении мошенничества и обнаружении захвата учетных записей.
| Название сигнала | Описание | Путь API |
|---|---|---|
| Страна пользователя | Примерное местоположение покупателя (например, United States ). | user_country |
| Состояние пользователя | Примерное указание штата или провинции, где находится покупатель (например, California ). | user_state |
Данные браузера
| Название сигнала | Описание | Путь API |
|---|---|---|
| Агент пользователя | Строка с информацией о клиенте браузера. | user_agent |
| Язык браузера | Язык, используемый в браузере на устройстве (например, "en"). | locale |
| Высота области просмотра | Высота области просмотра браузера в пикселях. | viewport_height_px |
| Ширина области просмотра | Ширина области просмотра браузера в пикселях. | viewport_width_px |
Данные заказа
В вызовах API Create/Update Checkout доступны следующие данные, которые обеспечивают контекст для заказа:
| Название сигнала | Описание | Путь к API ( Create/Update Checkout ) |
|---|---|---|
| Идентификатор продукта | Помогает продавцу идентифицировать товар. | line_items[x].item.id |
| Идентификатор выполнения заказа | Помогает определить тип и способ доставки. | Зависит от настроек выполнения заказа. |
Данные о доставке и выставлении счетов
Адрес и информация о покупателе предоставляются в основном во время вызовов API Create/Update Checkout .
- Информация для покупателя:
| Название сигнала | Описание | Путь к API ( Create/Update Checkout ) |
|---|---|---|
| Адрес электронной почты пользователя | Адрес электронной почты Google пользователя, вошедшего в систему. | buyer.email |
- Адрес доставки: доступен в
Create/Update Checkoutв полеfulfillment.methods.destinations[x](гдеtype— "shipping", аx—selected_destination_id).
| Название сигнала | Описание | Путь API | Необязательный |
|---|---|---|---|
| Имя | Имя получателя | first_name | Нет |
| Фамилия | Фамилия получателя | last_name | Нет |
| Полное имя | Полное имя получателя | full_name | Да |
| Номер телефона | Номер телефона получателя | phone_number | Да |
| Адрес улицы | Главная улица, адресная строка | street_address | Нет |
| Расширенный адрес | Квартира, люкс и т. д. | extended_address | Да |
| Город | Город или населенный пункт | address_locality | Нет |
| Область | Штат или регион | address_region | Нет |
| Почтовый индекс | Почтовый индекс | postal_code | Нет |
| Страна | Код страны | address_country | Нет |
- Адрес для выставления счетов: доступен в
Complete Checkout. Поля те же, что и в таблице «Адрес доставки», и находятся в объектеpayment.instruments[x].billing_address(гдеx— этоselected_instrument_id).
Данные для проверки платежей
В объекте risk_signals в ответе Complete Checkout доступны следующие поля.
| Название сигнала | Описание | Путь API |
|---|---|---|
| Полные результаты AVS | Результат проверки системы проверки адресов (AVS). | avs_full_result |
| Результат CVV | Результат проверки кода подтверждения карты (CVV). | cvv_result |
| Запущена аутентификация | Указывает, была ли выполнена дополнительная аутентификация пользователя. | authentication_triggered |
| Авторизация обработана с помощью 3DS. | Указывает, была ли выполнена проверка 3D Secure. | authorization_processed_with_3ds |
Пример
В следующем примере показана структура объекта сигналов риска для версии 2026-01-23 .
{
"risk_signals": {
"ip_address": "123.456.7.890",
"session_start_time": "1778090291092",
"device_type": "DESKTOP",
"device_timezone": "America/Los_Angeles",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36",
"locale": "en",
"viewport_height_px": 893,
"viewport_width_px": 1515,
"avs_full_result": "Y",
"cvv_result": "M",
"authentication_triggered": true,
"authorization_processed_with_3ds": true
}
}