更新使用者屬性

支援透過 API 批次更新使用者屬性值。開發者可依據業務需求靈活設定使用者屬性，進一步提升使用者分析與推薦的效果。

請求方法

POST

端點

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

請求認證

詳細資訊請參考 API 概述中的認證方法說明。

請求

請求範例

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"
        }
    ]
}'

此代碼塊在浮窗中顯示

請求標頭

欄位	類型	描述
Authorization	Bearer ${API Key}	使用 Authorization: Bearer ${API Key} 進行認證。API 金鑰可於 API Key 頁面取得。
Content-Type	application/json	資料類型，值為 application/json。

請求參數

參數	類型	描述	是否必填
user_id	string	需要設定屬性的使用者 ID	true
property_values	list	需要更新的屬性列表	true
property_values.property_name	string	屬性名稱	true
property_values.value	object	屬性值	true

回應

參數	類型	描述
success_update	list	成功更新的使用者屬性列表
success_update.propertyName	string	成功更新的屬性名稱
success_update.value	object	成功更新的屬性值
fail_update	list	更新失敗的使用者屬性列表
fail_update.value	object	更新失敗的屬性值
fail_update.property_name	string	更新失敗的屬性名稱