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

オファーチェーンを更新するServer-sideAdmin

put/v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}

特定のオファーチェーンを更新するします。

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。

Example: 44056
offer_chain_id
required
integer

オファーチェーンID。

Example: 101
Request Body schema: application/json
required
(two-letter (object or null)) or (five-letter (object or null))

アイテム名に関するローカライズ用オブジェクト。2文字の小文字の言語コード(例:en)または5文字の言語コード(例:en-US)のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合(例:enen-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

ベトナム語

date_start
required
string <date-time>

オファーチェーンの開始日。

required
Array of objects
Array
step_number
required
integer >= 1

ステップ番号。

is_free
required
boolean

オファーチェーンのステップが無料であるかどうかを示します:

required
Array of objects non-empty
Array (non-empty)
sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$

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

quantity
required
integer >= 1

このチェーンステップの報酬アイテム数量。

order
integer or null >= 0

オファーチェーンステップの報酬注文。

step_id
integer or null >= 1

ユニークチェーンステップID。更新時にこれを指定することで、このステップに関するユーザーの進行状況を保持できます。

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

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

date_end
string or null <date-time>

オファーチェーンの終了日です。nullも可能です。もしdate_endnullの場合、オファーチェーンには期限が設定されません。

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

アイテムの説明に関するローカライズ用オブジェクト。2文字の小文字の言語コード(例:en)または5文字のロケールコード(例:en-US)のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合(例:enen-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

ベトナム語

id
integer

一意のオファーチェーンID。

is_always_visible
boolean
Default: true

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

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

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

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
{
  • "date_end": null,
  • "date_start": "2023-04-15T18:16:00+05:00",
  • "description": {
    },
  • "is_always_visible": true,
  • "is_enabled": true,
  • "name": {
    },
  • "order": 4,
  • "recurrent_schedule": null,
  • "steps": [
    ]
}
Response samples
application/json
{
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred",
  • "statusCode": 401
}