GS2-Account 스크립트 트리거 레퍼런스
확장 스크립트를 호출하는 이벤트 트리거의 레퍼런스
트리거
createAccount
계정 신규 작성
동기 실행 스크립트
계정 신규 작성 처리 전에, 스크립트가 동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
Result
| 타입 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|
| permit | bool | ✓ | 계정 생성을 허용할지 여부 |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
-- Business logic:
local permit = true
-- Result
result = {
permit=permit
}비동기 실행 스크립트
계정 신규 작성 처리 후에, 스크립트가 비동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.
result = {
}authentication
계정 인증
동기 실행 스크립트
계정 인증 처리 전에, 스크립트가 동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| elapsedHours | int | 마지막 로그인으로부터 경과 시간 |
Result
| 타입 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|
| permit | bool | ✓ | 계정 인증을 허용할지 여부 | ||
| force | bool | false | 비밀번호 인증에 실패해도 인증을 통과시킬지 여부 |
구현 예제
-- 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
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| elapsedHours | int | 마지막 로그인으로부터 경과 시간 |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local elapsedHours = args.elapsedHours
-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.
result = {
}ban
계정 BAN 등록
동기 실행 스크립트
계정 BAN 등록 처리 전에, 스크립트가 동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| addBanStatus | BanStatus | 추가할 계정 BAN 상태 |
Result
| 타입 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|
| permit | bool | ✓ | 계정 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
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| addBanStatus | BanStatus | 추가할 계정 BAN 상태 |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local addBanStatus = args.addBanStatus
-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.
result = {
}unBan
계정 BAN 해제
동기 실행 스크립트
계정 BAN 해제 처리 전에, 스크립트가 동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
Result
| 타입 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|
| permit | bool | ✓ | 계정 BAN 해제를 허용할지 여부 |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
-- Business logic:
local permit = true
-- Result
result = {
permit=permit
}비동기 실행 스크립트
계정 BAN 해제 처리 후에, 스크립트가 비동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.
result = {
}requestDeletion
계정 삭제 신청
동기 실행 스크립트
계정 삭제 신청 처리 전에, 스크립트가 동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| scheduledAt | long | 삭제 예정 일시 |
Result
| 타입 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|
| permit | bool | ✓ | 계정 삭제 신청을 허용할지 여부 |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local scheduledAt = args.scheduledAt
-- Business logic:
local permit = true
-- Result
result = {
permit=permit
}비동기 실행 스크립트
계정 삭제 신청 처리 후에, 스크립트가 비동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| scheduledAt | long | 삭제 예정 일시 |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local scheduledAt = args.scheduledAt
-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.
result = {
}cancelDeletion
계정 삭제 신청 취소
동기 실행 스크립트
계정 삭제 신청 취소 처리 전에, 스크립트가 동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| reason | enum [ “user”, “login”, “admin” ] | 취소 사유 “게임 플레이어에 의한 취소(user)“는 게임 플레이어에 의한 취소입니다. “유예 기간 중 로그인에 의한 취소(login)“는 유예 기간 중에 로그인했을 때의 동작이 “삭제를 취소하고 로그인함(cancel)“일 때, 삭제 예정인 동안 인증한 것에 의한 취소입니다. “관리자에 의한 취소(admin)“는 사용자ID를 지정한 취소입니다. |
Result
| 타입 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|
| permit | bool | ✓ | 계정 삭제 신청 취소를 허용할지 여부 |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local reason = args.reason
-- Business logic:
local permit = true
-- Result
result = {
permit=permit
}비동기 실행 스크립트
계정 삭제 신청 취소 처리 후에, 스크립트가 비동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| reason | enum [ “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
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| dataUserId | string | 데이터 보유용 사용자ID 삭제할 사용자 데이터를 보유하고 있는 사용자ID입니다. 네임스페이스에서 로그인용 사용자ID와 데이터 보유용 사용자ID를 분리한 경우에는 데이터 오너의 사용자ID, 그 외의 경우에는 계정의 사용자ID와 같은 값이 됩니다. |
Result
| 타입 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|
| permit | bool | ✓ | 사용하지 않습니다 계정 삭제는 스크립트로 막을 수 없으므로 이 값은 무시됩니다. 스크립트가 실패하면 삭제를 미루고 나중에 재시도하므로, 같은 계정에 대해 스크립트가 여러 번 실행될 수 있습니다. 스크립트는 멱등하게 작성해 주세요. 삭제가 13번 실패하면 이후에는 스크립트를 실행하지 않고 삭제를 진행합니다. |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local dataUserId = args.dataUserId
-- Business logic:
local permit = true
-- Result
result = {
permit=permit
}비동기 실행 스크립트
계정 삭제 처리 후에, 스크립트가 비동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| dataUserId | string | 데이터 보유용 사용자ID 삭제할 사용자 데이터를 보유하고 있는 사용자ID입니다. 네임스페이스에서 로그인용 사용자ID와 데이터 보유용 사용자ID를 분리한 경우에는 데이터 오너의 사용자ID, 그 외의 경우에는 계정의 사용자ID와 같은 값이 됩니다. |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local dataUserId = args.dataUserId
-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.
result = {
}createTakeOver
인계 정보 등록
동기 실행 스크립트
인계 정보 등록 처리 전에, 스크립트가 동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| takeOver | TakeOver | 인계 정보 |
| account | Account | 게임 플레이어 계정 |
Result
| 타입 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|
| permit | bool | ✓ | 인계 정보 등록을 허용할지 여부 |
구현 예제
-- Request
local namespace = args.namespace
local takeOver = args.takeOver
local account = args.account
-- Business logic:
local permit = true
-- Result
result = {
permit=permit
}비동기 실행 스크립트
인계 정보 등록 처리 후에, 스크립트가 비동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| takeOver | TakeOver | 인계 정보 |
| account | Account | 게임 플레이어 계정 |
구현 예제
-- Request
local namespace = args.namespace
local takeOver = args.takeOver
local account = args.account
-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.
result = {
}doTakeOver
인계 실행
동기 실행 스크립트
인계 실행 처리 전에, 스크립트가 동기 실행됩니다.
Request
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| takeOver | TakeOver | 인계 정보 |
Result
| 타입 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|
| permit | bool | ✓ | 인계 실행을 허용할지 여부 | ||
| force | bool | false | 비밀번호 인증에 실패해도 인증을 통과시킬지 여부 |
구현 예제
-- 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
| 타입 | 설명 | |
|---|---|---|
| namespace | Namespace | 네임스페이스 |
| account | Account | 게임 플레이어 계정 |
| takeOver | TakeOver | 인계 정보 |
구현 예제
-- Request
local namespace = args.namespace
local account = args.account
local takeOver = args.takeOver
-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.
result = {
}