GS2-Grade トランザクションアクション
検証/消費/入手の各トランザクションアクションの仕様
VerifyAction
検証アクション
Gs2Grade:VerifyGradeByUserId
ユーザーIDを指定してグレードを検証
数量指定可能なアクション:いいえ
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||||||||||||||||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||||||||||||||||
| gradeName | string | ✓ | ~ 128文字 | グレードモデル名 | ||||||||||||||||
| verifyType | 文字列列挙型 enum { “less”, “lessEqual”, “greater”, “greaterEqual”, “equal”, “notEqual” } | ✓ | 検証の種類
| |||||||||||||||||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID | ||||||||||||||||
| gradeValue | long | ✓ | 1 | 1 ~ 9223372036854775805 | 現在のグレード | |||||||||||||||
| multiplyValueSpecifyingQuantity | bool | ✓ | false | 数量指定した際に、検証に使用する値も乗算するか | ||||||||||||||||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Grade:VerifyGradeByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"gradeName": "[string]グレードモデル名",
"verifyType": "[string]検証の種類",
"propertyId": "[string]プロパティID",
"gradeValue": "[long]現在のグレード",
"multiplyValueSpecifyingQuantity": "[bool]数量指定した際に、検証に使用する値も乗算するか",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Grade:VerifyGradeByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
gradeName: "[string]グレードモデル名"
verifyType: "[string]検証の種類"
propertyId: "[string]プロパティID"
gradeValue: "[long]現在のグレード"
multiplyValueSpecifyingQuantity: "[bool]数量指定した際に、検証に使用する値も乗算するか"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("grade").verify.verify_grade_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
gradeName="[string]グレードモデル名",
verifyType="[string]検証の種類",
propertyId="[string]プロパティID",
gradeValue="[long]現在のグレード",
multiplyValueSpecifyingQuantity="[bool]数量指定した際に、検証に使用する値も乗算するか",
timeOffsetToken="[string]タイムオフセットトークン",
})Gs2Grade:VerifyGradeUpMaterialByUserId
ユーザーIDを指定してグレードアップに使用する素材を検証
数量指定可能なアクション:いいえ
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||||||||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||||||||
| gradeName | string | ✓ | ~ 128文字 | グレードモデル名 | ||||||||
| verifyType | 文字列列挙型 enum { “match”, “notMatch” } | ✓ | 検証の種類
| |||||||||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID | ||||||||
| materialPropertyId | string | ✓ | ~ 1024文字 | プロパティID | ||||||||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Grade:VerifyGradeUpMaterialByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"gradeName": "[string]グレードモデル名",
"verifyType": "[string]検証の種類",
"propertyId": "[string]プロパティID",
"materialPropertyId": "[string]プロパティID",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Grade:VerifyGradeUpMaterialByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
gradeName: "[string]グレードモデル名"
verifyType: "[string]検証の種類"
propertyId: "[string]プロパティID"
materialPropertyId: "[string]プロパティID"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("grade").verify.verify_grade_up_material_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
gradeName="[string]グレードモデル名",
verifyType="[string]検証の種類",
propertyId="[string]プロパティID",
materialPropertyId="[string]プロパティID",
timeOffsetToken="[string]タイムオフセットトークン",
})ConsumeAction
消費アクション
Gs2Grade:SubGradeByUserId
ユーザーIDを指定してグレードを減算
数量指定可能なアクション:はい
反転可能なアクション:はい
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| gradeName | string | ✓ | ~ 128文字 | グレードモデル名 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID | ||
| gradeValue | long | ✓ | 0 | 0 ~ 9223372036854775805 | 失うグレード | |
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Grade:SubGradeByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"gradeName": "[string]グレードモデル名",
"propertyId": "[string]プロパティID",
"gradeValue": "[long]失うグレード",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Grade:SubGradeByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
gradeName: "[string]グレードモデル名"
propertyId: "[string]プロパティID"
gradeValue: "[long]失うグレード"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("grade").consume.sub_grade_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
gradeName="[string]グレードモデル名",
propertyId="[string]プロパティID",
gradeValue="[long]失うグレード",
timeOffsetToken="[string]タイムオフセットトークン",
})AcquireAction
入手アクション
Gs2Grade:AddGradeByUserId
ユーザーIDを指定してグレードを加算
数量指定可能なアクション:はい
反転可能なアクション:はい
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| gradeName | string | ✓ | ~ 128文字 | グレードモデル名 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID | ||
| gradeValue | long | ✓ | 0 | 0 ~ 9223372036854775805 | 獲得グレード | |
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Grade:AddGradeByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"gradeName": "[string]グレードモデル名",
"propertyId": "[string]プロパティID",
"gradeValue": "[long]獲得グレード",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Grade:AddGradeByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
gradeName: "[string]グレードモデル名"
propertyId: "[string]プロパティID"
gradeValue: "[long]獲得グレード"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("grade").acquire.add_grade_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
gradeName="[string]グレードモデル名",
propertyId="[string]プロパティID",
gradeValue="[long]獲得グレード",
timeOffsetToken="[string]タイムオフセットトークン",
})Gs2Grade:ApplyRankCapByUserId
ユーザーIDを指定して GS2-Experienceステータスにランクキャップを適用
数量指定可能なアクション:いいえ
反転可能なアクション:いいえ
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| gradeName | string | ✓ | ~ 128文字 | グレードモデル名 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID | ||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Grade:ApplyRankCapByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"gradeName": "[string]グレードモデル名",
"propertyId": "[string]プロパティID",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Grade:ApplyRankCapByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
gradeName: "[string]グレードモデル名"
propertyId: "[string]プロパティID"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("grade").acquire.apply_rank_cap_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
gradeName="[string]グレードモデル名",
propertyId="[string]プロパティID",
timeOffsetToken="[string]タイムオフセットトークン",
})Gs2Grade:MultiplyAcquireActionsByUserId
ユーザーIDを指定してグレードの対象プロパティのグレードに応じてリソースを加算
数量指定可能なアクション:いいえ
反転可能なアクション:いいえ
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| gradeName | string | ✓ | ~ 128文字 | グレードモデル名 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID | ||
| rateName | string | ✓ | ~ 128文字 | 報酬加算テーブル名 | ||
| acquireActions | List<AcquireAction> | [] | 0 ~ 100 items | 入手アクションリスト | ||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Grade:MultiplyAcquireActionsByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"gradeName": "[string]グレードモデル名",
"propertyId": "[string]プロパティID",
"rateName": "[string]報酬加算テーブル名",
"acquireActions": [
{
"action": "[string]入手アクションで実行するアクションの種類",
"request": "[string]アクション実行時に使用されるリクエストのJSON文字列"
}
],
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Grade:MultiplyAcquireActionsByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
gradeName: "[string]グレードモデル名"
propertyId: "[string]プロパティID"
rateName: "[string]報酬加算テーブル名"
acquireActions:
- action: "[string]入手アクションで実行するアクションの種類"
request: "[string]アクション実行時に使用されるリクエストのJSON文字列"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("grade").acquire.multiply_acquire_actions_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
gradeName="[string]グレードモデル名",
propertyId="[string]プロパティID",
rateName="[string]報酬加算テーブル名",
acquireActions={
{
action="[string]入手アクションで実行するアクションの種類",
request="[string]アクション実行時に使用されるリクエストのJSON文字列"
}
},
timeOffsetToken="[string]タイムオフセットトークン",
})