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

# GS2-Dictionary 트랜잭션 액션

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




## Verify Action

검증 액션

### Gs2Dictionary:VerifyEntryByUserId

사용자 ID를 지정하여 엔트리 검증<br>

지정한 사용자가 특정 엔트리를 수집했는지 여부를 검증합니다.<br>
검증 타입으로 조건을 지정합니다：'have'는 사용자가 엔트리를 보유하고 있는지 확인하고, 'havent'는 보유하고 있지 않은지 확인합니다.<br>
검증에 실패한 경우, 오류가 반환됩니다.

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

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128자 | 네임스페이스 이름<br>네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| userId | string |  | ✓|  |  ~ 128자 | 사용자ID<br>`#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다. |
| entryModelName | string |  | ✓|  |  ~ 128자 | 엔트리 모델 이름<br>엔트리 모델 고유 이름입니다. 영숫자 및 -(하이픈), _(언더스코어), .(마침표)로 지정합니다. |
| verifyType | 문자열 열거형<br>enum {<br>"havent",<br>"have"<br>}<br> |  | ✓|  |  | 검증 종류havent: 지정한 엔트리를 보유하고 있지 않을 것 / have: 지정한 엔트리를 보유하고 있을 것 /  |
| timeOffsetToken | string |  | |  |  ~ 1024자 | 타임 오프셋 토큰 |




**JSON**
```json
{
    "action": "Gs2Dictionary:VerifyEntryByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "userId": "[string]사용자ID",
        "entryModelName": "[string]엔트리 모델 이름",
        "verifyType": "[string]검증 종류",
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}
```

**YAML**
```yaml

action: Gs2Dictionary:VerifyEntryByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  userId: "[string]사용자ID"
  entryModelName: "[string]엔트리 모델 이름"
  verifyType: "[string]검증 종류"
  timeOffsetToken: "[string]타임 오프셋 토큰"
```

**GS2-Script**
```lua

transaction.service("dictionary").verify.verify_entry_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    userId="[string]사용자ID",
    entryModelName="[string]엔트리 모델 이름",
    verifyType="[string]검증 종류",
    timeOffsetToken="[string]타임 오프셋 토큰",
})
```


---

## Consume Action

소비 액션

### Gs2Dictionary:DeleteEntriesByUserId

사용자 ID를 지정하여 엔트리 삭제<br>

엔트리 모델 이름의 목록을 지정하여, 지정한 사용자의 도감에서 특정 엔트리를 삭제합니다.<br>
일괄 작업으로 여러 엔트리를 한 번에 삭제할 수 있습니다.<br>
반환되는 목록에는 실제로 삭제된 엔트리가 포함됩니다.

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

**반전 가능한 액션: 예**

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128자 | 네임스페이스 이름<br>네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| userId | string |  | ✓|  |  ~ 128자 | 사용자ID<br>`#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다. |
| entryModelNames | List&lt;string&gt; |  | | [] | 0 ~ 100 items | 엔트리 모델 이름 목록 |
| timeOffsetToken | string |  | |  |  ~ 1024자 | 타임 오프셋 토큰 |




**JSON**
```json
{
    "action": "Gs2Dictionary:DeleteEntriesByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "userId": "[string]사용자ID",
        "entryModelNames": [
            "[string]엔트리 모델 이름"
        ],
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}
```

**YAML**
```yaml

action: Gs2Dictionary:DeleteEntriesByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  userId: "[string]사용자ID"
  entryModelNames: 
    - "[string]엔트리 모델 이름"
  timeOffsetToken: "[string]타임 오프셋 토큰"
```

**GS2-Script**
```lua

transaction.service("dictionary").consume.delete_entries_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    userId="[string]사용자ID",
    entryModelNames={
        "[string]엔트리 모델 이름"
    },
    timeOffsetToken="[string]타임 오프셋 토큰",
})
```


---

## Acquire Action

입수 액션

### Gs2Dictionary:AddEntriesByUserId

사용자 ID를 지정하여 엔트리 등록<br>

지정한 사용자의 도감에 하나 이상의 엔트리를 등록합니다.<br>
일괄 작업으로 여러 엔트리 모델 이름을 한 번에 지정할 수 있습니다.<br>
이미 등록된 엔트리는 오류 없이 건너뜁니다.<br>
반환되는 목록에는 새로 추가된 엔트리만 포함됩니다.

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

**반전 가능한 액션: 예**

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| namespaceName | string |  | ✓|  |  ~ 128자 | 네임스페이스 이름<br>네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| userId | string |  | ✓|  |  ~ 128자 | 사용자ID<br>`#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다. |
| entryModelNames | List&lt;string&gt; |  | | [] | 0 ~ 100 items | 엔트리 모델 이름 목록 |
| timeOffsetToken | string |  | |  |  ~ 1024자 | 타임 오프셋 토큰 |




**JSON**
```json
{
    "action": "Gs2Dictionary:AddEntriesByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "userId": "[string]사용자ID",
        "entryModelNames": [
            "[string]엔트리 모델 이름"
        ],
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}
```

**YAML**
```yaml

action: Gs2Dictionary:AddEntriesByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  userId: "[string]사용자ID"
  entryModelNames: 
    - "[string]엔트리 모델 이름"
  timeOffsetToken: "[string]타임 오프셋 토큰"
```

**GS2-Script**
```lua

transaction.service("dictionary").acquire.add_entries_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    userId="[string]사용자ID",
    entryModelNames={
        "[string]엔트리 모델 이름"
    },
    timeOffsetToken="[string]타임 오프셋 토큰",
})
```


---