> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Showcase トランザクションアクション

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





## Consume Action

消費アクション

### Gs2Showcase:IncrementPurchaseCountByUserId

ユーザーIDを指定して購入回数を加算<br>

指定されたユーザーのランダム陳列棚の特定の商品の購入回数を加算します。ローテーション期間ごとの購入制限を追跡するために使用されます。

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

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

|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128文字 | ネームスペース名<br>ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 |
| showcaseName | string |  | ✓|  |  ~ 128文字 | ランダム陳列棚名 |
| displayItemName | string |  | ✓|  |  ~ 128文字 | 商品購入回数名<br>購入回数を追跡するランダム陳列商品の名前です。ランダム陳列棚内の陳列商品名に対応します。 |
| userId | string |  | ✓|  |  ~ 128文字 | ユーザーID<br>`#{userId}` と設定することでログイン中のユーザーIDに置換されます。 |
| count | int |  | ✓|  | 0 ~ 100 | 加算する購入回数 |
| timeOffsetToken | string |  | |  |  ~ 1024文字 | タイムオフセットトークン |




**JSON**
```json
{
    "action": "Gs2Showcase:IncrementPurchaseCountByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "showcaseName": "[string]ランダム陳列棚名",
        "displayItemName": "[string]商品購入回数名",
        "userId": "[string]ユーザーID",
        "count": "[int]加算する購入回数",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
```

**YAML**
```yaml

action: Gs2Showcase:IncrementPurchaseCountByUserId
request:
  namespaceName: "[string]ネームスペース名"
  showcaseName: "[string]ランダム陳列棚名"
  displayItemName: "[string]商品購入回数名"
  userId: "[string]ユーザーID"
  count: "[int]加算する購入回数"
  timeOffsetToken: "[string]タイムオフセットトークン"
```

**GS2-Script**
```lua

transaction.service("showcase").consume.increment_purchase_count_by_user_id({
    namespaceName="[string]ネームスペース名",
    showcaseName="[string]ランダム陳列棚名",
    displayItemName="[string]商品購入回数名",
    userId="[string]ユーザーID",
    count="[int]加算する購入回数",
    timeOffsetToken="[string]タイムオフセットトークン",
})
```


---

## Acquire Action

入手アクション

### Gs2Showcase:DecrementPurchaseCountByUserId

ユーザーIDを指定して購入回数を減算<br>

ランダム陳列棚の特定の商品の購入回数を減算します。購入の取り消しや購入カウンターの調整に使用されます。

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

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

|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128文字 | ネームスペース名<br>ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 |
| showcaseName | string |  | ✓|  |  ~ 128文字 | ランダム陳列棚名 |
| displayItemName | string |  | ✓|  |  ~ 128文字 | 商品購入回数名<br>購入回数を追跡するランダム陳列商品の名前です。ランダム陳列棚内の陳列商品名に対応します。 |
| userId | string |  | ✓|  |  ~ 128文字 | ユーザーID<br>`#{userId}` と設定することでログイン中のユーザーIDに置換されます。 |
| count | int |  | ✓|  | 0 ~ 100 | 減算する購入回数 |
| timeOffsetToken | string |  | |  |  ~ 1024文字 | タイムオフセットトークン |




**JSON**
```json
{
    "action": "Gs2Showcase:DecrementPurchaseCountByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "showcaseName": "[string]ランダム陳列棚名",
        "displayItemName": "[string]商品購入回数名",
        "userId": "[string]ユーザーID",
        "count": "[int]減算する購入回数",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
```

**YAML**
```yaml

action: Gs2Showcase:DecrementPurchaseCountByUserId
request:
  namespaceName: "[string]ネームスペース名"
  showcaseName: "[string]ランダム陳列棚名"
  displayItemName: "[string]商品購入回数名"
  userId: "[string]ユーザーID"
  count: "[int]減算する購入回数"
  timeOffsetToken: "[string]タイムオフセットトークン"
```

**GS2-Script**
```lua

transaction.service("showcase").acquire.decrement_purchase_count_by_user_id({
    namespaceName="[string]ネームスペース名",
    showcaseName="[string]ランダム陳列棚名",
    displayItemName="[string]商品購入回数名",
    userId="[string]ユーザーID",
    count="[int]減算する購入回数",
    timeOffsetToken="[string]タイムオフセットトークン",
})
```


---

### Gs2Showcase:ForceReDrawByUserId

ユーザーIDを指定してランダム陳列棚の内容を再抽選<br>

指定されたユーザーのランダム陳列棚の商品を強制的に再抽選し、現在の選択をリセットして設定されたプールから新しいランダム商品の選択をトリガーします。

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

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

|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128文字 | ネームスペース名<br>ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 |
| showcaseName | string |  | ✓|  |  ~ 128文字 | ランダム陳列棚名 |
| userId | string |  | ✓|  |  ~ 128文字 | ユーザーID<br>`#{userId}` と設定することでログイン中のユーザーIDに置換されます。 |
| timeOffsetToken | string |  | |  |  ~ 1024文字 | タイムオフセットトークン |




**JSON**
```json
{
    "action": "Gs2Showcase:ForceReDrawByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "showcaseName": "[string]ランダム陳列棚名",
        "userId": "[string]ユーザーID",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
```

**YAML**
```yaml

action: Gs2Showcase:ForceReDrawByUserId
request:
  namespaceName: "[string]ネームスペース名"
  showcaseName: "[string]ランダム陳列棚名"
  userId: "[string]ユーザーID"
  timeOffsetToken: "[string]タイムオフセットトークン"
```

**GS2-Script**
```lua

transaction.service("showcase").acquire.force_re_draw_by_user_id({
    namespaceName="[string]ネームスペース名",
    showcaseName="[string]ランダム陳列棚名",
    userId="[string]ユーザーID",
    timeOffsetToken="[string]タイムオフセットトークン",
})
```


---