更新用户属性
最新更新:2024-08-15

更新用户属性

支持通过 API 批量更新用户属性值,开发者可以根据业务需求,灵活设置用户属性,以便更好地进行用户画像和推荐。

请求方式

POST

调用地址

https://api.gptbots.ai/v1/property/update

Request Authentication

详情参见 API 概述的鉴权方式说明。

请求

请求示例

curl -X POST "https://api.gptbots.ai/v1/property/update" \ -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.gptbots.ai/v1/property/update" \
-H "Content-Type: application/json" \
-d '{
  "user_id": "example_user_id",
  "property_values": [
    {
      "property_name": "example_property_name",
      "value": "example_value"
    }
  ]
}'

        
此代码块在浮窗中显示

请求头

字段 类型 说明
Authorization Bearer ${token} 使用 Authorization: Bearer ${token}进行调用验证,请在 API 密钥页面获取密钥作为 token。
Content-Type application/json 数据类型,取值为 application/json。

请求体

参数 类型 说明 required
user_id string 需要设置用户属性的用户id ture
property_values list 待更新的属性列表 ture
property_values.property_name string 属性名称 ture
property_values.value object 属性值 ture

响应

参数 类型 说明
success_update list 成功更新的用户属性列表
success_update.propertyName string 成功更新的属性名称
success_update.value object 成功更新的属性值
fail_update list 更新失败的用户属性列表
fail_update.value object 更新失败的属性值
fail_update.property_name string 新失败的属性名称