Method: recall.linkPersona

제공된 리콜 세션 ID로 인코딩된 PGS 플레이어 주 구성원을 인게임 계정과 연결합니다.

HTTP 요청

POST https://games.googleapis.com/games/v1/recall:linkPersona

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "sessionId": string,
  "persona": string,
  "token": string,
  "cardinalityConstraint": enum (RecallTokensCardinalityConstraint),
  "conflictingLinksResolutionPolicy": enum (ConflictingLinksResolutionPolicy),

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
필드
sessionId

string

필수 항목입니다. PGS 플레이어 / Google 사용자 및 애플리케이션을 식별하는 데 필요한 모든 정보를 인코딩하는 불투명한 서버 생성 문자열입니다.

persona

string

필수 항목입니다. 인게임 계정의 안정적인 식별자입니다. 다른 게임에 동일한 캐릭터를 재사용하지 마세요.

token

string

필수 항목입니다. 생성할 토큰의 값입니다. Play 게임즈에서 불투명하며 불안정한 것으로 간주됩니다 (키 순환으로 암호화됨).

cardinalityConstraint

enum (RecallTokensCardinalityConstraint)

필수 항목입니다. 페르소나를 게임 범위 내의 플레이어에 연결할 때 관찰해야 하는 카디널리티 제약 조건입니다.

통합 필드 expiration. 토큰 만료 시간 또는 수명(선택사항)입니다. expiration은 다음 중 하나여야 합니다.
expireTime

string (Timestamp format)

입력 전용. 만료 시간입니다(선택사항).

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

ttl

string (Duration format)

입력 전용. 선택적 TTL(수명)입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

응답 본문

캐릭터 연결 시도 결과

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "state": enum (State)
}
필드
state

enum (State)

출력 전용. 캐릭터 연결 시도 상태입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/androidpublisher

자세한 내용은 OAuth 2.0 개요를 참고하세요.

RecallTokensCardinalityConstraint

페르소나를 게임 범위 내의 플레이어에 연결할 때 관찰해야 하는 카디널리티 제약 조건입니다.

열거형
ONE_PERSONA_TO_ONE_PLAYER

게임 내 캐릭터와 Play 게임즈 서비스 플레이어 간의 1:1 카디널리티

연결 작업이 끝날 무렵에는 플레이어와 캐릭터에 대해 하나의 항목만 애플리케이션 범위에 남아 있어야 합니다.

이 제약 조건이 지정될 때 새 링크를 생성할지 여부는 선택한 ConflictingLinksResolutionPolicy에 따라 결정됩니다.

  • KEEP_EXISTING_LINKS이 지정되고 제공된 캐릭터가 이미 다른 플레이어에 연결되어 있거나 플레이어가 이미 다른 캐릭터에 연결되어 있는 경우 새 링크가 생성되지 않으며 이미 존재하는 링크는 그대로 유지됩니다.

  • CREATE_NEW_LINK이 지정되고 제공된 캐릭터가 이미 다른 플레이어에 연결되어 있거나 플레이어가 이미 다른 캐릭터에 연결되어 있는 경우 이전 링크가 삭제되고 새 링크가 생성됩니다.

충돌하는 링크 해결 정책

캐릭터를 플레이어에 연결할 때 지정된 카디널리티 제약조건을 위반하는 경우 적용할 해결 정책입니다.

열거형

상태

캐릭터 연결 시도 상태입니다.

열거형
PERSONA_OR_PLAYER_ALREADY_LINKED 이미 존재하는 링크를 만들면 지정된 RecallTokensCardinalityConstraint을(를) 위반하는 새 링크가 생성될 수 있으므로 요청에 지정된 링크가 생성되지 않았습니다.