Attribute des Benutzers auf dem Server aktualisieren

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>

Benutzer-ID. Diese finden Sie unter Kundenportal > Login-Einstellungen > Nutzer > Benutzername/ID.

Request Body schema: application/json

publisher_id

required

integer or null

Ihre Händler-ID, in deren Namen die Anfrage gestellt wird. Erforderlich, um die Anfrage zu autorisieren.

Array of objects

Liste der Attribute des angegebenen Spiels. Um ein nicht vorhandenes Attribut hinzuzufügen, müssen Sie für das Attribut einen key-Parameter festlegen. Um den value des Attributs zu aktualisieren, geben Sie dessen key-Parameter an, und legen Sie den neuen value fest. Es ist möglich, mehrere Attribute gleichzeitig zu ändern.

Array

key required	string <= 256 characters [A-Za-z0-9_]+ Name des Attributs, anhand dessen das Benutzerattribut identifiziert wird. Muss für jeden Benutzer eindeutig sein.
value required	string <= 256 characters Wert des Benutzerattributs.
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 Datentyp des Attributs Enum: "string" "number" "integer" "boolean"
description	string or null Beschreibung des Attributs aus dem JSON-Schema.
format	string or null Format des Attributs aus dem JSON-Schema. Möglich sind `date-time`, `date`, `time`, `duration`, `email`, `uri`, `uuid` oder etwas anderes aus der JSON-Schemaspezifikation
permission	string or null Festlegung der Zugriffsebene eines Benutzers für dessen Zugriff auf die Attribute anderer Benutzer. Enum: "public" "private"

publisher_project_id

integer

ID des Kundenportal-Projekts, für das Sie den Wert der angegebenen Attribute aktualisieren möchten. Wenn Sie keine ID angeben, aktualisiert die Methode nur Attribute, die für alle Spiele gelten.

removing_keys

Array of strings

Liste der Attribute, die Sie löschen möchten. Wenn Sie dasselbe Attribut im Parameter attributes angeben, wird es nicht gelöscht.

Responses

204

No Content

400

Bad Request

403

Forbidden

422

Unprocessable Entity

429

Too Many Requests

Request samples

application/json

{"attributes": [{"attr_type": "client",
"data_type": "string",
"description": "string",
"format": "string",
"key": "string",
"permission": "public",
"value": "string"
}
],
"publisher_id": 0,
"publisher_project_id": 0,
"removing_keys": ["string"
]
}

Response samples

{"error": {"code": "003-061",
"description": "Object not found.",
"details": { }
}
}