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

# GS2-Ranking2 트랜잭션 액션

검증/소비/입수 각 트랜잭션 액션의 사양




## Verify Action

검증 액션

### Gs2Ranking2:VerifyGlobalRankingScoreByUserId

사용자 ID를 지정하여 글로벌 랭킹의 스코어 검증<br>

지정한 사용자의 글로벌 랭킹 스코어를 비교 연산자(less, lessEqual, greater, greaterEqual, equal, notEqual)를 사용하여 지정한 값과 비교 검증합니다.

**수량 지정 가능한 액션: 예**

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128자 | 네임스페이스 이름<br>네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| userId | string |  | ✓|  |  ~ 128자 | 사용자ID<br>`#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다. |
| rankingName | string |  | ✓|  |  ~ 128자 | 글로벌 랭킹 모델 이름<br>글로벌 랭킹 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| verifyType | 문자열 열거형<br>enum {<br>"less",<br>"lessEqual",<br>"greater",<br>"greaterEqual",<br>"equal",<br>"notEqual"<br>}<br> |  | ✓|  |  | 검증 종류less: 스코어가 지정값 미만일 것 / lessEqual: 스코어가 지정값 이하일 것 / greater: 스코어가 지정값 초과일 것 / greaterEqual: 스코어가 지정값 이상일 것 / equal: 스코어가 지정값과 일치할 것 / notEqual: 스코어가 지정값과 일치하지 않을 것 /  |
| season | long |  | |  | 0 ~ 9223372036854775805 | 시즌 |
| score | long |  | ✓|  | 0 ~ 9223372036854775805 | 스코어<br>사용자가 등록한 스코어 값입니다. 랭킹 모델의 minimumValue와 maximumValue로 정의된 범위 내에 있어야 합니다. |
| multiplyValueSpecifyingQuantity | bool |  | | true |  | 수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부 |
| timeOffsetToken | string |  | |  |  ~ 1024자 | 타임 오프셋 토큰 |




**JSON**
```json
{
    "action": "Gs2Ranking2:VerifyGlobalRankingScoreByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "userId": "[string]사용자ID",
        "rankingName": "[string]글로벌 랭킹 모델 이름",
        "verifyType": "[string]검증 종류",
        "season": "[long]시즌",
        "score": "[long]스코어",
        "multiplyValueSpecifyingQuantity": "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}
```

**YAML**
```yaml

action: Gs2Ranking2:VerifyGlobalRankingScoreByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  userId: "[string]사용자ID"
  rankingName: "[string]글로벌 랭킹 모델 이름"
  verifyType: "[string]검증 종류"
  season: "[long]시즌"
  score: "[long]스코어"
  multiplyValueSpecifyingQuantity: "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부"
  timeOffsetToken: "[string]타임 오프셋 토큰"
```

**GS2-Script**
```lua

transaction.service("ranking2").verify.verify_global_ranking_score_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    userId="[string]사용자ID",
    rankingName="[string]글로벌 랭킹 모델 이름",
    verifyType="[string]검증 종류",
    season="[long]시즌",
    score="[long]스코어",
    multiplyValueSpecifyingQuantity="[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
    timeOffsetToken="[string]타임 오프셋 토큰",
})
```


---

### Gs2Ranking2:VerifyClusterRankingScoreByUserId

사용자 ID를 지정하여 클러스터 랭킹의 스코어 검증<br>

지정한 사용자의 클러스터 랭킹 스코어를 비교 연산자(less, lessEqual, greater, greaterEqual, equal, notEqual)를 사용하여 지정한 값과 비교 검증합니다.

**수량 지정 가능한 액션: 예**

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128자 | 네임스페이스 이름<br>네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| userId | string |  | ✓|  |  ~ 128자 | 사용자ID<br>`#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다. |
| rankingName | string |  | ✓|  |  ~ 128자 | 클러스터 랭킹 모델 이름<br>클러스터 랭킹 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| clusterName | string |  | ✓|  |  ~ 1024자 | 클러스터 이름<br>이 스코어가 속한 클러스터(길드, 개더링, 또는 임의의 그룹)의 이름입니다. 클러스터 타입 설정에 따라 사용자의 소속이 검증됩니다. |
| verifyType | 문자열 열거형<br>enum {<br>"less",<br>"lessEqual",<br>"greater",<br>"greaterEqual",<br>"equal",<br>"notEqual"<br>}<br> |  | ✓|  |  | 검증 종류less: 스코어가 지정값 미만일 것 / lessEqual: 스코어가 지정값 이하일 것 / greater: 스코어가 지정값 초과일 것 / greaterEqual: 스코어가 지정값 이상일 것 / equal: 스코어가 지정값과 일치할 것 / notEqual: 스코어가 지정값과 일치하지 않을 것 /  |
| season | long |  | |  | 0 ~ 9223372036854775805 | 시즌 |
| score | long |  | ✓|  | 0 ~ 9223372036854775805 | 스코어<br>이 클러스터 내에서 사용자가 등록한 스코어 값입니다. |
| multiplyValueSpecifyingQuantity | bool |  | | true |  | 수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부 |
| timeOffsetToken | string |  | |  |  ~ 1024자 | 타임 오프셋 토큰 |




**JSON**
```json
{
    "action": "Gs2Ranking2:VerifyClusterRankingScoreByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "userId": "[string]사용자ID",
        "rankingName": "[string]클러스터 랭킹 모델 이름",
        "clusterName": "[string]클러스터 이름",
        "verifyType": "[string]검증 종류",
        "season": "[long]시즌",
        "score": "[long]스코어",
        "multiplyValueSpecifyingQuantity": "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}
```

**YAML**
```yaml

action: Gs2Ranking2:VerifyClusterRankingScoreByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  userId: "[string]사용자ID"
  rankingName: "[string]클러스터 랭킹 모델 이름"
  clusterName: "[string]클러스터 이름"
  verifyType: "[string]검증 종류"
  season: "[long]시즌"
  score: "[long]스코어"
  multiplyValueSpecifyingQuantity: "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부"
  timeOffsetToken: "[string]타임 오프셋 토큰"
```

**GS2-Script**
```lua

transaction.service("ranking2").verify.verify_cluster_ranking_score_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    userId="[string]사용자ID",
    rankingName="[string]클러스터 랭킹 모델 이름",
    clusterName="[string]클러스터 이름",
    verifyType="[string]검증 종류",
    season="[long]시즌",
    score="[long]스코어",
    multiplyValueSpecifyingQuantity="[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
    timeOffsetToken="[string]타임 오프셋 토큰",
})
```


---

### Gs2Ranking2:VerifySubscribeRankingScoreByUserId

사용자 ID를 지정하여 구독 랭킹의 스코어를 검증<br>

지정한 사용자의 구독 랭킹 스코어를 비교 연산자(less, lessEqual, greater, greaterEqual, equal, notEqual)를 사용하여 지정한 값과 비교 검증합니다.

**수량 지정 가능한 액션: 예**

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128자 | 네임스페이스 이름<br>네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| userId | string |  | ✓|  |  ~ 128자 | 사용자ID<br>`#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다. |
| rankingName | string |  | ✓|  |  ~ 128자 | 구독 랭킹 모델 이름<br>구독 랭킹 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| verifyType | 문자열 열거형<br>enum {<br>"less",<br>"lessEqual",<br>"greater",<br>"greaterEqual",<br>"equal",<br>"notEqual"<br>}<br> |  | ✓|  |  | 검증 종류less: 스코어가 지정값 미만일 것 / lessEqual: 스코어가 지정값 이하일 것 / greater: 스코어가 지정값 초과일 것 / greaterEqual: 스코어가 지정값 이상일 것 / equal: 스코어가 지정값과 일치할 것 / notEqual: 스코어가 지정값과 일치하지 않을 것 /  |
| season | long |  | |  | 0 ~ 9223372036854775805 | 시즌 |
| score | long |  | ✓|  | 0 ~ 9223372036854775805 | 스코어 |
| multiplyValueSpecifyingQuantity | bool |  | | true |  | 수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부 |
| timeOffsetToken | string |  | |  |  ~ 1024자 | 타임 오프셋 토큰 |




**JSON**
```json
{
    "action": "Gs2Ranking2:VerifySubscribeRankingScoreByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "userId": "[string]사용자ID",
        "rankingName": "[string]구독 랭킹 모델 이름",
        "verifyType": "[string]검증 종류",
        "season": "[long]시즌",
        "score": "[long]스코어",
        "multiplyValueSpecifyingQuantity": "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}
```

**YAML**
```yaml

action: Gs2Ranking2:VerifySubscribeRankingScoreByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  userId: "[string]사용자ID"
  rankingName: "[string]구독 랭킹 모델 이름"
  verifyType: "[string]검증 종류"
  season: "[long]시즌"
  score: "[long]스코어"
  multiplyValueSpecifyingQuantity: "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부"
  timeOffsetToken: "[string]타임 오프셋 토큰"
```

**GS2-Script**
```lua

transaction.service("ranking2").verify.verify_subscribe_ranking_score_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    userId="[string]사용자ID",
    rankingName="[string]구독 랭킹 모델 이름",
    verifyType="[string]검증 종류",
    season="[long]시즌",
    score="[long]스코어",
    multiplyValueSpecifyingQuantity="[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
    timeOffsetToken="[string]타임 오프셋 토큰",
})
```


---

## Consume Action

소비 액션

### Gs2Ranking2:CreateGlobalRankingReceivedRewardByUserId

사용자 ID를 지정하여 글로벌 랭킹 보상 수령 이력 기록<br>

지정한 사용자를 대신하여, 지정한 글로벌 랭킹의 보상 수령 이력을 기록합니다.

**수량 지정 가능한 액션: 아니오**

**반전 가능한 액션: 아니오**

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128자 | 네임스페이스 이름<br>네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| rankingName | string |  | ✓|  |  ~ 128자 | 글로벌 랭킹 모델 이름<br>글로벌 랭킹 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| userId | string |  | ✓|  |  ~ 128자 | 사용자ID<br>`#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다. |
| season | long |  | |  | 0 ~ 9223372036854775805 | 시즌 |
| timeOffsetToken | string |  | |  |  ~ 1024자 | 타임 오프셋 토큰 |




**JSON**
```json
{
    "action": "Gs2Ranking2:CreateGlobalRankingReceivedRewardByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "rankingName": "[string]글로벌 랭킹 모델 이름",
        "userId": "[string]사용자ID",
        "season": "[long]시즌",
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}
```

**YAML**
```yaml

action: Gs2Ranking2:CreateGlobalRankingReceivedRewardByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  rankingName: "[string]글로벌 랭킹 모델 이름"
  userId: "[string]사용자ID"
  season: "[long]시즌"
  timeOffsetToken: "[string]타임 오프셋 토큰"
```

**GS2-Script**
```lua

transaction.service("ranking2").consume.create_global_ranking_received_reward_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    rankingName="[string]글로벌 랭킹 모델 이름",
    userId="[string]사용자ID",
    season="[long]시즌",
    timeOffsetToken="[string]타임 오프셋 토큰",
})
```


---

### Gs2Ranking2:CreateClusterRankingReceivedRewardByUserId

사용자 ID를 지정하여 클러스터 랭킹 보상 수령 이력 기록<br>

지정한 사용자를 대신하여, 지정한 클러스터 랭킹 및 클러스터의 보상 수령 이력을 기록합니다.

**수량 지정 가능한 액션: 아니오**

**반전 가능한 액션: 아니오**

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128자 | 네임스페이스 이름<br>네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| rankingName | string |  | ✓|  |  ~ 128자 | 클러스터 랭킹 모델 이름<br>클러스터 랭킹 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| clusterName | string |  | ✓|  |  ~ 1024자 | 클러스터 이름<br>랭킹 보상을 수령한 클러스터의 이름입니다. |
| userId | string |  | ✓|  |  ~ 128자 | 사용자ID<br>`#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다. |
| season | long |  | |  | 0 ~ 9223372036854775805 | 시즌 |
| timeOffsetToken | string |  | |  |  ~ 1024자 | 타임 오프셋 토큰 |




**JSON**
```json
{
    "action": "Gs2Ranking2:CreateClusterRankingReceivedRewardByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "rankingName": "[string]클러스터 랭킹 모델 이름",
        "clusterName": "[string]클러스터 이름",
        "userId": "[string]사용자ID",
        "season": "[long]시즌",
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}
```

**YAML**
```yaml

action: Gs2Ranking2:CreateClusterRankingReceivedRewardByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  rankingName: "[string]클러스터 랭킹 모델 이름"
  clusterName: "[string]클러스터 이름"
  userId: "[string]사용자ID"
  season: "[long]시즌"
  timeOffsetToken: "[string]타임 오프셋 토큰"
```

**GS2-Script**
```lua

transaction.service("ranking2").consume.create_cluster_ranking_received_reward_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    rankingName="[string]클러스터 랭킹 모델 이름",
    clusterName="[string]클러스터 이름",
    userId="[string]사용자ID",
    season="[long]시즌",
    timeOffsetToken="[string]타임 오프셋 토큰",
})
```


---