Xsolla-logoXsolla Developers
または
パブリッシャーアカウントへ

アイテムのバリューポイントを部分的に更新するServer-sideAdmin

patch/v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards

1つまたは複数のアイテムのバリューポイント数を、アイテムのSKUごとに部分的に更新します。

バリューポイント更新の原則:

  • アイテムがまだバリューポイントを持っていない場合、amountフィールドにゼロ以外の値を送信すると、バリューポイントが作成されます。
  • アイテムがすでにバリューポイントを持っている場合、amountフィールドに 0 以外の値を送信すると、バリューポイントが更新されます。
  • amountが0に設定された場合、そのアイテムの既存のバリューポイントは削除されます。

PUTメソッド(アイテムにバリューポイントを設定する)とは異なり、このPATCHメソッドは、プロジェクト内のアイテムの既存のバリューポイントをすべて上書きするのではなく、指定されたアイテムのみを更新します。

1 つのリクエストで最大100アイテムまで更新できます。重複するアイテム SKU を同じリクエストに含めることはできません。

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。

Example: 44056
value_point_sku
required
string

バリューポイントSKU。

Example: value_point_3
Request Body schema: application/json
Array
sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。

amount
required
integer >= 0

バリューポイントの量。

Responses
204

アイテムのバリューポイント報酬が正常に更新されました。

401

基本認証が不合格または不正です。基本認証または正しい認証情報を使用したことを確認してください。

404

アイテムが見つかりません。project_idskuが正しいことを確認してください。

Request samples
application/json
[
  • {
    },
  • {
    }
]
Response samples
application/json
{
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred",
  • "statusCode": 401
}