Method: recall.linkPersona

Liên kết tên chính của Người chơi PGS được mã hoá trong mã phiên gọi lại được cung cấp với một tài khoản trong trò chơi

Yêu cầu HTTP

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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.
}
Các trường
sessionId

string

Bắt buộc. Chuỗi mờ do máy chủ tạo, giúp mã hoá tất cả thông tin cần thiết để xác định trình phát PGS / người dùng Google và ứng dụng.
persona

string

Bắt buộc. Giá trị nhận dạng ổn định của tài khoản trong trò chơi. Vui lòng không sử dụng lại cùng một persona cho các trò chơi khác nhau.
token

string

Bắt buộc. Giá trị của mã thông báo cần tạo. Mờ đối với Play Games và được giả định là không ổn định (được mã hoá bằng tính năng xoay khoá).
cardinalityConstraint

enum (RecallTokensCardinalityConstraint)

Bắt buộc. Giới hạn về số lượng giá trị riêng biệt cần quan sát khi liên kết persona với người chơi trong phạm vi trò chơi.
Trường nhóm expiration. Thời gian tồn tại hoặc thời gian hết hạn của mã thông báo (không bắt buộc). expiration chỉ có thể là một trong những trạng thái sau đây:
expireTime

string (Timestamp format)

Chỉ nhập. Thời gian hết hạn (không bắt buộc).

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Chỉ nhập. Thời gian tồn tại không bắt buộc.

Thời lượng tính bằng giây có tối đa 9 chữ số phân số, kết thúc bằng 's'. Ví dụ: "3.5s".

Nội dung phản hồi

Kết quả của một lần liên kết persona.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "state": enum (State)
}
Các trường
state

enum (State)

Chỉ có đầu ra. Trạng thái của hoạt động liên kết persona.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

RecallTokensCardinalityConstraint

Giới hạn về số lượng giá trị riêng biệt cần quan sát khi liên kết persona với người chơi trong phạm vi trò chơi.

Enum
ONE_PERSONA_TO_ONE_PLAYER

Số lượng giá trị riêng biệt 1:1 giữa chân dung độc giả trong trò chơi và người chơi sử dụng Dịch vụ trò chơi của Play.

Khi kết thúc hoạt động liên kết, chỉ một mục nhập cho người chơi và persona vẫn nằm trong phạm vi của ứng dụng.

Việc một đường liên kết mới có được tạo hay không khi quy tắc ràng buộc này được chỉ định là do ConflictingLinksResolutionPolicy đã chọn xác định:

  • Nếu bạn chỉ định KEEP_EXISTING_LINKS và persona được cung cấp đã được liên kết với một người chơi khác hoặc người chơi đã được liên kết với một persona khác, thì sẽ không có mối liên kết mới nào được tạo và (các) mối liên kết hiện có sẽ giữ nguyên.

  • Nếu bạn chỉ định CREATE_NEW_LINK và persona được cung cấp đã được liên kết với một người chơi khác hoặc người chơi đó đã được liên kết với một persona khác, thì(các) đường liên kết cũ sẽ bị xoá và thay bằng mối liên kết mới đang được tạo.

ConflictingLinksResolutionPolicy

Áp dụng chính sách về cách giải quyết khi việc liên kết persona với một người chơi sẽ dẫn đến việc vi phạm quy tắc ràng buộc về số lượng giá trị riêng biệt đã chỉ định.

Enum

Tiểu bang

Trạng thái của hoạt động liên kết persona.

Enum
PERSONA_OR_PLAYER_ALREADY_LINKED Đường liên kết được chỉ định trong yêu cầu không được tạo vì các đường liên kết đã tồn tại sẽ khiến đường liên kết mới vi phạm RecallTokensCardinalityConstraint đã chỉ định nếu được tạo.