GS2-AdReward 트랜잭션 액션

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

Consume Action

소비 액션

Gs2AdReward:ConsumePointByUserId

사용자 ID를 지정하여 포인트 소비

지정된 사용자 ID로부터 지정된 수의 포인트를 차감하고, 갱신된 포인트 정보를 반환합니다.
요청된 소비량에 대해 포인트가 부족한 경우 오류가 반환됩니다.
네임스페이스의 소비 스크립트 설정에 GS2-Script가 설정되어 있는 경우, 포인트 차감 전에 스크립트가 실행되어 커스텀 검증이나 소비량 변경이 가능합니다.
포인트 차감 후, 네임스페이스 설정에서 변경 알림이 구성되어 있으면 알림이 전송됩니다.

수량 지정 가능한 액션: 예

반전 가능한 액션: 예

	타입	필수	값 제한	설명
namespaceName	string	✓	~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
userId	string	✓	~ 128자	사용자ID `#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다.
point	long	✓	1 ~ 9223372036854775805	소비할 포인트
timeOffsetToken	string		~ 1024자	타임 오프셋 토큰

{
    "action": "Gs2AdReward:ConsumePointByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "userId": "[string]사용자ID",
        "point": "[long]소비할 포인트",
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}

action: Gs2AdReward:ConsumePointByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  userId: "[string]사용자ID"
  point: "[long]소비할 포인트"
  timeOffsetToken: "[string]타임 오프셋 토큰"

transaction.service("adReward").consume.consume_point_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    userId="[string]사용자ID",
    point="[long]소비할 포인트",
    timeOffsetToken="[string]타임 오프셋 토큰",
})

Acquire Action

입수 액션

Gs2AdReward:AcquirePointByUserId

사용자 ID를 지정하여 포인트 획득

지정된 사용자 ID에 지정된 수의 포인트를 추가하고, 갱신된 포인트 정보를 반환합니다.
사용자의 포인트 레코드가 존재하지 않는 경우, 포인트 추가 전에 새로운 레코드가 자동으로 생성됩니다.
네임스페이스의 획득 스크립트 설정에 GS2-Script가 설정되어 있는 경우, 포인트 추가 전에 스크립트가 실행되어 커스텀 검증이나 획득량 변경이 가능합니다.
포인트 추가 후, 네임스페이스 설정에서 변경 알림이 구성되어 있으면 알림이 전송됩니다.

수량 지정 가능한 액션: 예

반전 가능한 액션: 예

	타입	필수	값 제한	설명
namespaceName	string	✓	~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
userId	string	✓	~ 128자	사용자ID `#{userId}`로 설정하면 로그인 중인 사용자ID로 치환됩니다.
point	long	✓	1 ~ 9223372036854775805	획득할 포인트
timeOffsetToken	string		~ 1024자	타임 오프셋 토큰

{
    "action": "Gs2AdReward:AcquirePointByUserId",
    "request": {
        "namespaceName": "[string]네임스페이스 이름",
        "userId": "[string]사용자ID",
        "point": "[long]획득할 포인트",
        "timeOffsetToken": "[string]타임 오프셋 토큰"
    }
}

action: Gs2AdReward:AcquirePointByUserId
request:
  namespaceName: "[string]네임스페이스 이름"
  userId: "[string]사용자ID"
  point: "[long]획득할 포인트"
  timeOffsetToken: "[string]타임 오프셋 토큰"

transaction.service("adReward").acquire.acquire_point_by_user_id({
    namespaceName="[string]네임스페이스 이름",
    userId="[string]사용자ID",
    point="[long]획득할 포인트",
    timeOffsetToken="[string]타임 오프셋 토큰",
})