Actualizar atributos de usuario

Permite actualizar por lotes los valores de los atributos de usuario mediante la API. Se pueden configurar atributos de usuario de forma flexible según las necesidades del negocio para mejorar el perfilado de usuarios y las recomendaciones.

Método de solicitud

POST

Endpoint

https://api-${endpoint}.gptbots.ai/v1/property/update

Autenticación de la solicitud

Para más información, consulte la descripción del método de autenticación en la visión general de la API.

Solicitud

Ejemplo de solicitud

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/property/update' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "user_id": "example_user_id", "property_values": [ { "property_name": "example_property_name", "value": "example_value" } ] }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/property/update' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
    "user_id": "example_user_id",
    "property_values": [
        {
            "property_name": "example_property_name",
            "value": "example_value"
        }
    ]
}'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Bearer ${API Key}	Se utiliza `Authorization: Bearer ${API Key}` para la autenticación. La clave de API se obtiene en la página `API Key`.
Content-Type	application/json	Tipo de datos; el valor es `application/json`.

Parámetros de la solicitud

Parámetro	Tipo	Descripción	Obligatorio
user_id	string	ID de usuario para el que se deben configurar los atributos	true
property_values	list	Lista de atributos que se van a actualizar	true
property_values.property_name	string	Nombre del atributo	true
property_values.value	object	Valor del atributo	true

Respuesta

Parámetro	Tipo	Descripción
success_update	list	Lista de atributos de usuario actualizados correctamente
success_update.propertyName	string	Nombre del atributo actualizado correctamente
success_update.value	object	Valor del atributo actualizado correctamente
fail_update	list	Lista de atributos de usuario cuya actualización falló
fail_update.value	object	Valor de la actualización fallida
fail_update.property_name	string	Nombre del atributo fallido