Xsolla-logo

サーバーからユーザー属性を更新する

post/attributes/users/{user_id}/update

ユーザーの属性を更新および作成します。

SecurityAttributesServer
Request
path Parameters
user_id
required
string <uuid>

ユーザーID。パブリッシャーアカウント > ログイン設定 > ユーザー > ユーザー名/IDで見つけることができます。

Request Body schema: application/json
publisher_id
required
integer or null

リクエストの対象となるマーチャントID。リクエストの認証に必要です。

Array of objects

指定されたゲームの属性のリスト。 存在しない属性を追加するには、この属性をkeyパラメータに設定します。 属性のvalueを更新するには、そのkeyパラメータを指定し、新しいvalueを設定します。一度に複数の属性を変更できます。

Array
key
required
string <= 256 characters [A-Za-z0-9_]+

ユーザーの属性を特定するために使用される属性名。ユーザーごとに一意である必要があります。

value
required
string <= 256 characters

ユーザーの属性値。

attr_type
string
Default: "client"

Definition of user’s access level to service attributes:

  • client - A user-editable attribute. The values for this type of attributes are entered by a user or specified according to the in-game logics on the client side. For example, the name and character stats, game difficulty level, etc.
  • server - A read-only attribute. The values for this type of attributes are entered and edited on the server side of your application. We recommend that you use them for configuration of game character stats or user parameters that shouldn’t change regularly. For example, chance to get a bonus, game character key parameters, user categories, etc.
Enum: "client" "server"
data_type
string or null

属性のデータタイプ

Enum: "string" "number" "integer" "boolean"
description
string or null

JSONスキーマからの属性の説明。

format
string or null

JSONスキーマからの属性の形式。JSONスキーマの仕様からdate-timedatetimedurationemailuriuuidまたはそれ以外を指定することができます。

permission
string or null

他のユーザーの属性に対するユーザーのアクセスレベルの定義。

Enum: "public" "private"
publisher_project_id
integer

指定された属性の値を更新するパブリッシャーアカウントのプロジェクトID。指定しない場合、このメソッドはすべてのゲームに共通の属性のみを更新します。

removing_keys
Array of strings

削除したい属性のリスト。attributesパラメータで同じ属性を指定しても、削除されません。

Responses
204

コンテンツなし

400

無効なリクエスト

403

処理不可能なエンティティー

422

処理不可能なエンティティー

429

リクエストの回数が多すぎます

Request samples
application/json
{
  • "attributes": [
    ],
  • "publisher_id": 0,
  • "publisher_project_id": 0,
  • "removing_keys": [
    ]
}
Response samples
{
  • "error": {
    }
}