GS2-Account 스크립트 트리거 레퍼런스

확장 스크립트를 호출하는 이벤트 트리거의 레퍼런스

트리거

createAccount

계정 신규 작성

동기 실행 스크립트

계정 신규 작성 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
Result
타입필수기본값값 제한설명
permitbool
✓
계정 생성을 허용할지 여부
구현 예제
-- Request
local namespace = args.namespace
local account = args.account

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

계정 신규 작성 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
구현 예제
-- Request
local namespace = args.namespace
local account = args.account

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

authentication

계정 인증

동기 실행 스크립트

계정 인증 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
elapsedHoursint마지막 로그인으로부터 경과 시간
Result
타입필수기본값값 제한설명
permitbool
✓
계정 인증을 허용할지 여부
forceboolfalse비밀번호 인증에 실패해도 인증을 통과시킬지 여부
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local elapsedHours = args.elapsedHours

-- Business logic:
local permit = true
local force = false

-- Result
result = {
  permit=permit,
  force=force
}

비동기 실행 스크립트

계정 인증 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
elapsedHoursint마지막 로그인으로부터 경과 시간
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local elapsedHours = args.elapsedHours

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

ban

계정 BAN 등록

동기 실행 스크립트

계정 BAN 등록 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
addBanStatusBanStatus추가할 계정 BAN 상태
Result
타입필수기본값값 제한설명
permitbool
✓
계정 BAN 등록을 허용할지 여부
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local addBanStatus = args.addBanStatus

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

계정 BAN 등록 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
addBanStatusBanStatus추가할 계정 BAN 상태
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local addBanStatus = args.addBanStatus

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

unBan

계정 BAN 해제

동기 실행 스크립트

계정 BAN 해제 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
Result
타입필수기본값값 제한설명
permitbool
✓
계정 BAN 해제를 허용할지 여부
구현 예제
-- Request
local namespace = args.namespace
local account = args.account

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

계정 BAN 해제 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
구현 예제
-- Request
local namespace = args.namespace
local account = args.account

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

requestDeletion

계정 삭제 신청

동기 실행 스크립트

계정 삭제 신청 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
scheduledAtlong삭제 예정 일시
Result
타입필수기본값값 제한설명
permitbool
✓
계정 삭제 신청을 허용할지 여부
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local scheduledAt = args.scheduledAt

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

계정 삭제 신청 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
scheduledAtlong삭제 예정 일시
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local scheduledAt = args.scheduledAt

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

cancelDeletion

계정 삭제 신청 취소

동기 실행 스크립트

계정 삭제 신청 취소 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
reasonenum [
“user”,
“login”,
“admin”
]
취소 사유
“게임 플레이어에 의한 취소(user)“는 게임 플레이어에 의한 취소입니다.
“유예 기간 중 로그인에 의한 취소(login)“는 유예 기간 중에 로그인했을 때의 동작이 “삭제를 취소하고 로그인함(cancel)“일 때, 삭제 예정인 동안 인증한 것에 의한 취소입니다.
“관리자에 의한 취소(admin)“는 사용자ID를 지정한 취소입니다.
Result
타입필수기본값값 제한설명
permitbool
✓
계정 삭제 신청 취소를 허용할지 여부
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local reason = args.reason

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

계정 삭제 신청 취소 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
reasonenum [
“user”,
“login”,
“admin”
]
취소 사유
“게임 플레이어에 의한 취소(user)“는 게임 플레이어에 의한 취소입니다.
“유예 기간 중 로그인에 의한 취소(login)“는 유예 기간 중에 로그인했을 때의 동작이 “삭제를 취소하고 로그인함(cancel)“일 때, 삭제 예정인 동안 인증한 것에 의한 취소입니다.
“관리자에 의한 취소(admin)“는 사용자ID를 지정한 취소입니다.
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local reason = args.reason

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

executeDeletion

계정 삭제

동기 실행 스크립트

계정 삭제 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
dataUserIdstring데이터 보유용 사용자ID
삭제할 사용자 데이터를 보유하고 있는 사용자ID입니다.
네임스페이스에서 로그인용 사용자ID와 데이터 보유용 사용자ID를 분리한 경우에는 데이터 오너의 사용자ID, 그 외의 경우에는 계정의 사용자ID와 같은 값이 됩니다.
Result
타입필수기본값값 제한설명
permitbool
✓
사용하지 않습니다
계정 삭제는 스크립트로 막을 수 없으므로 이 값은 무시됩니다.
스크립트가 실패하면 삭제를 미루고 나중에 재시도하므로, 같은 계정에 대해 스크립트가 여러 번 실행될 수 있습니다. 스크립트는 멱등하게 작성해 주세요.
삭제가 13번 실패하면 이후에는 스크립트를 실행하지 않고 삭제를 진행합니다.
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local dataUserId = args.dataUserId

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

계정 삭제 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
dataUserIdstring데이터 보유용 사용자ID
삭제할 사용자 데이터를 보유하고 있는 사용자ID입니다.
네임스페이스에서 로그인용 사용자ID와 데이터 보유용 사용자ID를 분리한 경우에는 데이터 오너의 사용자ID, 그 외의 경우에는 계정의 사용자ID와 같은 값이 됩니다.
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local dataUserId = args.dataUserId

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

createTakeOver

인계 정보 등록

동기 실행 스크립트

인계 정보 등록 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
takeOverTakeOver인계 정보
accountAccount게임 플레이어 계정
Result
타입필수기본값값 제한설명
permitbool
✓
인계 정보 등록을 허용할지 여부
구현 예제
-- Request
local namespace = args.namespace
local takeOver = args.takeOver
local account = args.account

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

인계 정보 등록 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
takeOverTakeOver인계 정보
accountAccount게임 플레이어 계정
구현 예제
-- Request
local namespace = args.namespace
local takeOver = args.takeOver
local account = args.account

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

doTakeOver

인계 실행

동기 실행 스크립트

인계 실행 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
takeOverTakeOver인계 정보
Result
타입필수기본값값 제한설명
permitbool
✓
인계 실행을 허용할지 여부
forceboolfalse비밀번호 인증에 실패해도 인증을 통과시킬지 여부
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local takeOver = args.takeOver

-- Business logic:
local permit = true
local force = false

-- Result
result = {
  permit=permit,
  force=force
}

비동기 실행 스크립트

인계 실행 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
accountAccount게임 플레이어 계정
takeOverTakeOver인계 정보
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local takeOver = args.takeOver

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}