메인 콘텐츠로 건너뛰기
POST
Update Player Custom Properties

인증

X-SecretKey
string
header
필수

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

본문

application/json

Performs an additive update of the custom properties for the specified player. In updating the player's custom properties, properties which already exist will have their values overwritten. No other properties will be changed apart from those specified in the call.

Performs an additive update of the custom properties for the specified player. In updating the player's custom properties, properties which already exist will have their values overwritten. No other properties will be changed apart from those specified in the call.

PlayFabId
string
필수

Unique PlayFab assigned ID of the user on whom the operation will be performed.

Properties
object[]
필수

Collection of properties to be set for a player.

CustomTags
object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

ExpectedPropertiesVersion
number

Optional field used for concurrency control. One can ensure that the update operation will only be performed if the player's properties have not been updated by any other clients since last the version.

응답

code
integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status
string

The Http status code as a string.

data
object
예시:
마지막 수정일 2026년 10월 6일