GS2-Dictionary 트랜잭션 액션

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

Verify Action

검증 액션

Gs2Dictionary:VerifyEntryByUserId

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

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

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

타입 활성화 조건 필수 기본값 값 제한 설명

namespaceName

string

✓

~ 128자

네임스페이스 이름

네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.

userId

string

✓

~ 128자

사용자ID
#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다.

entryModelName

string

✓

~ 128자

엔트리 모델 이름

엔트리 모델 고유 이름입니다. 영숫자 및 -(하이픈), _(언더스코어), .(마침표)로 지정합니다.

verifyType

문자열 열거형
enum {
“havent”,
“have”
}

✓

검증 종류

정의	설명
havent	지정한 엔트리를 보유하고 있지 않을 것
have	지정한 엔트리를 보유하고 있을 것

timeOffsetToken string ~ 1024자 타임 오프셋 토큰

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

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

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를 지정하여 엔트리 삭제

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

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

반전 가능한 액션: 예

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

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

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

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

Acquire Action

입수 액션

Gs2Dictionary:AddEntriesByUserId

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

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

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

반전 가능한 액션: 예

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

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

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

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