報酬チェーンを更新する

または

パブリッシャーアカウントへ

報酬チェーンを更新するServer-sideAdmin

put/v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}

特定の報酬チェーンを更新します。

SecuritybasicAuth

Request

path Parameters

project_id required	integer プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。 Example: 44056
reward_chain_id required	integer 報酬チェーンID。 Example: 101

Request Body schema: application/json

One of:

報酬チェーン。

required

(two-letter (object or null)) or (five-letter (object or null))

アイテム名に関するローカライズ用オブジェクト。2文字の小文字の言語コード（例：en）または5文字の言語コード（例：en-US）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合（例：enとen-US）、最後に提供された値が保存されます。サポートされている言語の完全なリストは、ドキュメントで確認できます。

One of:

2文字の小文字の言語コード。

ar	string or null アラビア語
bg	string or null ブルガリア語
cn	string or null 中国語（簡体字）
cs	string or null チェコ語
de	string or null ドイツ語
en	string or null 英語
es	string or null スペイン語（スペイン）
fr	string or null フランス語
he	string or null ヘブライ語
id	string or null インドネシア語
it	string or null イタリア語
ja	string or null 日本語
km	string or null クメール語
ko	string or null 韓国語
lo	string or null ラオス語
my	string or null ビルマ語
ne	string or null ネパール語
ph	string or null フィリピン語
pl	string or null ポーランド語
pt	string or null ポルトガル語
ro	string or null ルーマニア語
ru	string or null ロシア語
th	string or null タイ語
tr	string or null トルコ語
tw	string or null 中国語（繁体字）
vi	string or null ベトナム語

required

Array of objects

報酬チェーンの有効期間。複数の期間を指定する場合は、date_fromとdate_untilの両方が必須となります。

Array

date_from required	string <date-time> 指定された報酬チェーンの開始日。
date_until	string or null <date-time> 指定された報酬チェーンの終了日。有効期間が1つだけ指定されている場合に限り、`null`に設定可能です。

required

Array of objects

Array

required

(two-letter (object or null)) or (five-letter (object or null))

One of:

2文字の小文字の言語コード。

ar	string or null アラビア語
bg	string or null ブルガリア語
cn	string or null 中国語（簡体字）
cs	string or null チェコ語
de	string or null ドイツ語
en	string or null 英語
es	string or null スペイン語（スペイン）
fr	string or null フランス語
he	string or null ヘブライ語
id	string or null インドネシア語
it	string or null イタリア語
ja	string or null 日本語
km	string or null クメール語
ko	string or null 韓国語
lo	string or null ラオス語
my	string or null ビルマ語
ne	string or null ネパール語
ph	string or null フィリピン語
pl	string or null ポーランド語
pt	string or null ポルトガル語
ro	string or null ルーマニア語
ru	string or null ロシア語
th	string or null タイ語
tr	string or null トルコ語
tw	string or null 中国語（繁体字）
vi	string or null ベトナム語

required

object

amount

required

integer

バリューポイントでのステップ価格。

required

Array of objects

Array

sku

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$

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

quantity

required

integer

アイテム数量。

Array of type = string (object) or type = number (object) or type = date (object) [ 1 .. 100 ] items

ユーザー属性を検証するための条件。ユーザー属性が指定されたすべての条件に一致するかどうかに基づいて、報酬チェーンの各ステップにおける報酬の可用性を決定します。

Array ([ 1 .. 100 ] items)

One of:

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

ユーザー属性コード。

operator

required

string

条件によって実行される操作のタイプ。string属性タイプの場合。

Enum:	Description
eq	イコール
ne	ノットイコール

value

required

string <= 255 characters

ユーザー属性値の比較対象となる条件値。ライプは属性タイプに依存します。

type

required

string

ユーザー属性タイプ。

Value: "string"

can_be_missing

boolean

ユーザー属性に属性がない場合でも条件を満たすことを示します。trueを渡すと、この属性を持たないユーザーにもアイテムを表示します。属性は持っているが、値が条件で指定されたものと一致しないユーザーには、アイテムは表示されません。false - その属性を持っているが、値が条件に指定されたものと一致しないか、属性が欠落しているユーザーには、アイテムは表示されません。

step_id

required

integer or null

一意のステップID。

image_url

string or null

画像URL。

is_enabled

required

boolean

Array of type = string (object) or type = number (object) or type = date (object) [ 1 .. 100 ] items

ユーザー属性を検証するための条件。ユーザー属性が指定されたすべての条件に一致するかどうかに基づいて、オファーチェーンの可用性を決定します。

Array ([ 1 .. 100 ] items)

One of:

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

ユーザー属性コード。

operator

required

string

条件によって実行される操作のタイプ。string属性タイプの場合。

Enum:	Description
eq	イコール
ne	ノットイコール

value

required

string <= 255 characters

ユーザー属性値の比較対象となる条件値。ライプは属性タイプに依存します。

type

required

string

ユーザー属性タイプ。

Value: "string"

can_be_missing

boolean

(two-letter (object or null)) or (five-letter (object or null))

アイテムの説明に関するローカライズ用オブジェクト。2文字の小文字の言語コード（例：en）または5文字のロケールコード（例：en-US）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合（例：enとen-US）、最後に提供された値が保存されます。サポートされている言語の完全なリストは、ドキュメントで確認できます。

One of:

2文字の小文字の言語コード。

ar	string or null アラビア語
bg	string or null ブルガリア語
cn	string or null 中国語（簡体字）
cs	string or null チェコ語
de	string or null ドイツ語
en	string or null 英語
es	string or null スペイン語（スペイン）
fr	string or null フランス語
he	string or null ヘブライ語
id	string or null インドネシア語
it	string or null イタリア語
ja	string or null 日本語
km	string or null クメール語
ko	string or null 韓国語
lo	string or null ラオス語
my	string or null ビルマ語
ne	string or null ネパール語
ph	string or null フィリピン語
pl	string or null ポーランド語
pt	string or null ポルトガル語
ro	string or null ルーマニア語
ru	string or null ロシア語
th	string or null タイ語
tr	string or null トルコ語
tw	string or null 中国語（繁体字）
vi	string or null ベトナム語

image_url

string or null

画像URL。

is_always_visible

boolean

Default: true

チェーンがすべてのユーザーに表示されるかどうか：

trueの場合、ユーザーの認証ステータスや属性に関係なく常にチェーンが表示されます。
falseの場合、個人用設定されたチェーンが見つからない場合にのみチェーンが表示されます。例えば、ユーザーが認証されていない場合や、その属性がパーソナライズされたチェーンと一致しない場合などです。

パーソナライズされたチェーンのコンテキストでのみ適用され、attribute_conditions配列が渡されない場合に使用されます。

is_reset_after_end

boolean

Default: false

報酬チェーンの終了日以降に、報酬チェーン（バリューポイントおよび全ユーザーの進捗状況）をリセットするかどうか˙：

trueの場合、報酬チェーンはその終了日の後にリセットされます。
falseの場合、報酬チェーンはその終了日の後にリセットされません。

お知らせ

以下の場合、trueにすることはできません：

recurrent_scheduleでリセット期間が設定されません。
periods.date_untilでnullの値が渡されます。

(two-letter (object or null)) or (five-letter (object or null))

アイテムの長文説明のローカライズを含むオブジェクト。2文字の小文字の言語コード（例：en）または5文字のロケールコード（例：en-US）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のバリアント（例：enとen-US）が提供された場合、最後に提供された値が保存されます。サポートされている言語の完全なリストは、ドキュメントで確認できます。

Any of:

2文字の小文字の言語コード。

ar	string or null アラビア語
bg	string or null ブルガリア語
cn	string or null 中国語（簡体字）
cs	string or null チェコ語
de	string or null ドイツ語
en	string or null 英語
es	string or null スペイン語（スペイン）
fr	string or null フランス語
he	string or null ヘブライ語
id	string or null インドネシア語
it	string or null イタリア語
ja	string or null 日本語
km	string or null クメール語
ko	string or null 韓国語
lo	string or null ラオス語
my	string or null ビルマ語
ne	string or null ネパール語
ph	string or null フィリピン語
pl	string or null ポーランド語
pt	string or null ポルトガル語
ro	string or null ルーマニア語
ru	string or null ロシア語
th	string or null タイ語
tr	string or null トルコ語
tw	string or null 中国語（繁体字）
vi	string or null ベトナム語

order

integer

配列順序を定義します。

(interval_type = weekly (object or null)) or (interval_type = monthly (object or null)) or (interval_type = hourly (object or null))

報酬チェーンの定期リセット期間。

One of:

報酬チェーンの週次更新タイプ。

interval_type required	string 報酬チェーンの定期リセット頻度。 Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... 希望するタイムゾーンで報酬チェーンがリセットされる時間（時間数に丸める）。例えば、報酬チェーンのリセットの設定時間は、クアラルンプールのタイムゾーン (GMT+8) の 01:00 です。この場合、`time`パラメータの値は`01:00:00+08:00`となります。
day_of_week required	integer [ 1 .. 7 ] 報酬チェーンがリセットされる曜日。`1`は月曜日、`7`は日曜日。

Responses

204

報酬チェーンは正常に更新されました。

401

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

404

報酬チェーンが見つかりません。

422

無効なリクエストです。

Request samples

application/json

{"clan_type": "guild",
"description": {"en": "Clan reward chain description."
},
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"is_enabled": true,
"long_description": {"en": "Clan reward chain long description."
},
"name": {"en": "Clan reward chain"
},
"order": 1,
"periods": [{"date_from": "2026-01-01T01:00:00+05:00",
"date_until": "2026-01-31T23:59:59+05:00"
},
{"date_from": "2026-02-01T01:00:00+05:00",
"date_until": "2026-02-28T23:59:59+05:00"
}
],
"popup_header": {"en": "How to unlock rewards"
},
"popup_image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"popup_instruction": {"en": "You should be a clan member to get clan rewards. You join a clan when a clan member invited you to the clan, and you accepted the invite. You can create your own clan."
},
"recurrent_schedule": {"day_of_week": 1,
"interval_type": "weekly",
"time": "01:00:00+08:00"
},
"steps": [{"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"name": {"en": "First step of the reward chain"
},
"price": {"amount": 10
},
"reward": [{"quantity": 5,
"sku": "com.xsolla.item_1"
},
{"quantity": 1,
"sku": "com.xsolla.item_2"
}
],
"step_id": 1
},
{"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"name": {"en": "Second step of the reward chain"
},
"price": {"amount": 15
},
"reward": [{"quantity": 5,
"sku": "com.xsolla.item_3"
},
{"quantity": 1,
"sku": "com.xsolla.item_4"
}
],
"step_id": 2
}
]
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}