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

# GS2-Matchmaking 트랜잭션 액션

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




## Verify Action

검증 액션

### Gs2Matchmaking:VerifyIncludeParticipantByUserId

사용자 ID를 지정하여 영속 개더링에 사용자 ID가 포함되어 있는지 검증<br>

지정된 사용자가 시즌 개더링에 참가하고 있는지 여부를 검증합니다.

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

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128자 | 네임스페이스 이름<br>네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| seasonName | string |  | ✓|  |  ~ 128자 | 시즌 모델 이름<br>시즌 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| season | long |  | ✓|  | 0 ~ 9223372036854775805 | 시즌 |
| tier | long |  | ✓|  | 0 ~ 9223372036854775805 | 티어<br>비슷한 랭크의 플레이어를 그룹화하기 위한 티어 레벨입니다.<br>SeasonModel에서 지정된 GS2-Experience 모델에서의 플레이어 랭크에 따라 결정됩니다.<br>플레이어는 동일한 티어의 플레이어와만 매칭되어 공평한 대전이 보장됩니다. |
| seasonGatheringName | string |  | ✓| UUID |  ~ 128자 | 시즌 게더링명<br>시즌 게더링 고유의 이름입니다. 영숫자 및 -(하이픈), _(언더스코어), .(마침표)로 지정합니다. |
| userId | string |  | ✓|  |  ~ 128자 | 사용자ID<br>`#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다. |
| verifyType | 문자열 열거형<br>enum {<br>"include",<br>"notInclude"<br>}<br> |  | ✓|  |  | 검증 종류include: 시즌 개더링에 지정한 사용자가 포함되어 있음 / notInclude: 시즌 개더링에 지정한 사용자가 포함되지 않음 /  |
| timeOffsetToken | string |  | |  |  ~ 1024자 | 타임 오프셋 토큰 |




**JSON**
```json
{
    "action": "Gs2Matchmaking:VerifyIncludeParticipantByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "seasonName": "[string]시즌 모델 이름",
        "season": "[long]시즌",
        "tier": "[long]티어",
        "seasonGatheringName": "[string]시즌 게더링명",
        "userId": "[string]사용자ID",
        "verifyType": "[string]검증 종류",
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}
```

**YAML**
```yaml

action: Gs2Matchmaking:VerifyIncludeParticipantByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  seasonName: "[string]시즌 모델 이름"
  season: "[long]시즌"
  tier: "[long]티어"
  seasonGatheringName: "[string]시즌 게더링명"
  userId: "[string]사용자ID"
  verifyType: "[string]검증 종류"
  timeOffsetToken: "[string]타임 오프셋 토큰"
```

**GS2-Script**
```lua

transaction.service("matchmaking").verify.verify_include_participant_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    seasonName="[string]시즌 모델 이름",
    season="[long]시즌",
    tier="[long]티어",
    seasonGatheringName="[string]시즌 게더링명",
    userId="[string]사용자ID",
    verifyType="[string]검증 종류",
    timeOffsetToken="[string]타임 오프셋 토큰",
})
```


---