GS2-Experience トランザクションアクション

検証/消費/入手の各トランザクションアクションの仕様

VerifyAction

検証アクション

Gs2Experience:VerifyRankByUserId

ユーザーIDを指定してランクを検証

数量指定可能なアクション:いいえ

有効化条件必須デフォルト値の制限説明
namespaceNamestring
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
experienceNamestring
~ 128文字経験値モデル名
verifyType文字列列挙型
enum {
  “less”,
  “lessEqual”,
  “greater”,
  “greaterEqual”,
  “equal”,
  “notEqual”
}
検証の種類
定義説明
“less”ランクが指定値未満であること
“lessEqual”ランクが指定値以下であること
“greater”ランクが指定値超過であること
“greaterEqual”ランクが指定値以上であること
“equal”ランクが指定値と一致すること
“notEqual”ランクが指定値と一致しないこと
propertyIdstring
~ 1024文字プロパティID
rankValuelong
00 ~ 9223372036854775805現在のランク
multiplyValueSpecifyingQuantitybool
false数量指定した際に、検証に使用する値も乗算するか
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Experience:VerifyRankByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "experienceName": "[string]経験値モデル名",
        "verifyType": "[string]検証の種類",
        "propertyId": "[string]プロパティID",
        "rankValue": "[long]現在のランク",
        "multiplyValueSpecifyingQuantity": "[bool]数量指定した際に、検証に使用する値も乗算するか",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Experience:VerifyRankByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  experienceName: "[string]経験値モデル名"
  verifyType: "[string]検証の種類"
  propertyId: "[string]プロパティID"
  rankValue: "[long]現在のランク"
  multiplyValueSpecifyingQuantity: "[bool]数量指定した際に、検証に使用する値も乗算するか"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("experience").verify.verify_rank_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    experienceName="[string]経験値モデル名",
    verifyType="[string]検証の種類",
    propertyId="[string]プロパティID",
    rankValue="[long]現在のランク",
    multiplyValueSpecifyingQuantity="[bool]数量指定した際に、検証に使用する値も乗算するか",
    timeOffsetToken="[string]タイムオフセットトークン",
})

Gs2Experience:VerifyRankCapByUserId

ユーザーIDを指定してランクキャップを検証

数量指定可能なアクション:いいえ

有効化条件必須デフォルト値の制限説明
namespaceNamestring
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
experienceNamestring
~ 128文字経験値モデル名
verifyType文字列列挙型
enum {
  “less”,
  “lessEqual”,
  “greater”,
  “greaterEqual”,
  “equal”,
  “notEqual”
}
検証の種類
定義説明
“less”ランクキャップが指定値未満であること
“lessEqual”ランクキャップが指定値以下であること
“greater”ランクキャップが指定値超過であること
“greaterEqual”ランクキャップが指定値以上であること
“equal”ランクキャップが指定値と一致すること
“notEqual”ランクキャップが指定値と一致しないこと
propertyIdstring
~ 1024文字プロパティID
rankCapValuelong
0 ~ 9223372036854775805現在のランクキャップ
multiplyValueSpecifyingQuantitybool
false数量指定した際に、検証に使用する値も乗算するか
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Experience:VerifyRankCapByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "experienceName": "[string]経験値モデル名",
        "verifyType": "[string]検証の種類",
        "propertyId": "[string]プロパティID",
        "rankCapValue": "[long]現在のランクキャップ",
        "multiplyValueSpecifyingQuantity": "[bool]数量指定した際に、検証に使用する値も乗算するか",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Experience:VerifyRankCapByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  experienceName: "[string]経験値モデル名"
  verifyType: "[string]検証の種類"
  propertyId: "[string]プロパティID"
  rankCapValue: "[long]現在のランクキャップ"
  multiplyValueSpecifyingQuantity: "[bool]数量指定した際に、検証に使用する値も乗算するか"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("experience").verify.verify_rank_cap_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    experienceName="[string]経験値モデル名",
    verifyType="[string]検証の種類",
    propertyId="[string]プロパティID",
    rankCapValue="[long]現在のランクキャップ",
    multiplyValueSpecifyingQuantity="[bool]数量指定した際に、検証に使用する値も乗算するか",
    timeOffsetToken="[string]タイムオフセットトークン",
})

ConsumeAction

消費アクション

Gs2Experience:SubExperienceByUserId

ユーザーIDを指定して経験値を減算

数量指定可能なアクション:はい

反転可能なアクション:はい

有効化条件必須デフォルト値の制限説明
namespaceNamestring
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
experienceNamestring
~ 128文字経験値モデル名
propertyIdstring
~ 1024文字プロパティID
experienceValuelong
00 ~ 9223372036854775805失う経験値
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Experience:SubExperienceByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "experienceName": "[string]経験値モデル名",
        "propertyId": "[string]プロパティID",
        "experienceValue": "[long]失う経験値",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Experience:SubExperienceByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  experienceName: "[string]経験値モデル名"
  propertyId: "[string]プロパティID"
  experienceValue: "[long]失う経験値"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("experience").consume.sub_experience_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    experienceName="[string]経験値モデル名",
    propertyId="[string]プロパティID",
    experienceValue="[long]失う経験値",
    timeOffsetToken="[string]タイムオフセットトークン",
})

Gs2Experience:SubRankCapByUserId

ユーザーIDを指定してランクキャップを減算

数量指定可能なアクション:はい

反転可能なアクション:はい

有効化条件必須デフォルト値の制限説明
namespaceNamestring
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
experienceNamestring
~ 128文字経験値モデル名
propertyIdstring
~ 1024文字プロパティID
rankCapValuelong
0 ~ 9223372036854775805現在のランクキャップ
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Experience:SubRankCapByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "experienceName": "[string]経験値モデル名",
        "propertyId": "[string]プロパティID",
        "rankCapValue": "[long]現在のランクキャップ",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Experience:SubRankCapByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  experienceName: "[string]経験値モデル名"
  propertyId: "[string]プロパティID"
  rankCapValue: "[long]現在のランクキャップ"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("experience").consume.sub_rank_cap_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    experienceName="[string]経験値モデル名",
    propertyId="[string]プロパティID",
    rankCapValue="[long]現在のランクキャップ",
    timeOffsetToken="[string]タイムオフセットトークン",
})

AcquireAction

入手アクション

Gs2Experience:AddExperienceByUserId

ユーザーIDを指定して経験値を加算

数量指定可能なアクション:はい

反転可能なアクション:はい

有効化条件必須デフォルト値の制限説明
namespaceNamestring
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
experienceNamestring
~ 128文字経験値モデル名
propertyIdstring
~ 1024文字プロパティID
experienceValuelong
00 ~ 9223372036854775805獲得経験値
truncateExperienceWhenRankUpbool?falseランクアップ時に残りの経験値を切り捨てるか
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Experience:AddExperienceByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "experienceName": "[string]経験値モデル名",
        "propertyId": "[string]プロパティID",
        "experienceValue": "[long]獲得経験値",
        "truncateExperienceWhenRankUp": "[bool]ランクアップ時に残りの経験値を切り捨てるか",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Experience:AddExperienceByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  experienceName: "[string]経験値モデル名"
  propertyId: "[string]プロパティID"
  experienceValue: "[long]獲得経験値"
  truncateExperienceWhenRankUp: "[bool]ランクアップ時に残りの経験値を切り捨てるか"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("experience").acquire.add_experience_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    experienceName="[string]経験値モデル名",
    propertyId="[string]プロパティID",
    experienceValue="[long]獲得経験値",
    truncateExperienceWhenRankUp="[bool]ランクアップ時に残りの経験値を切り捨てるか",
    timeOffsetToken="[string]タイムオフセットトークン",
})

Gs2Experience:SetExperienceByUserId

ユーザーIDを指定して経験値を設定

数量指定可能なアクション:はい

反転可能なアクション:はい

有効化条件必須デフォルト値の制限説明
namespaceNamestring
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
experienceNamestring
~ 128文字経験値モデル名
propertyIdstring
~ 1024文字プロパティID
experienceValuelong
00 ~ 9223372036854775805累計獲得経験値
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Experience:SetExperienceByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "experienceName": "[string]経験値モデル名",
        "propertyId": "[string]プロパティID",
        "experienceValue": "[long]累計獲得経験値",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Experience:SetExperienceByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  experienceName: "[string]経験値モデル名"
  propertyId: "[string]プロパティID"
  experienceValue: "[long]累計獲得経験値"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("experience").acquire.set_experience_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    experienceName="[string]経験値モデル名",
    propertyId="[string]プロパティID",
    experienceValue="[long]累計獲得経験値",
    timeOffsetToken="[string]タイムオフセットトークン",
})

Gs2Experience:AddRankCapByUserId

ユーザーIDを指定してランクキャップを加算

数量指定可能なアクション:はい

反転可能なアクション:はい

有効化条件必須デフォルト値の制限説明
namespaceNamestring
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
experienceNamestring
~ 128文字経験値モデル名
propertyIdstring
~ 1024文字プロパティID
rankCapValuelong
0 ~ 9223372036854775805現在のランクキャップ
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Experience:AddRankCapByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "experienceName": "[string]経験値モデル名",
        "propertyId": "[string]プロパティID",
        "rankCapValue": "[long]現在のランクキャップ",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Experience:AddRankCapByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  experienceName: "[string]経験値モデル名"
  propertyId: "[string]プロパティID"
  rankCapValue: "[long]現在のランクキャップ"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("experience").acquire.add_rank_cap_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    experienceName="[string]経験値モデル名",
    propertyId="[string]プロパティID",
    rankCapValue="[long]現在のランクキャップ",
    timeOffsetToken="[string]タイムオフセットトークン",
})

Gs2Experience:SetRankCapByUserId

ユーザーIDを指定してランクキャップを設定

数量指定可能なアクション:いいえ

反転可能なアクション:いいえ

有効化条件必須デフォルト値の制限説明
namespaceNamestring
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
experienceNamestring
~ 128文字経験値モデル名
propertyIdstring
~ 1024文字プロパティID
rankCapValuelong
0 ~ 9223372036854775805現在のランクキャップ
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Experience:SetRankCapByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "experienceName": "[string]経験値モデル名",
        "propertyId": "[string]プロパティID",
        "rankCapValue": "[long]現在のランクキャップ",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Experience:SetRankCapByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  experienceName: "[string]経験値モデル名"
  propertyId: "[string]プロパティID"
  rankCapValue: "[long]現在のランクキャップ"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("experience").acquire.set_rank_cap_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    experienceName="[string]経験値モデル名",
    propertyId="[string]プロパティID",
    rankCapValue="[long]現在のランクキャップ",
    timeOffsetToken="[string]タイムオフセットトークン",
})

Gs2Experience:MultiplyAcquireActionsByUserId

ユーザーIDを指定して経験値の対象プロパティのランクに応じてリソースを加算

数量指定可能なアクション:はい

反転可能なアクション:いいえ

有効化条件必須デフォルト値の制限説明
namespaceNamestring
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
experienceNamestring
~ 128文字経験値モデル名
propertyIdstring
~ 1024文字プロパティID
rateNamestring
~ 128文字報酬加算テーブル名
acquireActionsList<AcquireAction>[]0 ~ 100 items入手アクションリスト
baseRatefloat
10 ~ 1000000基礎倍率
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Experience:MultiplyAcquireActionsByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "experienceName": "[string]経験値モデル名",
        "propertyId": "[string]プロパティID",
        "rateName": "[string]報酬加算テーブル名",
        "acquireActions": [
            {
                "action": "[string]入手アクションで実行するアクションの種類",
                "request": "[string]アクション実行時に使用されるリクエストのJSON文字列"
            }
        ],
        "baseRate": "[float]基礎倍率",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Experience:MultiplyAcquireActionsByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  experienceName: "[string]経験値モデル名"
  propertyId: "[string]プロパティID"
  rateName: "[string]報酬加算テーブル名"
  acquireActions: 
    - action: "[string]入手アクションで実行するアクションの種類"
      request: "[string]アクション実行時に使用されるリクエストのJSON文字列"
  baseRate: "[float]基礎倍率"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("experience").acquire.multiply_acquire_actions_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    experienceName="[string]経験値モデル名",
    propertyId="[string]プロパティID",
    rateName="[string]報酬加算テーブル名",
    acquireActions={
        {
            action="[string]入手アクションで実行するアクションの種類",
            request="[string]アクション実行時に使用されるリクエストのJSON文字列"
        }
    },
    baseRate="[float]基礎倍率",
    timeOffsetToken="[string]タイムオフセットトークン",
})