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입니다. 선택적 토큰 만료 시간 또는 TTL(수명)입니다. expiration은 다음 중 하나여야 합니다.
expireTime

string (Timestamp format)

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

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

string (Duration format)

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

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

응답 본문

캐릭터 연결 시도 결과입니다.

성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.

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

enum (State)

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

승인 범위

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

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

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

RecallTokensCardinalityConstraint

게임 범위 내에서 캐릭터를 플레이어에 연결할 때 준수해야 하는 카디널리티 제약 조건입니다.

Enum
ONE_PERSONA_TO_ONE_PLAYER

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

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

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

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

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

ConflictingLinksResolutionPolicy

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

Enum

상태

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

Enum
PERSONA_OR_PLAYER_ALREADY_LINKED 요청에 지정된 링크가 생성되지 않았습니다. 이미 존재하는 링크가 생성되면 새 링크가 지정된 RecallTokensCardinalityConstraint를 위반하게 되기 때문입니다.