GS2-LoginReward マスターデータリファレンス
{
"version": "2023-07-11",
"bonusModels": [
{
"name": "[string]ボーナスモデル名",
"metadata": "[string?]メタデータ",
"mode": "[string]モード",
"periodEventId": "[string?]ログインボーナスを有効化する期間を表す GS2-Schedule のイベントGRN",
"resetHour": "[int]受け取りフラグのリセット時間(UTC)",
"repeat": "[string]受け取りフラグのリセット時間(UTC)",
"rewards": [
{
"acquireActions": [
{
"action": "[string]入手アクションで実行するアクションの種類",
"request": "[string]リクエストのJSON"
}
]
}
],
"missedReceiveRelief": "[string]取り逃がし救済機能",
"missedReceiveReliefVerifyActions": [
{
"action": "[string]検証アクションで実行するアクションの種類",
"request": "[string]リクエストのJSON"
}
],
"missedReceiveReliefConsumeActions": [
{
"action": "[string]消費アクションで実行するアクションの種類",
"request": "[string]リクエストのJSON"
}
]
}
]
}
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
version | ✓ | 2023-07-11 | マスターデータのフォーマットバージョン | |||
bonusModels | List<BonusModel> | ~ 100 items | ボーナスモデル |
BonusModel
ボーナスモデル
ログインボーナスの配布スケジュールを設定します。
配布スケジュールには《スケジュールモード》と《ストリーミングモード》があります。
スケジュールモードでは、GS2-Schedule のイベントの指定が必須で、そのイベントの開始日からの経過日数でボーナスの配布を行います。
途中で撮り逃しが発生した場合、その分のボーナスは配布されません。
ストリーミングモードでは、毎日ボーナスに設定された報酬を先頭から順番に配布します。
ストリーミングモードでは繰り返しの設定が可能です。その場合、ストリームの終端に達した場合、先頭から再度配布を行います。
スケジュールモード・ストリーミングモード 共に、取り逃がしの救済機能があります。
一定のコストを支払うことで、取り逃がしたボーナスを受け取ることができます。
ただし、GS2-Schedule のイベントが関連づけられている場合、イベントの開始日からの経過日数より先のボーナスは受け取ることができません。
取り逃がし機能はストリーミングモードかつ繰り返しが有効な場合は使用することができません。
スケジュールモード・ストリーミングモード 共に、設定可能なボーナスの最大日数は100日です。
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
bonusModelId | string | ✓ | ~ 1024文字 | ログインボーナスモデルGRN | ||
name | string | ✓ | ~ 128文字 | ボーナスモデル名 | ||
metadata | string | ~ 2048文字 | メタデータ | |||
mode | enum { “schedule”, “streaming” } | ✓ | ~ 128文字 | モード | ||
periodEventId | string | ~ 1024文字 | ログインボーナスを有効化する期間を表す GS2-Schedule のイベントGRN | |||
resetHour | int | {periodEventId} == "" | ✓ | ~ 23 | 受け取りフラグのリセット時間(UTC) | |
repeat | enum { “enabled”, “disabled” } | {mode} == “streaming” | ✓ | ~ 128文字 | 受け取りフラグのリセット時間(UTC) | |
rewards | List<Reward> | ~ 100 items | 報酬リスト | |||
missedReceiveRelief | enum { “enabled”, “disabled” } | ✓ | “disabled” | ~ 128文字 | 取り逃がし救済機能 | |
missedReceiveReliefVerifyActions | List<VerifyAction> | {missedReceiveRelief} == “enabled” | ~ 10 items | 取り逃がし救済の検証アクションリスト | ||
missedReceiveReliefConsumeActions | List<ConsumeAction> | {missedReceiveRelief} == “enabled” | ~ 10 items | 取り逃がし救済の消費アクションリスト |
mode に指定する列挙型の定義
定義 | 説明 |
---|---|
schedule | スケジュールモード |
streaming | ストリーミングモード |
repeat に指定する列挙型の定義
定義 | 説明 |
---|---|
enabled | 有効 |
disabled | 無効 |
missedReceiveRelief に指定する列挙型の定義
定義 | 説明 |
---|---|
enabled | 有効 |
disabled | 無効 |
Reward
報酬
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
acquireActions | List<AcquireAction> | ✓ | 1 ~ 10 items | 入手アクションリスト |
ConsumeAction
消費アクション
AcquireAction
入手アクション
VerifyAction
検証アクション