Xsolla-logo

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

post/attributes/users/{user_id}/update

Updates and creates user’s attributes.

Notice
Rate limits for server-side methods are applied to this method.

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"

サービス属性に対するユーザーのアクセスレベルの定義:

  • client - ユーザーが編集可能な属性。このタイプの属性の値は、ユーザーによって入力されるか、クライアント側のゲーム内ロジックに従って指定されます。例:名前とキャラクターのステータス、ゲームの難易度など。
  • server - 読み出し専用の属性。このタイプの属性の値は、アプリケーションのサーバー側で入力および編集されます。定期的に変更する必要のないゲームキャラクターの統計情報やユーザーパラメータの設定に使用することをお勧めします。例えば、ボーナス、ゲームキャラクターのキーパラメータ、ユーザーカテゴリなどを獲得するチャンス
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": {
    }
}