Method: recall.linkPersona

Liên kết với một tài khoản trong trò chơi để liên kết với người chơi gốc PGS được mã hoá theo mã phiên hoạt động gọi lại được cung cấp

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.
}
Trường
sessionId

string

Bắt buộc. Chuỗi mờ do máy chủ tạo, mã hoá tất cả thông tin cần thiết để xác định người chơi 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 cá tính 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 vòng khoá).
cardinalityConstraint

enum (RecallTokensCardinalityConstraint)

Bắt buộc. Ràng buộc về số lượng giá trị riêng biệt cần theo dõi khi liên kết một persona với một người chơi trong phạm vi một trò chơi.
Trường kết hợp expiration. Thời gian hết hạn mã thông báo (không bắt buộc) hoặc thời gian tồn tại. 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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 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 phát trực tiếp (không bắt buộc).

Thời lượng tính bằng giây với 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 hành vi 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)
}
Trường
state

enum (State)

Chỉ có đầu ra. Trạng thái của một hành độ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 bài viết Tổng quan về OAuth 2.0.

RecallTokensCardinalityConstraint

Ràng buộc về số lượng giá trị riêng biệt cần theo dõi khi liên kết một persona với một người chơi trong phạm vi một trò chơi.

Enum
ONE_PERSONA_TO_ONE_PLAYER

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

Vào cuối thao tác liên kết, chỉ một mục nhập cho người chơi và persona sẽ vẫn nằm trong phạm vi ứng dụng.

Việc đườ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 sẽ do ConflictingLinksResolutionPolicy đã chọn xác định:

  • Nếu bạn chỉ định KEEP_EXISTING_LINKS và persona bạn cung cấp đã được liên kết với một người chơi khác hoặc người chơi đã 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) đường liên kết hiện có sẽ không thay đổi.

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

ConflictingLinksResolutionPolicy

Chính sách giải quyết vấn đề được áp dụng khi việc liên kết mộ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 một hành độ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 chưa được tạo vì các đường liên kết hiện có sẽ khiến đường liên kết mới vi phạm RecallTokensCardinalityConstraint được chỉ định nếu được tạo.